gif-search

Search Tenor GIFs via v2 API and download selected media files.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It solves the problem of finding the right reaction or visual GIF quickly without manually browsing Tenor and copying links one by one.

Core Features & Use Cases

  • GIF search via Tenor API: Retrieve GIF, tinygif, mp4, tinymp4, webm, and nanogif URLs for a given query.
  • Download from a selected result: Save the top (or any) returned GIF directly to a local file for use in chat or documents.
  • Fetch rich metadata: Extract titles, preview URLs, dimensions, and other fields from results to choose the best format.

Use case: When you want to send a celebratory reaction in chat, you can search for the best matching term and download a lightweight tinygif/preview URL for fast sharing.

Quick Start

Ask the agent to search Tenor for thumbs up GIFs and return 5 GIF URLs using your TENOR_API_KEY environment variable.

Frequently Asked Questions about gif-search

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search and download Tenor reaction GIFs via API?

To search Tenor GIFs, you call the v2 search endpoint using curl and jq with a TENOR_API_KEY, specifying your query and limit to retrieve downloadable media URLs and metadata.

What GIF formats and metadata can I retrieve from the Tenor API?

The Tenor API search returns gif, tinygif, mp4, tinymp4, webm, and nanogif URLs, alongside rich metadata fields like titles, preview URLs, and dimensions for format selection.

Do I need curl and jq installed to use this GIF search functionality?

Yes, you need curl and jq installed locally, as this functionality relies on local command-line processing to call the Tenor API and extract specific media format URLs and metadata fields.

Can I download a lightweight GIF directly to a local file for chat sharing?

Yes, you can download a lightweight tinygif or preview URL directly to a local file from the selected search result, enabling fast sharing and seamless content creation workflows.

What is the best way to get a specific number of GIF URLs for a search query?

The best way to get GIF URLs is to provide your search query and a desired limit to the Tenor v2 search endpoint, which returns the corresponding number of media format URLs.

Why does the Tenor GIF search require an API key environment variable?

The Tenor GIF search requires a TENOR_API_KEY environment variable because curl needs this key to authenticate requests to the Tenor v2 API endpoint and successfully retrieve GIF data.