アシスタントとスクリプト向け

アシスタントから GrabGrab を呼ぶ

同じ API がサイト、Chrome 拡張、スクリプト、AI ツールを支えます。まず X と Twitter です。公開中の TikTok、Vimeo、Facebook の動画も同じリクエストです。YouTube はダウンロードを始める前に拒否します。

curl

公開 URL を POST します。videoQuality は max、2160、1440、1080、720、480、360 のいずれかです。2 つ目の例は JSON のファイル URL を保存します。スクリプトから 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 API と同じです。この設定を貼ってクライアントを再起動してください。

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

CLI

小さな Node クライアントがリポジトリの packages/cli にあり、まだ 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 制限を使います。各サーバーインスタンスで IP あたり約 10 分に 6 回です。非公開や削除済みの投稿は失敗します。YouTube は youtube_not_supported を返します。