给助手和脚本

让助手直接调用 GrabGrab

网站、Chrome 扩展、脚本和 AI 工具走的是同一套下载接口。优先处理 X 和 Twitter。公开的 TikTok、Vimeo、Facebook 视频使用同一个请求。YouTube 会在开始下载之前被拒绝。

curl

用 POST 提交一个公开网址。videoQuality 可以是 max、2160、1440、1080、720、480 或 360。第二段命令用来保存 JSON 里返回的文件地址。脚本不要发送 Turnstile 令牌。

curl -s -X POST "https://www.grabgrab.fun/api/download" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://x.com/X/status/1697304622749086011","videoQuality":"1080"}'

curl -L -o video.mp4 "PASTE_THE_URL_FROM_THE_JSON"

MCP

Claude Desktop、Cursor 和其他 MCP 客户端可以使用无状态端点 https://www.grabgrab.fun/api/mcp 。工具名是 download_video，url 必填，quality 可选。平台白名单和频率限制与 HTTP 接口相同。贴上这段配置后重启客户端。

{
  "mcpServers": {
    "grabgrab": {
      "url": "https://www.grabgrab.fun/api/mcp"
    }
  }
}

命令行

仓库里的 packages/cli 有一个很小的 Node 客户端，还没有发布到 npm。它只打印 JSON，不会附带密钥。在仓库副本里运行下面的命令。

node packages/cli/bin/grabgrab.mjs "https://x.com/X/status/1697304622749086011" 1080

ClawHub 技能

技能文件在 skills/grabgrab，说明同一套以 X 为先的用法，并包含 MCP 和 curl。ClawHub 上的公开页面要等所有者发布 1.2.0 之后才会更新。助手不应编造密钥。

限制

开启 Turnstile 后，grabgrab.fun 上的浏览器需要完成人机验证。脚本、MCP 客户端和扩展不发送该令牌，因此使用更小的 API 限额：每个服务器实例上大约每 10 分钟、每个 IP 6 次。私密或已删除的帖子会失败。YouTube 返回 youtube_not_supported。