How do I install the Gif Search skill?

Run npx skillmds@latest add nousresearch/gif-search in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Gif Search skill do?

Search/download GIFs from Tenor via curl + jq. It is listed under Coding & Dev Tools on SkillMD.

Is Gif Search safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Gif Search?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Gif Search free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Gif Search?

NousResearch (@nousresearch) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Gif Search by nousresearch — Agent Skill

Name: Gif Search
Rating: 4.2 (5 reviews)
Author: NousResearch

File contents

GIF Search (Tenor API)

Search and download GIFs directly via the Tenor API using curl. No extra tools needed.

When to use

Useful for finding reaction GIFs, creating visual content, and sending GIFs in chat.

Setup

Set your Tenor API key in your environment (add to ${HERMES_HOME:-~/.hermes}/.env):

TENOR_API_KEY=your_key_here

Get a free API key at https://developers.google.com/tenor/guides/quickstart — the Google Cloud Console Tenor API key is free and has generous rate limits.

Prerequisites

curl and jq (both standard on macOS/Linux)
TENOR_API_KEY environment variable

Search for GIFs

# Search and get GIF URLs
curl -s "https://tenor.googleapis.com/v2/search?q=thumbs+up&limit=5&key=${TENOR_API_KEY}" | jq -r '.results[].media_formats.gif.url'

# Get smaller/preview versions
curl -s "https://tenor.googleapis.com/v2/search?q=nice+work&limit=3&key=${TENOR_API_KEY}" | jq -r '.results[].media_formats.tinygif.url'

Download a GIF

# Search and download the top result
URL=$(curl -s "https://tenor.googleapis.com/v2/search?q=celebration&limit=1&key=${TENOR_API_KEY}" | jq -r '.results[0].media_formats.gif.url')
curl -sL "$URL" -o celebration.gif

Get Full Metadata

curl -s "https://tenor.googleapis.com/v2/search?q=cat&limit=3&key=${TENOR_API_KEY}" | jq '.results[] | {title: .title, url: .media_formats.gif.url, preview: .media_formats.tinygif.url, dimensions: .media_formats.gif.dims}'

API Parameters

Parameter	Description
`q`	Search query (URL-encode spaces as `+`)
`limit`	Max results (1-50, default 20)
`key`	API key (from `$TENOR_API_KEY` env var)
`media_filter`	Filter formats: `gif`, `tinygif`, `mp4`, `tinymp4`, `webm`
`contentfilter`	Safety: `off`, `low`, `medium`, `high`
`locale`	Language: `en_US`, `es`, `fr`, etc.

Available Media Formats

Each result has multiple formats under .media_formats:

Format	Use case
`gif`	Full quality GIF
`tinygif`	Small preview GIF
`mp4`	Video version (smaller file size)
`tinymp4`	Small preview video
`webm`	WebM video
`nanogif`	Tiny thumbnail

Notes

URL-encode the query: spaces as +, special chars as %XX
For sending in chat, tinygif URLs are lighter weight
GIF URLs can be used directly in markdown: ![alt](url)

Source: NousResearch/hermes-agent → skills/media/gif-search/SKILL.md

---name: gif-searchdescription: Search/download GIFs from Tenor via curl + jq.--- # GIF Search (Tenor API) Search and download GIFs directly via the Tenor API using curl. No extra tools needed. ## When to use Useful for finding reaction GIFs, creating visual content, and sending GIFs in chat. ## Setup Set your Tenor API key in your environment (add to `${HERMES_HOME:-~/.hermes}/.env`): ```bash TENOR_API_KEY=your_key_here ``` Get a free API key at https://developers.google.com/tenor/guides/quickstart — the Google Cloud Console Tenor API key is free and has generous rate limits. ## Prerequisites - `curl` and `jq` (both standard on macOS/Linux) - `TENOR_API_KEY` environment variable ## Search for GIFs ```bash # Search and get GIF URLs curl -s "https://tenor.googleapis.com/v2/search?q=thumbs+up&limit=5&key=${TENOR_API_KEY}" | jq -r '.results[].media_formats.gif.url' # Get smaller/preview versions curl -s "https://tenor.googleapis.com/v2/search?q=nice+work&limit=3&key=${TENOR_API_KEY}" | jq -r '.results[].media_formats.tinygif.url' ``` ## Download a GIF ```bash # Search and download the top result URL=$(curl -s "https://tenor.googleapis.com/v2/search?q=celebration&limit=1&key=${TENOR_API_KEY}" | jq -r '.results[0].media_formats.gif.url') curl -sL "$URL" -o celebration.gif ``` ## Get Full Metadata ```bash curl -s "https://tenor.googleapis.com/v2/search?q=cat&limit=3&key=${TENOR_API_KEY}" | jq '.results[] | {title: .title, url: .media_formats.gif.url, preview: .media_formats.tinygif.url, dimensions: .media_formats.gif.dims}' ``` ## API Parameters | Parameter | Description | |-----------|-------------| | `q` | Search query (URL-encode spaces as `+`) | | `limit` | Max results (1-50, default 20) | | `key` | API key (from `$TENOR_API_KEY` env var) | | `media_filter` | Filter formats: `gif`, `tinygif`, `mp4`, `tinymp4`, `webm` | | `contentfilter` | Safety: `off`, `low`, `medium`, `high` | | `locale` | Language: `en_US`, `es`, `fr`, etc. | ## Available Media Formats Each result has multiple formats under `.media_formats`: | Format | Use case | |--------|----------| | `gif` | Full quality GIF | | `tinygif` | Small preview GIF | | `mp4` | Video version (smaller file size) | | `tinymp4` | Small preview video | | `webm` | WebM video | | `nanogif` | Tiny thumbnail | ## Notes - URL-encode the query: spaces as `+`, special chars as `%XX` - For sending in chat, `tinygif` URLs are lighter weight - GIF URLs can be used directly in markdown: `![alt](url)` --- **Source:** [`NousResearch/hermes-agent`](https://github.com/NousResearch/hermes-agent) → `skills/media/gif-search/SKILL.md`

Frequently asked questions

Gif Search