gif-search

Search Tenor GIFs via API and download results to local files.

Updated Apr 9, 2026
One-click install
npx skills add https://github.com/MarbleSodas/Mavis --skill gif-search-marblesodas
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gif-search
Source: https://github.com/MarbleSodas/Mavis/tree/main/skills/media/gif-search
Command: npx skills add https://github.com/MarbleSodas/Mavis --skill gif-search-marblesodas

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It solves the problem of finding the right reaction or media GIFs quickly without manually browsing and copying links.

Core Features & Use Cases

  • Tenor GIF Search: Query Tenor for GIF results using curl and parse output with jq.
  • Format Selection: Retrieve the right asset type (gif, tinygif, mp4, webm) depending on your use case.
  • Direct Download: Download a top result (or any chosen result) straight to a local file.

Quick Start

Set your TENOR_API_KEY environment variable, then run the curl Tenor search to extract gif URLs for your query.

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 and jq?

To search and download Tenor GIFs, you query the Tenor API v2 search endpoint using curl and parse the JSON response with jq to extract direct media URLs for your chat or content workflows.

What is the best way to get a tinygif URL from Tenor for lightweight sharing?

The best way to get a tinygif URL from Tenor is by applying media format filters when calling the Tenor API v2 search endpoint, allowing you to retrieve preview-light assets specifically for lightweight sharing.

Do I need a TENOR_API_KEY to retrieve GIF media URLs from the API?

Yes, you need a TENOR_API_KEY set as an environment variable to authenticate your curl requests against the Tenor API v2 search endpoint and retrieve usable gif or tinygif media URLs.

Can I automate Tenor GIF retrieval and download specific results to a local file?

Yes, you can automate Tenor GIF retrieval by configuring limits and media filters in your API query, then downloading a chosen top result straight to a local file using curl.

What media formats can I retrieve when searching Tenor for reaction GIFs?

When searching Tenor for reaction GIFs, you can retrieve multiple media formats including gif, tinygif, mp4, and webm depending on your specific content workflow requirements.

Why does my Tenor API search return unexpected media format URLs?

Your Tenor API search might return unexpected URLs if you do not apply the correct media format filters in your curl request, which are needed to specifically target gif or tinygif assets.