AgentSkillsCN

gif-search

从 Tenor 和 Giphy 的 API 中搜索并下载 GIF 动图

SKILL.md
--- frontmatter
name: gif-search
version: 1.0.0
description: Search and download GIFs from Tenor and Giphy APIs
author: Code Buddy
tags: gif, search, tenor, giphy, meme
env:
  TENOR_API_KEY: ""
  GIPHY_API_KEY: ""

GIF Search

Overview

Search for GIFs using Tenor or Giphy APIs and download them for sharing.

Tenor (free tier, no key required for basic)

Search

bash
# Basic search (Tenor v2 API)
curl -s "https://tenor.googleapis.com/v2/search?q=thumbs+up&limit=5&key=${TENOR_API_KEY:-AIzaSyA...}" \
  | jq -r '.results[].media_formats.gif.url'

Download

bash
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 -s "$url" -o /tmp/celebration.gif

Giphy (requires API key)

Search

bash
curl -s "https://api.giphy.com/v1/gifs/search?api_key=$GIPHY_API_KEY&q=thumbs+up&limit=5" \
  | jq -r '.data[].images.original.url'

Trending

bash
curl -s "https://api.giphy.com/v1/gifs/trending?api_key=$GIPHY_API_KEY&limit=5" \
  | jq -r '.data[].images.original.url'

Tips

  • URL-encode search queries: spaces become + or %20
  • Use jq to filter results and extract URLs
  • Download to /tmp/ for temporary use
  • Tenor's free tier allows basic searches without a key
  • For smaller file sizes, use mediumgif or tinygif format from Tenor
  • For Giphy, use fixed_height or fixed_width for smaller variants