GifGrep (tc)

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

Audits

Pass

Install

openclaw skills install tc-gifgrep

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 VariableDescription
GIPHY_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

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

Search and download top GIF

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

Extract static frame from GIF

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

Generate frame sheet

{
  "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)