gif-search

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

Updated Sep 9, 2026
One-click install
npx skills add https://github.com/luckybbjason1/trading --skill gif-search-luckybbjason1
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gif-search
Source: https://github.com/luckybbjason1/trading/tree/main/.hermes/skills/media/gif-search
Command: npx skills add https://github.com/luckybbjason1/trading --skill gif-search-luckybbjason1

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Finding and downloading GIFs for chat messages, reaction content, or visual assets 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 curl. - Metadata Retrieval: Extract titles, preview URLs, and dimensions for search results using jq. - Use Case: You want to send a celebration GIF in a chat message. Run a single search command, grab the tinygif URL, and embed it directly in markdown. ## Quick Start Search Tenor for a thumbs up GIF and give me the URL of the top result.

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 in the q parameter and your API key in the key parameter. Pipe the JSON response through jq to extract GIF URLs from the media_formats field.

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

First query the Tenor search endpoint and extract the GIF URL with jq, then run curl -sL with the URL and an -o output filename. This saves the top search result directly as a local .gif file.

Where do I get a Tenor API key?

Get a free Tenor API key from the Google Cloud Console by following the Tenor quickstart guide at developers.google.com/tenor. The free key has generous rate limits and is set via the TENOR_API_KEY environment variable.

What media formats does the Tenor API return?

Each result includes gif, tinygif, mp4, tinymp4, webm, and nanogif formats under media_formats. Use tinygif for lightweight chat previews and gif for full quality, or mp4 for smaller file sizes.

Why does my Tenor GIF search return no results?

Check that TENOR_API_KEY is set correctly and that your query is URL-encoded with spaces as plus signs. Also verify the contentfilter parameter is not set too restrictively for your search terms.