Fastdown

一条公开分享链接 → 无水印直链。 网页粘贴即用，CLI 一行装好，REST API 一个 POST 接入，MCP 让 Codex / Claude Code / Cursor 直接会下载。

Fastdown turns a public short-video share link into a no-watermark media URL. Use it in the browser, from the fast-download CLI, through the REST API, or as an MCP tool for your agent.

只处理公开分享链接 · 与各内容平台无隶属关系 · 请确保你对下载内容拥有合法权利

项目叫什么，在哪用

这个项目叫 Fastdown，官网就是入口：https://fastdown.pro —— 打开网页、粘贴链接、拿到文件，不需要安装任何东西。

同一个服务有几种叫法，指的都是它：

本仓库是「用法仓库」，不是服务端源码。 这里放的是 CLI、MCP、REST API 的调用示例与文档（examples/、docs/），解析服务本身的实现不在本仓库内。

这是什么

短视频平台只给你「在 App 里看」，不给你「把文件拿走」。想把一条公开视频存下来做素材、做备份、做二次创作，通常得装客户端、看广告、或者忍受带水印的低码率版本。

Fastdown 把这条链路做成了一个接口：你只负责贴链接，平台识别、清晰度选择、去水印、直链签发都在云端完成，几秒后返回一条可下载的地址。

和「下载器客户端」的区别：Fastdown 是解析服务，不是伪装成播放器的下载器。它不代理视频流量、不落盘源文件，只把平台已经公开发出的媒体地址解析出来交给你 —— 所以它能在网页、CLI、API、Agent 四种形态里用同一套配额。

四种用法，按场景选

四种形态共用同一个账号、同一份每日配额。网页上登录一次，CLI 用同一个邮箱登录，配额就是同一份。

三步完成一次解析

解析通常 几秒内完成（中位约 3 秒）。网页版免费账号每天 50 次，登录即得，不需要绑卡。

支持平台

只处理公开内容：私密、已删除、需要登录或年龄验证的帖子会返回 NOT_FOUND，不会扣配额。

网页版

不想装东西就用网页：贴链接 → 解析 → 点下载。手机浏览器同样可用，登录用 Google 或邮箱验证码，不用记密码。

截图中邮箱已打码，配额与套餐为演示数据。

CLI / MCP

安装（一条命令，自动识别系统与架构）：

curl -fsSL https://fastdown.pro/cli | sh -s -- --agent auto

登录一次，之后所有命令复用这份会话：

fast-download auth login          # 打开浏览器完成 Google 登录
fast-download auth status --json  # 查看当前账号与今日配额

解析与下载：

# 只看结果，不落盘（返回标题、作者、直链、配额）
fast-download parse "https://v.douyin.com/xxxx/" --json

# 解析并保存到本地，默认 ./downloads
fast-download download "https://v.douyin.com/xxxx/" --output ./downloads

# 只要音频 / 只要图片（图文笔记）
fast-download download "<link>" --media-type audio
fast-download download "<link>" --media-type image

配额与订阅：

fast-download quota --json
fast-download billing upgrade --plan pro
fast-download billing portal

把 MCP 接进本机所有支持的 Agent：

fast-download setup agent --auto          # 写入所有检测到的 Agent
fast-download setup agent --print         # 只打印 JSON 配置，不动文件

写入是追加式的：已有的 MCP server 和无关配置不会被覆盖，已存在的 fast-download 条目会原样保留。装完重启 Agent 应用，然后直接说「把这个链接的视频下下来」。

MCP 服务端暴露三个工具：

细节与排查见 docs/mcp.md、docs/cli.md。

REST API

Base URL：https://fastdown.pro/api，所有受保护接口用 Bearer 鉴权：

Authorization: Bearer <session_token 或 api_key>

• fd_sess_... —— 登录会话，网页 / CLI 用；
• fd_live_... —— 长期 API Key，在 https://fastdown.pro/integrations 创建，给服务端、CI、常驻 Agent 用，最多 3 个，只在创建时显示一次。

curl -sS https://fastdown.pro/api/v1/parse \
  -H "Authorization: Bearer $FASTDOWN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.tiktok.com/@yeuphimzz/video/7237370304337628442"}'

返回（有删减）：

{
  "ok": true,
  "data": {
    "platform": "tiktok",
    "title": "Shin godzilla #movie",
    "author": "yeuphimzz",
    "media": [
      { "type": "video", "url": "https://...", "watermark": false }
    ],
    "cover_url": "https://...",
    "duration": 88,
    "warnings": [],
    "quota": { "plan_id": "free", "daily_limit": 50, "used": 3, "remaining": 47, "reset_at": "2026-11-13T00:00:00.000Z" },
    "elapsed_ms": 1299
  }
}

media 是候选列表，按推荐顺序排列，media[0] 就是最优选择：通常是带音轨的最高画质混流；请求音轨或内容本身没有视频时会附带一条 type: "audio"；图文笔记返回全部图片。quality、ext 是可选字段，缺省按 mp4 处理 —— 客户端的正确写法是「先看 type，ext 缺省补 mp4」，不要假设字段一定存在。

核心端点：

常见的解析错误（完整表见 docs/api.md）：

上游失败与无媒体结果不扣配额；error.retryable 会告诉你值不值得重试。

机器可读的接口描述在 https://fastdown.pro/openapi.json，本仓库也存了一份 openapi.json 方便导入 Postman / Insomnia。

代码示例

examples/
├── curl/
│   ├── parse.sh        # 最小解析请求
│   ├── download.sh     # 解析 + 下载到本地（jq）
│   └── quota.sh        # 查配额
├── node/
│   ├── parse.mjs       # Node 18+，零依赖 fetch
│   └── download.mjs    # 解析 + 流式落盘
├── python/
│   ├── parse.py        # 仅用标准库 urllib
│   └── download.py     # 解析 + 下载，无第三方依赖
├── go/
│   ├── go.mod          # 独立小模块，方便直接 go run
│   └── main.go         # net/http，单文件
└── mcp/
    ├── codex.toml      # Codex 配置片段
    ├── claude.json     # Claude Code / Cursor / VS Code 通用片段
    └── README.md       # 各客户端接入说明

所有示例只读一个环境变量：

export FASTDOWN_API_KEY="fd_live_xxxxxxxx"

然后：

bash examples/curl/parse.sh "https://v.douyin.com/xxxx/"
node examples/node/parse.mjs "https://v.douyin.com/xxxx/"
python3 examples/python/download.py "https://v.douyin.com/xxxx/" -o ./downloads
cd examples/go && go run . -o ../../downloads "https://v.douyin.com/xxxx/"

示例代码用 MIT 许可，可以直接粘进你的项目里改。

计费与配额

三条规则，写死在计费里：

1. 解析失败不扣配额 —— 上游超时、链接失效、没有媒体，都不算一次；
2. 同一份配额跨端共享 —— 网页、CLI、API、Agent 用的是同一个账号的同一份余量；
3. 配额按 UTC 自然日重置 —— 账户页会显示准确的余量与下次重置时间（北京时间每天 08:00）。

订阅走 Stripe Checkout，卡与 Apple Pay 都支持，随时在 Billing Portal 取消。

项目状态

服务是常年在线的商业服务，本仓库随版本更新文档与示例。若你发现文档与线上行为不一致，欢迎开 issue 指出具体接口与时间。

常见问题

Fastdown 是一个解析服务：你给它一条公开的短视频分享链接，它返回这条内容的无水印媒体直链与元数据。它不做客户端下载器那套「伪装播放器 + 本地解密」，也不代理视频流量 —— 所以同一套能力可以同时以网页、CLI、REST API、MCP