gif-search

Search Tenor for GIFs and return media URLs via curl and jq.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It eliminates the time-consuming search process of finding the right GIF for a reaction by pulling matching results from Tenor automatically.

Core Features & Use Cases

  • Tenor API GIF search: Retrieve GIF and preview URLs for a query using only curl.
  • Format targeting: Choose from gif, tinygif, mp4, tinymp4, webm, and more depending on where you’ll use the media.
  • Chat-ready downloading: Download a selected result and return lightweight preview links for messaging.

Quick Start

Search for reaction GIF URLs by running: curl -s "https://tenor.googleapis.com/v2/search?q=thumbs+up&limit=5&key=${TENOR_API_KEY}" | jq -r '.results[].media_formats.gif.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 Tenor for reaction GIFs and return media URLs?

To search Tenor for GIFs, you use curl to call the Tenor v2 search endpoint with your query and API key, then parse the JSON response with jq to extract usable media URLs from the results.

What GIF formats can I target when downloading media from Tenor search results?

Tenor search results support multiple media formats including gif, tinygif, mp4, tinymp4, and webm, allowing you to select the optimal file type based on where the media will be used.

Do I need an API key to retrieve GIFs from the Tenor search endpoint?

Yes, retrieving GIFs from the Tenor search endpoint requires a valid TENOR_API_KEY passed in the request URL to authenticate your queries and return accessible media URLs.

Can I use curl and jq to pull lightweight preview GIFs for chat and automation workflows?

Yes, you can use curl to query the Tenor v2 search endpoint and jq to parse the response, pulling lightweight preview GIFs suitable for chat applications and automation workflows.

What's the best way to find and download specific reaction GIFs without manual searching?

The best way to find reaction GIFs without manual searching is to automate the process by calling the Tenor search API with curl, filtering results with jq, and directly downloading the matched media URLs.