文件

一條指令,把解析能力 交給 Agent

從安裝、登入到 Agent 呼叫,一頁看完所有指令,並附一次真實解析的回應。

指令速查
  • 一條指令接入
  • Google OAuth 登入
  • 每日 50 次免費
01

安裝

把整段內容貼給 Codex、Claude Code、Open Code,或任何能執行終端指令的 Agent。它會裝上 CLI、寫入連線金鑰,並把 MCP 服務註冊到本機偵測到的每個 Agent。

貼到 Codex / Claude Code / Open Code
Agent: install Fastdown in this environment and connect its MCP tools.
You can run this from Codex, Claude Code, Open Code, or another terminal-based coding agent.
Replace <connect-key> with the key from https://fastdown.pro/account, then run the command below.
Restart the agent app if it was already open, then use `download_video` for public share links.

curl -fsSL 'https://fastdown.pro/mcp?key=<connect-key>' | sh

只裝 CLI,不接 Agent

bash
curl -fsSL https://fastdown.pro/cli | sh -s -- --agent auto
範例程式碼 · GitHub

Agent 應用程式如果本來開著,裝完重啟一次;然後貼上一條公開分享連結,讓它去取影片。

02

登入與配額

網頁端登入與 CLI 共用同一個帳號。在伺服器或沒有瀏覽器的機器上,改用電子郵件驗證碼或連線金鑰。

quota
$ fast-download quota --json
{
  "quota": { "plan_id": "free", "used": 12, "daily_limit": 50, "remaining": 38 }
}

配額只計算成功解析的次數,與網頁端在同一時間點重置。

03

指令速查

一個二進位搞定登入、配額、解析、下載和 MCP 服務。所有指令都支援 --json。

fast-download auth login登入
fast-download quota --json查看配額
fast-download parse "<share link>" --json解析公開連結
fast-download download "<share link>" --output ./downloads解析並下載到本機
fast-download setup agent --auto寫入 Agent 設定
fast-download mcp --stdio啟動 MCP 服務
04

解析範例

一次解析回傳下面這個正規化結構:平台、標題、作者、媒體直連與剩餘配額。媒體檔案不經過我們的伺服器。

輸入
fast-download parse \
  "https://www.tiktok.com/@aespa_official/video/7614804615174917396" \
  --json
結果
平台tiktok
結果影片 + 音訊直連
儲存只記解析日誌,不轉存媒體
結束碼配額用盡回傳結束碼 5
正規化回應
{
  "ok": true,
  "data": {
    "platform": "tiktok",
    "title": "@aespa_official video",
    "author": "aespa_official",
    "media": [
      { "type": "video", "url": "https://...", "watermark": false, "quality": "hd" },
      { "type": "audio", "url": "https://...", "watermark": false }
    ],
    "quota": { "plan_id": "free", "used": 12, "daily_limit": 50, "remaining": 38 }
  }
}
05

MCP 工具

只有三個工具,涵蓋全部能力。Agent 依意圖自選,結果以結構化內容回傳。

parse_video

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

url · media_type

download_video

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

url · output · name

quota

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

—

安裝腳本會自動註冊這些工具。沒走腳本的話,執行 fast-download setup agent --auto,或從「接入」頁複製 stdio 設定。