gif-search

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Finding and downloading GIFs for chat, reactions, or visual content usually requires manual browsing; this Skill retrieves GIF URLs and files directly from the Tenor API using only curl and jq. ## 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 Retrieval: Extract titles, preview URLs, and dimensions for each result. - Use Case: You want a reaction GIF for a chat message—run a single curl command with your query 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 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 your query, limit, and API key, then parse the JSON with jq to extract .results[].media_formats.gif.url. URL-encode spaces in the query as plus signs.

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 pass that URL to curl -sL with an output filename. The Skill shows a two-command pipeline that saves the file locally.

What API key do I need for Tenor GIF search?

You need a free Tenor API key from the 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 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 are a missing or invalid TENOR_API_KEY, unencoded special characters in the query, or an overly restrictive contentfilter setting. Verify the key is exported and URL-encode spaces as plus signs.