gif-search

GIF 検索（Tenor API）

curl を使って Tenor API 経由で GIF を直接検索・ダウンロードできます。追加のツールは不要です。

使用する場面

リアクション GIF の検索、ビジュアルコンテンツの作成、チャットでの GIF の送信に便利です。

セットアップ

Tenor API キーを環境変数に設定します（${HERMES_HOME:-~/.hermes}/.env に追加します）。

TENOR_API_KEY=your_key_here

無料の API キーは https://developers.google.com/tenor/guides/quickstart で取得できます。Google Cloud Console の Tenor API キーは無料で、レート制限にも余裕があります。

前提条件

• 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	検索クエリ（スペースは + として 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 にします。
• チャットで送信する場合は、容量の小さい tinygif の URL が適しています。
• GIF の URL は Markdown で直接使用できます：![alt](url)