跳到主要内容

Gif 搜索

通过 curl + jq 从 Tenor 搜索/下载 GIF。

技能元数据​

来源内置（默认安装）
路径skills/media/gif-search
版本1.1.0
作者Hermes 智能体
许可证MIT
平台linux, macos, windows
标签GIF, 媒体, 搜索, Tenor, API

参考：完整的 SKILL.md​

信息

以下是 Hermes 在触发此技能时加载的完整技能定义。这是智能体在技能激活时看到的指令。

GIF 搜索（Tenor API）

使用 curl 通过 Tenor API 直接搜索和下载 GIF。无需额外工具。

何时使用​

适用于查找反应 GIF、创建视觉内容以及在聊天中发送 GIF。

设置​

在你的环境变量中设置 Tenor API 密钥（添加到 ~/.hermes/.env）：

TENOR_API_KEY=your_key_here

在 https://developers.google.com/tenor/guides/quickstart 获取免费的 API 密钥 — 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）
keyAPI 密钥（来自 $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小型预览视频
webmWebM 视频
nanogif微型缩略图

注意事项​

  • 对查询进行 URL 编码：空格用 +，特殊字符用 %XX
  • 用于聊天发送时，tinygif URL 更轻量
  • GIF URL 可以直接在 markdown 中使用：![alt](https://github.com/NousResearch/hermes-agent/blob/main/skills/media/gif-search/url)