Gif Search

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

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

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

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

к сведению

Ниже приведено полное описание навыка, которое VibeOS загружает при его активации. Агент видит эти инструкции, когда навык активен.

Поиск GIF (Tenor API)

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

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

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

Настройка

Укажите ваш API-ключ Tenor в переменных окружения (добавьте в ${VIBEOS_HOME:-~/.vibeos}/.env):

TENOR_API_KEY=ваш_ключ_здесь

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

Предварительные требования

• curl и jq (оба стандартны на macOS/Linux)
• Переменная окружения 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'

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

Параметр	Описание
q	Поисковый запрос (URL-кодирование пробелов как +)
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	Крошечная миниатюра

Примечания

• URL-кодируйте запрос: пробелы как +, спецсимволы как %XX
• Для отправки в чат URL tinygif легче по весу
• URL GIF можно использовать напрямую в Markdown: !alt``