エージェントとアプリをつなぐ

コマンド 1 本で Fastdown を Codex / Claude Code / Cursor に接続。同じキーをバックエンドで使えば、解析結果・クォータ・メディア直リンクを REST で取得できます。

MCP · stdio + HTTP
CLI · macOS / Linux / Windows
REST · /api/v1

API KEY

ログインすると API キーを作成し、既存のキーを確認できます。

ログイン

STEP 01

コマンドを 1 本貼る

CLI を導入し、キーを保存し、見つかったエージェントアプリすべてに MCP 設定を書き込みます。

STEP 02

エージェントを再起動

Codex、Claude Code、Cursor は起動時にしか MCP 設定を読みません。

STEP 03

リンクを渡す

「この TikTok リンクを ./downloads に保存して」——エージェントがツールを呼び、ファイルがローカルに残ります。

mcp 接続

$curl -fsSL "https://fastdown.pro/mcp?key=$FASTDOWN_KEY" | sh

上のカードのキーを FASTDOWN_KEY に入れてください。スクリプトは CLI を導入し、fast-download setup agent --auto を実行し、auth login --key でキーを保存します。

対応クライアント

CodexClaude CodeCursorVS CodeOpenCodeGemini CLIWindsurf

3 つの MCP ツール

parse_video

正規化した media[] JSON を返します。メディア本体は上流 CDN から直接取得するため高速で低コストです。

url · prefer.watermark

download_video

再生できる最適なファイルを解析して ./downloads に保存し、パスを出力します。

url · output

quota

本日の残数・上限・リセット時刻。エージェントが使い切る前に止まれます。

no arguments

手動で設定する

{
  "mcpServers": {
    "fastdown": {
      "command": "fast-download",
      "args": ["mcp", "--stdio"]
    }
  }
}

CLI でスクリプト化する

ターミナルMCP 不要

fast-download auth login
fast-download parse "<share url>" --json
fast-download download "<share url>" --output ./downloads
fast-download quota --json

AUTH

Bearer キー 1 本

すべての呼び出しは上のカードのキーを Authorization: Bearer で渡します。キーはアカウント単位なので、クォータも請求もアカウントに紐づきます。

QUOTA

成功時のみ消費

プランごとに 1 日 50 / 1,000 / 3,000 回、UTC 00:00 にリセット。解析失敗では消費せず、429 が当日分の終わりです。

リクエストPOST /api/v1/parse

curl -X POST https://fastdown.pro/api/v1/parse \
  -H "authorization: Bearer $FASTDOWN_KEY" \
  -H "content-type: application/json" \
  -d '{"url":"https://www.tiktok.com/@aespa_official/video/7614804615174917396"}'

レスポンス 200application/json

{
  "ok": true,
  "request_id": "req_8f2c41",
  "data": {
    "platform": "tiktok",
    "media": [{
      "type": "video",
      "url": "https://cdn.example/video.mp4",
      "watermark": false,
      "quality": "hd"
    }],
    "quota": { "used": 12, "limit": 1000 }
  }
}

エンドポイント

メソッド	パス	役割
POST	`/api/v1/parse`	URL を渡すと media[] が返る中心のエンドポイント。
GET	`/api/v1/quota`	本日のカウンタ。エージェントが見る値と同じ。
GET	`/api/v1/me`	ユーザー、プラン、サブスクリプションの状態。
GET	`/api/v1/health`	死活監視用。認証不要で監視に使えます。
POST	`/api/v1/billing/checkout`	Pro / Max の Stripe Checkout URL を返します。

処理すべきエラー

400 INVALID_URL401 UNAUTHORIZED422 NO_MEDIA429 RATE_LIMITED503 UPSTREAM_ERROR

すべてのフラグとエラーコードが必要ですか？ ドキュメントに詳細版があり、終了コードと OpenAPI ファイルも含まれます。

ドキュメントを開く接続キーを取得