把 Agent 和应用接进来

一条命令把 Fastdown 接进 Codex、Claude Code 或 Cursor；同一个 key 也能给后端调 REST 接口，拿解析结果、配额和直链。

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

API KEY

登录后即可创建 API key，并查看已有的 key。

步骤 01

贴一条命令

自动安装 CLI、保存 key，并给所有识别到的 Agent 应用写入 MCP 配置。

步骤 02

重启 Agent

Codex、Claude Code、Cursor 都只在启动时读取 MCP 配置。

步骤 03

让它下一条链接

「把这个 TikTok 链接下到 ./downloads」——Agent 调用工具，文件落到本地。

mcp 连接

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

先把上面卡片里的 key 设进 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 key

所有请求都用上面卡片里的 key 作 Authorization: Bearer。key 属于账号，配额和账单都跟着账号走。

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 文件。

打开文档获取连接 key