skills.rest
moistalgia
moistalgiaCOMMUNITY
Explore all skills by this author →
GitHub

gif-search

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

Updated Jul 27, 2026
Search Tags:#api#search#gif#download#jq#curl#tenor
One-click install
npx skills add https://github.com/moistalgia/hermes-tools --skill gif-search-moistalgia
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gif-search
Source: https://github.com/moistalgia/hermes-tools/tree/main/skills-from-hermes/media/gif-search
Command: npx skills add https://github.com/moistalgia/hermes-tools --skill gif-search-moistalgia

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 with simple shell commands. ## Core Features & Use Cases - GIF Search: Query the Tenor API v2 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 in one pipeline. - Metadata Extraction: Pull titles, preview URLs, and dimensions for each result using jq. - Use Case: You want to send a reaction GIF in chat — search for "thumbs up", grab the lightweight tinygif URL, and embed it directly in markdown. ## Quick Start Set the TENOR_API_KEY environment variable, then ask the agent to search Tenor for a celebration GIF and download 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 parameters q (query), limit, and key. Pipe the JSON response through jq to extract GIF URLs from .results[].media_formats.gif.url.

How to download a GIF from Tenor with curl?▼

First query the 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. The Skill shows a one-liner combining both steps.

What API key do I need for Tenor GIF search?▼

You need a free Tenor API key from Google Cloud Console, set as the TENOR_API_KEY environment variable. The key has generous rate limits and is passed as the key parameter in each request.

What GIF formats does the Tenor API return?▼

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

Why does my Tenor API search return no results?▼

Check that your query is URL-encoded (spaces as +, special characters as %XX) and that TENOR_API_KEY is set correctly. Also verify the contentfilter parameter is not set too restrictively for your query.

Related Skills

Explore More Content & Communication Skills→
ragnarokhaaragnarokhaa
4

gif-search

Searches and downloads GIFs from the Tenor API by query and format.

Community
Basic
kotakbiasakotakbiasa

gif-search

Search Tenor via curl and jq to retrieve GIF URLs.

Community
Intermediate
AXGZ21AXGZ21

gif-search

Searches and downloads GIFs from Tenor using curl and jq.

Community
Basic
FatByFatBy
2

gifgrep

Search Tenor and Giphy GIFs, browse in a TUI, and extract stills or sheets.

Community
Intermediate