Gif Search - поиск и загрузка GIF из Tenor через curl и jq

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

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

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

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

Ниже приведено полное определение навыка, которое Hermes загружает при его активации. Именно эти инструкции агент видит во время работы навыка.

GIF Search (Tenor API)

Ищите и загружайте GIF напрямую через Tenor API с помощью curl. Дополнительные инструменты не нужны.

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

Полезно для поиска reaction GIF, создания визуального контента и отправки GIF в чат.

Установка

Задайте API-ключ Tenor в окружении, например в ~/.hermes/.env:

TENOR_API_KEY=your_key_here

Получить бесплатный ключ можно по адресу https://developers.google.com/tenor/guides/quickstart - ключ Google Cloud Console Tenor API бесплатен и имеет щедрые лимиты.

Требования

• curl и jq
• переменная окружения TENOR_API_KEY

Поиск GIF

# Поиск и получение URL GIF
curl -s "https://tenor.googleapis.com/v2/search?q=thumbs+up&limit=5&key=${TENOR_API_KEY}" | jq -r '.results[].media_formats.gif.url'

# Получение уменьшенных / preview-версий
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

# Найти и скачать лучший результат
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

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

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

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

Format	Use case
gif	GIF в полном качестве
tinygif	Небольшой preview GIF
mp4	Видео-версия с меньшим размером файла
tinymp4	Небольшой preview-видео
webm	WebM-видео
nanogif	Миниатюрный thumbnail

Примечания

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