gif-search

SKILL.md

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

# 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

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

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

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
Weekly Installs
1
GitHub Stars
6
First Seen
11 days ago
Installed on
amp1
cline1
trae1
trae-cn1
opencode1
cursor1