gif-search

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Finding and downloading GIFs for chat messages, reaction content, or visual assets normally requires manual browsing; this Skill retrieves GIF URLs and files directly from the Tenor API via 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 each result using jq. - Use Case: While composing a chat reply, ask the agent to find a celebration GIF and get a lightweight tinygif URL ready to embed in markdown. ## 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 your query, limit, and API key, then parse the JSON response with jq to extract URLs from .results[].media_formats.gif.url. URL-encode spaces in the query as +.

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

First query the Tenor 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, for example celebration.gif.

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

You need a TENOR_API_KEY environment variable containing a free Google Cloud Console Tenor API key. The key is free with generous rate limits and can be stored in your Zeus .env file.

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 mp4 for smaller video file sizes.

Why does my Tenor API search return no results?▼

Missing results usually come from an unset or invalid TENOR_API_KEY, unencoded special characters in the query, or a restrictive contentfilter setting. Verify the key is exported and URL-encode the query string.