名称： gifgrep
描述： 通过 CLI/TUI 搜索 GIF 提供商，下载结果，并提取静态帧或帧序列图。
主页： https://gifgrep.com
元数据： {"clawdbot":{"emoji":"🧲","requires":{"bins":["gifgrep"]},"install":[{"id":"brew","kind":"brew","formula":"steipete/tap/gifgrep","bins":["gifgrep"],"label":"通过 Homebrew 安装 gifgrep"},{"id":"go","kind":"go","module":"github.com/steipete/gifgrep/cmd/gifgrep@latest","bins":["gifgrep"],"label":"通过 Go 安装 gifgrep"}]}}

gifgrep

使用 gifgrep 搜索 GIF 提供商（Tenor/Giphy），在 TUI 中浏览，下载结果，并提取静态帧或帧序列图。

GIF-Grab (gifgrep 工作流)
- 搜索 → 预览 → 下载 → 提取（静态帧/帧序列图），便于快速查看和分享。

快速开始
- gifgrep cats --max 5
- gifgrep cats --format url | head -n 5
- gifgrep search --json cats | jq '.[0].url'
- gifgrep tui "office handshake"
- gifgrep cats --download --max 1 --format url

TUI 与预览
- TUI：gifgrep tui "查询词"
- CLI 静态帧预览：--thumbs（仅限 Kitty/Ghostty 终端；显示静态帧）

下载与显示
- --download：将结果保存到 ~/Downloads
- --reveal：在 Finder 中显示最近下载的文件

静态帧与帧序列图
- gifgrep still ./clip.gif --at 1.5s -o still.png
- gifgrep sheet ./clip.gif --frames 9 --cols 3 -o sheet.png
- 帧序列图：将多个采样帧合并为单张 PNG 网格图（适合快速查看、文档、PR 或聊天）。
- 可调参数：--frames（帧数）、--cols（网格列数）、--padding（间距）。

提供商
- --source auto|tenor|giphy
- 使用 --source giphy 时需要设置 GIPHY_API_KEY
- TENOR_API_KEY 可选（未设置时使用 Tenor 演示密钥）

输出格式
- --json：输出结果数组（包含 id、title、url、preview_url、tags、width、height）
- --format：输出便于管道处理的字段（如 url）

环境变量调整
- GIFGREP_SOFTWARE_ANIM=1：强制使用软件动画渲染
- GIFGREP_CELL_ASPECT=0.5：调整预览区域几何比例