Gif Search

Поиск и загрузка GIF из Tenor через curl + jq.

Метаданные навыка


Источник	Встроенный (установлен по умолчанию)
Путь	`skills/media/gif-search`
Версия	`1.1.0`
Автор	Hermes Agent
Лицензия	MIT
Платформы	linux, macos, windows
Теги	`GIF`, `Media`, `Search`, `Tenor`, `API`

Справочник: полный SKILL.md

инфо

Ниже — полное определение навыка, которое Hermes загружает при его активации. Именно это агент получает в виде инструкций, когда навык включён.

GIF Search (Tenor API)

Поиск и скачивание GIF напрямую через Tenor API с помощью curl. Никаких дополнительных инструментов не нужно.

Когда использовать

Удобно для поиска GIF-реакций, создания визуального контента и отправки GIF в чат.

Настройка

Задайте API-ключ Tenor в переменных окружения (добавьте в ~/.hermes/.env):

TENOR_API_KEY=your_key_here

Бесплатный ключ выдаётся на https://developers.google.com/tenor/guides/quickstart — API-ключ Tenor в Google Cloud Console бесплатен и имеет щедрые лимиты на запросы.

Требования

curl и jq (оба стандартны на macOS/Linux)
Переменная окружения TENOR_API_KEY

Поиск GIF

# 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'

Загрузка 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

Получение полных метаданных

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

Параметр	Описание
`q`	Поисковый запрос (пробелы кодируются как `+`)
`limit`	Максимум результатов (1–50, по умолчанию 20)
`key`	API-ключ (из переменной `$TENOR_API_KEY`)
`media_filter`	Фильтр форматов: `gif`, `tinygif`, `mp4`, `tinymp4`, `webm`
`contentfilter`	Безопасность контента: `off`, `low`, `medium`, `high`
`locale`	Язык: `en_US`, `es`, `fr` и др.

Доступные форматы медиа

Каждый результат содержит несколько форматов в .media_formats:

Формат	Применение
`gif`	GIF в полном качестве
`tinygif`	Маленький превью-GIF
`mp4`	Видеоверсия (меньший размер файла)
`tinymp4`	Маленькое превью-видео
`webm`	WebM-видео
`nanogif`	Крошечная миниатюра

Примечания

Кодируйте запрос: пробелы как +, спецсимволы как %XX
Для отправки в чат tinygif-ссылки легче по весу
GIF-ссылки можно использовать прямо в markdown: ![alt](https://github.com/NousResearch/hermes-agent/blob/main/skills/media/gif-search/url)