Back to Details

gif-search

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

GIF Search

GIF搜索

Search for GIFs from GIPHY and Tenor using their public APIs.
从GIPHY和Tenor的公开API搜索GIF。

Quick Start

快速开始

bash
/job/.pi/skills/gif-search/gif-search.js "cats"
bash
/job/.pi/skills/gif-search/gif-search.js "cats"

Usage

使用方法

Basic Search

基础搜索

bash
/job/.pi/skills/gif-search/gif-search.js "<query>"
bash
/job/.pi/skills/gif-search/gif-search.js "<query>"

Search with Limit

带数量限制的搜索

bash
job/.pi/skills/gif-search/gif-search.js "<query>" <limit>
Default limit is 5.
bash
job/.pi/skills/gif-search/gif-search.js "<query>" <limit>
默认限制数量为5。

Get GIF URL Only

仅获取GIF链接

bash
job/.pi/skills/gif-search/gif-search.js "<query>" 1 url
bash
/job/.pi/skills/gif-search/gif-search.js "<query>" 1 url

Configuration

配置

Requires one of these environment variables (check with llm-secrets skill):
  • GIPHY_API_KEY
    - GIPHY API key
  • TENOR_API_KEY
    - Tenor API key
If both are available, GIPHY is used by default.
需要以下环境变量之一（可通过llm-secrets skill查看）：
  • GIPHY_API_KEY
    - GIPHY API密钥
  • TENOR_API_KEY
    - Tenor API密钥
如果两个密钥都可用，默认使用GIPHY。

Output Format

输出格式

Returns JSON array of GIF results:
json
[
  {
    "id": "gif_id",
    "title": "Funny Cat GIF",
    "url": "https://media.giphy.com/media/xxx/giphy.gif",
    "preview_url": "https://media.giphy.com/media/xxx/200.gif",
    "width": 480,
    "height": 270
  }
]
返回GIF结果的JSON数组：
json
[
  {
    "id": "gif_id",
    "title": "Funny Cat GIF",
    "url": "https://media.giphy.com/media/xxx/giphy.gif",
    "preview_url": "https://media.giphy.com/media/xxx/200.gif",
    "width": 480,
    "height": 270
  }
]

Examples

示例

bash
undefined
bash
undefined

Search for happy birthday GIFs

搜索生日快乐GIF

/job/.pi/skills/gif-search/gif-search.js "happy birthday"
/job/.pi/skills/gif-search/gif-search.js "happy birthday"

Get top 3 results

获取前3条结果

/job/.pi/skills/gif-search/gif-search.js "celebration" 3
/job/.pi/skills/gif-search/gif-search.js "celebration" 3

Get just the URL of the top result

仅获取第一条结果的链接

/job/.pi/skills/gif-search/gif-search.js "thumbs up" 1 url
undefined
/job/.pi/skills/gif-search/gif-search.js "thumbs up" 1 url
undefined

When to Use

适用场景

  • User asks for a GIF, reaction image, or meme
  • Need visual content for Discord/Slack messages
  • Adding personality to chat responses
  • Finding anniversary/birthday/celebration content
  • 用户请求GIF、反应图片或表情包
  • 需要为Discord/Slack消息添加视觉内容
  • 为聊天回复增添个性
  • 寻找纪念日/生日/庆祝类内容