skills.rest
Junkfooooood
JunkfoooooodCOMMUNITY
Explore all skills by this author →
GitHub

gif-search

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

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

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 and save the top search result as a local GIF file with a single pipeline. - Metadata Retrieval: Extract titles, preview URLs, and dimensions for search results. - 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 a markdown message. ## Quick Start Set your 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 do I download a GIF from the command line?▼

Search Tenor with curl, extract the top result URL using jq, then run curl -sL "$URL" -o filename.gif to save it locally. The Skill provides a ready-made one-liner for this workflow.

Where do I get a Tenor API key?▼

Get a free API key from the Google Cloud Console by enabling the Tenor API, as described at developers.google.com/tenor/guides/quickstart. Set it as the TENOR_API_KEY environment variable before running searches.

What GIF formats does the Tenor API support?▼

Tenor returns multiple media formats per result: gif, tinygif, mp4, tinymp4, webm, and nanogif. Use tinygif for lightweight chat previews and gif for full-quality downloads.

Why does my Tenor API search return an error?▼

Errors usually come from a missing or invalid TENOR_API_KEY, or an unencoded query string. URL-encode spaces as + and special characters as %XX, and verify the key is exported in your environment.

Related Skills

Explore More Content & Communication Skills→
reGeorgereGeorge

飞书Access Token获取器

Retrieve Feishu API app access tokens using app credentials.

Community
Basic
unclehowellunclehowell

gif-search

Search Tenor API and download GIF media URLs using curl and jq.

Community
Basic
RemseyMailjardRemseyMailjard

gif-sticker-maker

Generate four animated GIF stickers from photos with captions using MiniMax APIs.

Community
Advanced
winsorllcwinsorllc

gif-search

Search animated GIFs via GIPHY and Tenor APIs and return URLs.

Community
Intermediate