gif-search

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

Updated Sep 1, 2021
One-click install
npx skills add https://github.com/unclehowell/unclehowell --skill gif-search-unclehowell
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gif-search
Source: https://github.com/unclehowell/unclehowell/tree/main/skills/media/gif-search
Command: npx skills add https://github.com/unclehowell/unclehowell --skill gif-search-unclehowell

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes friction from finding and retrieving GIF media by providing simple, curl-and-jq based commands to query the Tenor API and obtain direct media URLs and downloadable files, so teams and chatbots can add reaction imagery without SDKs or heavy tooling.

Core Features & Use Cases

  • Search & Retrieve: Perform text queries against Tenor v2 and extract gif and tinygif media URLs.
  • Download Top Result: Resolve a media URL and save the top result as a local GIF file using standard HTTP tools.
  • Use Case: Quickly fetch reaction GIFs for chat, attach small preview GIFs to social posts, or collect media assets for lightweight content creation.

Quick Start

Search Tenor for celebration and download the top GIF result using the gif-search skill with TENOR_API_KEY set in your environment.

Frequently Asked Questions about gif-search

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

FAQPage Schema
How do I download GIFs from Tenor using curl and jq?

To download GIFs from Tenor, you query the Tenor v2 API using curl and parse the JSON response with jq to extract direct media URLs. This Skill provides the commands to search Tenor and save the top result as a local GIF file.

Do I need an API key to search Tenor for reaction GIFs?

Yes, searching Tenor for reaction GIFs requires the TENOR_API_KEY environment variable to be set. This key authenticates your curl requests to the Tenor v2 endpoints so you can retrieve and download media URLs.

Can I retrieve tinygif preview media for chat messages without an SDK?

Yes, you can retrieve tinygif preview media for chat messages without an SDK. This Skill uses standard command-line HTTP tools like curl and jq to query Tenor and extract lightweight preview media URLs directly.

What's the best way to fetch GIF media URLs for social posts from the command line?

The best way to fetch GIF media URLs for social posts from the command line is using curl to call the Tenor v2 API and jq to parse the response. This approach avoids heavy tooling and quickly provides direct links to gif and tinygif formats.

Why does my Tenor GIF search return no media URLs when using curl?

If your Tenor GIF search returns no media URLs when using curl, it is likely because the TENOR_API_KEY environment variable is not set. You must configure this key properly to authenticate requests and extract media URLs with jq successfully.