gif-search

Search Tenor GIFs via curl and parse JSON results with jq.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Searching for the right GIFs to match a message is slow and frustrating when you have to manually browse and copy links.

Core Features & Use Cases

  • Tenor API search: Retrieves GIF results for a query such as reactions, celebrations, or topic-based matches.
  • Format selection: Supports choosing different media formats like full GIFs, tiny previews, and alternative video formats.
  • Download and metadata: Lets you download a selected GIF and fetch relevant details like title, URLs, preview links, and dimensions.

Quick Start

Run gif-search to search Tenor for GIFs matching the query thumbs up and return up to 5 results using your TENOR_API_KEY in the environment.

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 GIFs using curl?

To search and download Tenor GIFs using curl, you call the Tenor search endpoint with curl and parse the JSON results using jq. You must provide a TENOR_API_KEY environment variable to authenticate the request.

Can I retrieve different media formats when downloading GIFs from the Tenor API?

Yes, Tenor API search supports format selection for different media types, allowing you to choose between full GIFs, tiny previews, and alternative video formats when retrieving GIF URLs.

What metadata is available when fetching GIF search results from Tenor?

Fetching Tenor GIF search results returns metadata including the title, URLs, preview links, and dimensions for each selected GIF, which can be extracted from the JSON response using jq.

Do I need an API key to get GIF URLs for automated message workflows?

Yes, you need a TENOR_API_KEY environment variable set up to authenticate automated retrieval of GIF URLs for downstream message workflows using curl and jq.

What's the best way to generate lightweight preview links for chat reactions?

The best way to generate lightweight preview links for chat reactions is to query the Tenor API using curl, then use jq to parse and extract the tiny preview format URLs from the JSON response.

Are there limitations when using curl and jq for Tenor GIF search?

Using curl and jq for Tenor GIF search requires both tools to be installed in your environment, along with a valid TENOR_API_KEY, and is limited to processing the JSON results returned by the Tenor search endpoint.