gif-search

Search and download GIFs from the Tenor API using curl and jq.

Updated Jun 7, 2026
One-click install
npx skills add https://github.com/Chensihakniroth/ANAKOT-AGENT --skill gif-search-chensihakniroth
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gif-search
Source: https://github.com/Chensihakniroth/ANAKOT-AGENT/tree/main/skills/media/gif-search
Command: npx skills add https://github.com/Chensihakniroth/ANAKOT-AGENT --skill gif-search-chensihakniroth

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Finding and downloading GIFs for chat reactions or visual content normally requires manual browsing; this Skill retrieves GIF URLs and files directly from the Tenor API via the command line. ## Core Features & Use Cases - GIF Search: Query the Tenor API with keywords and retrieve GIF URLs in multiple formats (gif, tinygif, mp4, webm). - Direct Download: Fetch the top search result and save it as a local GIF file with curl. - Metadata Retrieval: Extract titles, preview URLs, and dimensions for search results using jq. - Use Case: When chatting on Discord or Slack, quickly search for a "celebration" GIF, grab the lightweight tinygif URL, and embed it directly in a markdown message. ## Quick Start Set the TENOR_API_KEY environment variable, then ask the agent to search Tenor for a reaction GIF and return the top result URL.

Frequently Asked Questions about gif-search

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search for GIFs using the Tenor API?▼

Send a GET request to https://tenor.googleapis.com/v2/search with your query, limit, and API key, then parse the JSON response with jq to extract URLs from .results[].media_formats.gif.url. URL-encode spaces in the query as +.

How to download a GIF from the command line with curl?▼

First query the Tenor search endpoint and extract the top result's gif URL with jq, then run curl -sL on that URL with -o to save the file locally, for example celebration.gif.

What is the difference between gif and tinygif formats in Tenor?▼

The gif format is the full-quality GIF, while tinygif is a smaller preview version with reduced file size. For sending in chat, tinygif URLs are lighter weight and load faster.

Do I need an API key to use Tenor GIF search?▼

Yes, a TENOR_API_KEY environment variable is required. You can get a free key from the Google Cloud Console Tenor API quickstart, which has generous rate limits.

Why does my Tenor API search return no results?▼

Common causes include an invalid or missing API key, unencoded special characters in the query, or an overly restrictive contentfilter setting. Verify the key is exported and URL-encode the query string.