skills.rest
MLT-OSS
MLT-OSSOFFICIAL
Explore all skills by this author →
WebsiteGitHub

gif-search

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

14|5|Updated Apr 9, 2026
Search Tags:#api#search#media#gif#download#curl#tenor
One-click install
npx skills add https://github.com/MLT-OSS/hermes-agent-go --skill gif-search-mlt-oss
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gif-search
Source: https://github.com/MLT-OSS/hermes-agent-go/tree/main/skills/media/gif-search
Command: npx skills add https://github.com/MLT-OSS/hermes-agent-go --skill gif-search-mlt-oss

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Finding and downloading GIFs for chat messages, reactions, or visual content normally requires manual browsing on GIF websites. This Skill lets you search the Tenor API and retrieve GIF URLs or files directly from 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 a single curl pipeline. - Metadata Retrieval: Extract titles, preview URLs, and dimensions for search results using jq. - Use Case: While chatting on a messaging platform, ask the agent to find a 'celebration' GIF and send the lightweight tinygif URL directly in the conversation. ## 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 parameters q (query), limit, and key. Pipe the JSON response through jq to extract GIF URLs from the .results[].media_formats.gif.url field.

How do I get a Tenor API key for GIF search?▼

Register for a free API key through the Google Cloud Console by enabling the Tenor API, following the quickstart guide at developers.google.com/tenor. Set it as the TENOR_API_KEY environment variable before running searches.

What GIF formats does the Tenor API return?▼

Each result includes multiple media formats: gif for full quality, tinygif for small previews, mp4 and tinymp4 for video versions, webm, and nanogif for tiny thumbnails. Use tinygif URLs for lightweight chat embedding.

Why does my Tenor API search return no results?▼

Check that your TENOR_API_KEY is set correctly and the query is URL-encoded with spaces as plus signs. Also verify the contentfilter parameter is not set too restrictively, and that your API key has not exceeded rate limits.

Can I use Tenor GIF URLs directly in chat messages?▼

Yes, GIF URLs from the Tenor API can be embedded directly in markdown using standard image syntax. The tinygif format is recommended for chat since it has a smaller file size and loads faster.

Related Skills

Explore More Content & Communication Skills→
1thirteeng31thirteeng3

gif-search

Search Tenor GIFs by keyword and fetch the top result with curl and jq.

Community
Basic
winsorllcwinsorllc

agent-send

Send messages to AI agents across Discord, Telegram, Slack, and email.

Community
Intermediate
JamesFincherJamesFincher

gif-search

Search Tenor for GIFs and return media URLs via curl and jq.

Community
Basic
ComposioHQComposioHQ
223

GIF Search CLI (gifgrep)

Search, download, and extract frames from GIFs via CLI using Giphy and Tenor APIs.

Official
Intermediate