skills.rest
christian-byrne
christian-byrneCOMMUNITY
Explore all skills by this author →
𝕏@c__byrneGitHub

gif-search

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

Updated Jul 28, 2026
Search Tags:#api#search#gif#download#curl#tenor#reaction gif
One-click install
npx skills add https://github.com/christian-byrne/comfy-skills --skill gif-search-christian-byrne
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gif-search
Source: https://github.com/christian-byrne/comfy-skills/tree/main/skills/gif-search
Command: npx skills add https://github.com/christian-byrne/comfy-skills --skill gif-search-christian-byrne

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Finding and downloading reaction GIFs or animated images normally requires manual browsing on GIF websites. This Skill lets you search the Tenor API and download GIFs directly from the command line with only curl and jq. ## Core Features & Use Cases - GIF Search: Query the Tenor API v2 with keywords and retrieve titles and media URLs as JSON. - Direct Download: Extract the top result's GIF URL and save the file locally in one pipeline. - Format Selection: Choose from gif, tinygif, mp4, tinymp4, webm, and nanogif media formats, with content filtering and locale parameters. - Use Case: While writing a release announcement, ask for a celebration GIF and get the file downloaded locally, ready to embed in your post or chat message. ## Quick Start Set your TENOR_API_KEY environment variable and ask the agent to find and download a celebration GIF from Tenor.

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 from the command line?▼

Use curl to call the Tenor API v2 search endpoint with your query and API key, then pipe the JSON response through jq to extract titles and media URLs. This skill provides ready-made commands for searching and downloading.

How do I download a GIF using curl?▼

First query the Tenor search endpoint and extract the top result's gif URL with jq, then pass that URL to curl with the -o flag to save the file locally. The skill chains both steps into a single pipeline.

Do I need an API key to use the Tenor API?▼

Yes, Tenor API v2 requires a free API key obtained from Google Cloud Console by enabling the Tenor API. Set it as the TENOR_API_KEY environment variable before running the commands.

What media formats does the Tenor API support?▼

The Tenor API returns gif, tinygif, mp4, tinymp4, webm, and nanogif formats for each result. Use the media_filter parameter to restrict which formats are returned in the response.

What dependencies are required to run these GIF search commands?▼

Only curl and jq are required, both commonly preinstalled on Unix systems. No Python packages, npm modules, or additional tooling are needed.

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
danmartinez78danmartinez78

gif-search

Search Tenor via API and download the top GIF using curl and jq.

Community
Basic
OpenLoafOpenLoaf
94

media-ops-skill

Process local media files and download public videos for editing.

Official
Intermediate
caiazzopcaiazzop

gifgrep

Search Tenor and Giphy GIFs via CLI or TUI, download results, and extract frames.

Community
Intermediate