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 VariableDescriptionGIPHY_API_KEYOptional for Giphy provider (uses demo key if not set)TENOR_API_KEYOptional 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)