skills.rest
maopujie10-sys
maopujie10-sysCOMMUNITY
Explore all skills by this author →
GitHub

gif-search

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

1|Updated Jun 24, 2026
Search Tags:#api#search#media#gif#download#curl#tenor
One-click install
npx skills add https://github.com/maopujie10-sys/Bailongma --skill gif-search-maopujie10-sys
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gif-search
Source: https://github.com/maopujie10-sys/Bailongma/tree/main/skills/hermes-skills/media/gif-search
Command: npx skills add https://github.com/maopujie10-sys/Bailongma --skill gif-search-maopujie10-sys

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 directly from the command line and retrieve GIF URLs or files without leaving your workflow. ## 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 in one pipeline. - Metadata Retrieval: Extract titles, preview URLs, and dimensions for each result using jq filters. - Use Case: While chatting, you want a reaction GIF for "celebration". Run the search command, grab the 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 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 parameters. Pipe the JSON response through jq to extract GIF URLs from the media_formats field of each result.

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 pass that URL to curl -sL with an output filename. The -L flag follows redirects so the binary GIF file saves correctly.

Where do I get a Tenor API key?▼

Register for a free key through the Google Cloud Console by enabling the Tenor API, as described at developers.google.com/tenor/guides/quickstart. The free tier has generous rate limits suitable for personal use.

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 the full gif format for maximum quality.

Why does my Tenor API search return an error?▼

Errors usually occur when TENOR_API_KEY is unset or the query contains unencoded spaces or special characters. URL-encode spaces as plus signs and verify the key is exported in your shell environment.

Related Skills

Explore More Content & Communication Skills→
christian-byrnechristian-byrne

gif-search

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

Community
Basic
unclehowellunclehowell

gif-search

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

Community
Basic
ChatAndBuildChatAndBuild
1

slack-gif-creator

Create Slack-optimized animated GIFs using Python's PIL and imageio.

Official
Intermediate
winsorllcwinsorllc

gif-search

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

Community
Intermediate