关于 gif-search
gif-search 是 Hermes 技能，通过 curl 调用 Tenor API 搜索和下载 GIF。它可获取完整尺寸或预览媒体及相关元数据，供视觉内容和聊天使用。
主要功能
- 01通过 Tenor API 搜索 GIF
- 02获取完整尺寸和预览链接
- 03下载 GIF 文件
- 04读取标题、尺寸和媒体链接
- 05选择 GIF 或视频格式
适用场景
- 01为聊天寻找反应 GIF
- 02下载 GIF 用于视觉内容
- 03获取便于分享的轻量预览
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/gif-search确认已加载。
详细介绍
GIF 搜索（Tenor API）
通过 Tenor API 直接使用 curl 搜索和下载 GIF。无需其他工具。
适用场景
适用于查找反应 GIF、创建视觉内容，以及在聊天中发送 GIF。
设置
在环境中设置 Tenor API 密钥（添加到 ${HERMES_HOME:-~/.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
# 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 - 在聊天中发送时，
tinygifURL 占用更少 - GIF URL 可直接用于 Markdown：
评论
支持 Markdown