gifgrep

Search, preview, download, and process GIFs from Tenor and Giphy

GifGrep GIF Search Skill

Overview

Search, preview, download, and process GIFs from Tenor and Giphy providers. Supports CLI output, interactive TUI with previews, static frame extraction, and frame sheet generation.

Configuration

Environment Variable	Description
GIPHY_API_KEY	Optional for Giphy provider (uses demo key if not set)
TENOR_API_KEY	Optional for Tenor provider (uses demo key if not set)

Usage Examples

Search for GIFs

json

{
  "tool": "gifgrep_search",
  "parameters": {
    "query": "excited reaction",
    "limit": 5,
    "format": "url"
  }
}

Search and download top GIF

json

{
  "tool": "gifgrep_search",
  "parameters": {
    "query": "happy birthday",
    "limit": 1,
    "download": true,
    "output_path": "/workspace/downloads/birthday.gif"
  }
}

Extract static frame from GIF

json

{
  "tool": "gifgrep_extract_frame",
  "parameters": {
    "input_path": "/workspace/downloads/birthday.gif",
    "time": "1.5s",
    "output_path": "/workspace/output/frame.png"
  }
}

Generate frame sheet

json

{
  "tool": "gifgrep_generate_sheet",
  "parameters": {
    "input_path": "/workspace/downloads/birthday.gif",
    "frames": 9,
    "columns": 3,
    "output_path": "/workspace/output/sheet.png"
  }
}

Supported Providers

• auto (default): Uses Giphy if API key is set, otherwise Tenor
• tenor: Tenor GIF provider
• giphy: Giphy GIF provider (requires API key for higher rate limits)