把 Agent 和應用接進來

一條指令把 Fastdown 接進 Codex、Claude Code 或 Cursor；同一個 key 也能給後端呼叫 REST 介面，取得解析結果、配額與直連。

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

API KEY

登入後即可建立 API key，並查看既有的金鑰。

登入

步驟 01

貼上一條指令

自動安裝 CLI、儲存金鑰，並為所有辨識到的 Agent 應用寫入 MCP 設定。

步驟 02

重新啟動 Agent

Codex、Claude Code、Cursor 都只在啟動時讀取 MCP 設定。

步驟 03

讓它下一條連結

「把這個 TikTok 連結下載到 ./downloads」——Agent 呼叫工具，檔案落到本機。

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

三個 MCP 工具

parse_video

回傳正規化後的 media[] JSON，媒體位元組不經過伺服器，又快又省。

url · prefer.watermark

download_video

解析並儲存可直接播放的檔案到 ./downloads，最後印出路徑。

url · output

quota

今天的剩餘、上限與重置時間，Agent 可以自己判斷該不該停下。

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 金鑰

所有請求都用上方卡片裡的金鑰作為 Authorization: Bearer。金鑰屬於帳號，配額與帳單都跟著帳號走。

QUOTA

只在成功時扣配額

依方案每天 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`	連結進，media[] 出。核心介面。
GET	`/api/v1/quota`	當天計數，與 Agent 看到的一致。
GET	`/api/v1/me`	使用者、方案與訂閱狀態。
GET	`/api/v1/health`	存活探測，無需驗證，適合監控。
POST	`/api/v1/billing/checkout`	回傳 Pro / Max 的 Stripe 結帳連結。

需要處理的錯誤

400 INVALID_URL401 UNAUTHORIZED422 NO_MEDIA429 RATE_LIMITED503 UPSTREAM_ERROR

想看完整的參數與錯誤碼？ 文件裡有長版本，包含結束碼與 OpenAPI 檔案。

開啟文件取得連線金鑰