gif-search

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

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

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 via the command line. ## Core Features & Use Cases - GIF Search: Query the Tenor API with keywords and retrieve full-quality or preview GIF URLs using curl and jq. - Direct Download: Fetch the top search result and save it as a local GIF file in one pipeline. - Metadata Inspection: Extract titles, URLs, preview links, and dimensions for each result. - Use Case: While chatting on Telegram or Discord, quickly search for a "celebration" GIF, grab the tinygif URL, and paste it directly into the conversation as 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 parameters q, limit, and key using curl. Pipe the JSON response through jq to extract GIF URLs from .results[].media_formats.gif.url.

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

First query the Tenor search endpoint and extract the top result URL with jq, then run curl -sL on that URL with -o to save the file locally. The Skill demonstrates this as a two-command pipeline.

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

You need a TENOR_API_KEY environment variable, obtainable free from the Google Cloud Console Tenor API quickstart. The free key has generous rate limits and is set in ~/.gpucloud/.env.

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.

Why does my Tenor API search return no results?▼

Common causes include a missing or invalid TENOR_API_KEY, unencoded spaces or special characters in the query, or an overly strict contentfilter setting. URL-encode spaces as + and verify the key is exported in your environment.