下载兔 DownBunny MCP

适用方式

DownBunny MCP 的地址是本站 /mcp。它只认 Authorization 头里的 API Key，不使用网页登录。页面没有广告。积分、平台范围和免费重下规则与网页相同。

常见公开短视频通常 3–5 秒完成下载。大文件、YouTube 验证和平台限流会更久，这 3–5 秒不是所有作品的完成时间。

创建密钥

打开个人主页的 API Key，填写名称后创建。完整密钥只出现一次，服务器只保存摘要。每账号最多 5 把有效密钥，停用后立即失效。

前往个人主页

MCP 配置

把密钥换成个人主页创建的那一把，写入 Cursor 或 Claude 的 mcp.json。客户端连接本站 /mcp。

{
  "mcpServers": {
    "downbunny": {
      "type": "http",
      "url": "http://127.0.0.1:3210/mcp",
      "headers": {
        "Authorization": "Bearer dbk_你的密钥"
      }
    }
  }
}

交给 Agent

配置写进 mcp.json 并连上之后，把下面这段发给 Agent。这段不含密钥。

使用已经连上的 DownBunny MCP，只调用它的工具。

先调用 downbunny_account，读取余额和各平台消耗。

用户给出一条公开视频链接后，调用 downbunny_resolve，参数是 {"url":"这条链接"}。一次只传一条。

可以把标题、作者、平台、作品页、封面、时长和宽高告诉用户。

文件只从返回的 downloadUrl 下载。请求这个地址时带上同一把密钥，并跟随重定向。downloadUrl 属于下载兔。

平台原始文件地址不会返回。不要输出、转发或猜测，也不要向用户索要。

各平台消耗以 downbunny_account 为准：抖音、B站 1 分，TikTok、Instagram、X 各 2 分，小红书 4 分，YouTube 7 分，视频号 10 分。除视频号外，解析不扣积分；开始传输时预扣，传完结算，中断退回。视频号的分享链接不是文件地址。解析成功并取得 24 小时下载资格时扣 10 分，解析失败不扣；资格生效后，下载中断不退回。同一条视频在 24 小时内再次下载，或视频号再次解析，不再另扣。购买的积分不用也不会消失，可以和当天赠送叠加。扣积分时先用当天赠送。

直接调用

脚本仍可直接请求 HTTP 接口。基址使用站点配置里的 DOWNBUNNY_APP_URL。本地是 http://127.0.0.1:3210。请求必须带 Bearer 密钥。

curl -sS http://127.0.0.1:3210/api/v1/me \
  -H "Authorization: Bearer dbk_你的密钥"

curl -sS http://127.0.0.1:3210/api/v1/resolve \
  -H "Authorization: Bearer dbk_你的密钥" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.douyin.com/video/作品ID"}'

curl -L "返回的 downloadUrl" \
  -H "Authorization: Bearer dbk_你的密钥" \
  -o video.mp4

积分规则

免费注册后，每个上海自然日赠送 10 积分。当天没用完的部分会在次日清掉，不并入永久积分。注册赠送和购买的积分不用也不会消失，可以和当天赠送叠加。扣积分时先用当天赠送。

抖音、B站、TikTok、Instagram、X、小红书和 YouTube 解析不扣积分，首次完整下载按平台扣 1–7 分，传输开始预扣，中断退回。视频号的分享链接不是文件地址，解析成功并取得 24 小时下载资格时扣 10 分，解析失败不扣；资格生效后下载中断不退回。同一视频 24 小时内重复下载不再扣积分。单文件上限 512 MiB。下载地址保存 24 小时，服务重启后需要重新解析。

视频号解析需要已验证邮箱，并且账户有足够积分或 24 小时内已有下载资格。请只提交你有权下载的公开作品。

返回与错误

解析成功时返回 video 和 credits。video 可以包含标题、作者、平台、作品页、封面、时长和尺寸这些公开信息，以及 downloadCost、downloadUrl 和 expiresAt。downloadUrl 只能是下载兔自己的地址，不返回平台原始下载地址。失败时返回 error 和 code，常见为 API_KEY_REQUIRED、API_KEY_INVALID、INVALID_LINK、UNSUPPORTED_URL、INSUFFICIENT_CREDITS、MAINTENANCE、RATE_LIMITED。

仓库内的配置说明见 docs/agent-api.md。密钥不是环境变量，不要写进 .env.local。