gifgrep

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

Audits

Pass

ClawScanPass

Agentic behavior and permission review.

Static analysisPass

Pattern checks against bundled files.

VirusTotalPass

Multi-engine malware detections and file reputation.

Install

openclaw skills install terrycarter1985-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 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

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