GIF検索（Tenor API） は何をしますか？
curl を使用して Tenor API から直接 GIF を検索・ダウンロードできます。追加のツールは不要です。
使用するタイミング
リアクション GIF の検索、ビジュアルコンテンツの作成、チャットでの GIF 送信に便利です。
セットアップ
環境に Tenor API キーを設定します（${HERMES_HOME:-~/.hermes}/.env に追加）:
TENOR_API_KEY=あなたのキー_ここ
無料の API キーは https://developers.google.com/tenor/guides/quickstart から取得できます。Google Cloud Console の Tenor API キーは無料で、十分なレート制限があります。
前提条件
curlとjq（どちらも macOS/Linux 標準）TENOR_API_KEY環境変数
GIF を検索
# 検索して GIF の URL を取得
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 - チャット送信には
tinygifURL の方が軽量です - GIF URL はマークダウンで直接使用できます:
