文档

一条命令，把解析能力交给 Agent

从安装、登录到 Agent 调用，一页看完所有命令，并附一次真实解析的响应。

一条命令接入
Google OAuth 登录
每日 50 次免费

安装

把整段内容粘贴给 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 应用如果本来开着，装完重启一次；然后粘贴一条公开分享链接，让它去取视频。

登录与配额

网页端登录与 CLI 共用同一个账号。在服务器或没有浏览器的机器上，改用邮箱验证码或连接密钥。

quota

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

配额只统计成功解析的次数，与网页端在同一时间点重置。

命令速查

一个二进制搞定登录、配额、解析、下载和 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 服务

解析示例

一次解析返回下面这个归一化结构：平台、标题、作者、媒体直链与剩余配额。媒体文件不经过我们的服务器。

输入

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 }
  }
}

MCP 工具

只有三个工具，覆盖全部能力。Agent 按意图自选，结果以结构化内容返回。

parse_video

返回归一化的 media[] JSON，媒体字节不经过服务器，又快又省。

url · media_type

download_video

解析并保存可直接播放的文件到 ./downloads，最后打印路径。

url · output · name

quota

今天的剩余、上限与重置时间，Agent 可以自己判断该不该停下。

—

安装脚本会自动注册这些工具。没走脚本的话，运行 fast-download setup agent --auto，或从「接入」页复制 stdio 配置。

一条命令，把解析能力 交给 Agent

parse_video

download_video

quota

一条命令，把解析能力交给 Agent