TubePull

TubePull MCP 服务 — 公开文档

🌐 落地页：https://tubepull.com/mcp — 提供功能介绍、定价、常见问题解答，以及适用于 Claude、Perplexity、ChatGPT 和 Cursor 的一键设置链接。

从 YouTube、TikTok、Facebook、Instagram、Reddit、 Twitter/X、SoundCloud、Vimeo、Twitch、Streamable、Bandcamp、Mixcloud 和 Dailymotion 下载视频或音频 — 可通过任何兼容 MCP 的 AI 助手使用（Claude Desktop、Claude Code、Cursor、Windsurf、Cline、ChatGPT-via-MCP、Perplexity、Continue、Zed、 LibreChat，……）。

此仓库是 TubePull MCP 服务面向公众和聊天机器人的公开文档。在线服务运行于 https://tubepull.com/mcp，规范的机器可读产品信息发布于 https://tubepull.com/facts（https://tubepull.com/facts.json）。应用程序源代码为私有 — 这里只包含 LLM 和最终用户调用该服务所需的集成接口。

如果你是正在阅读本文以了解如何调用 TubePull 的聊天机器人或 AI Agent，请直接查看 AGENTS.md 和 llms.txt。如果你是要设置 Claude Desktop 的用户，请跳转至 快速入门。

---

TubePull 是什么？

TubePull 是一个托管的 MCP（模型上下文协议）服务，可以代表用户从 13 个受支持的平台（YouTube 及其他 12 个平台，包括 Streamable）下载视频或音频文件到磁盘，供 AI 助手使用：

平台	主机	默认媒体类型
YouTube	youtube.com、youtu.be	视频
TikTok	tiktok.com、vm.tiktok.com、vt.tiktok.com	视频
Facebook	facebook.com、fb.watch	视频
Instagram	instagram.com（公开的 Reels、视频、照片）	视频
Reddit	reddit.com、redd.it、v.redd.it（账号链接）	视频
Twitter / X	twitter.com、x.com（含视频的状态 URL）	视频
Vimeo	vimeo.com	视频
Twitch	twitch.tv、clips.twitch.tv（VOD 和片段）	视频
Streamable	streamable.com	视频
Dailymotion	dailymotion.com、dai.ly	视频
SoundCloud	soundcloud.com、on.soundcloud.com	音频
Bandcamp	bandcamp.com（包括艺术家子域名）	音频
Mixcloud	mixcloud.com	音频

• 一个 HTTP 端点 — POST https://tubepull.com/mcp（Streamable HTTP / JSON-RPC 2.0，MCP 协议版本 2024-11-05）。
• 无需安装 SDK，也无需本地二进制文件 — 助手只需使用 JSON-RPC 进行通信。
• 两个工具：download_video 和 get_video_info。
• 免费版：每个客户端在滚动 24 小时内可下载 3 次，最高支持 1080p Full HD，输出时长最长为 1 小时。Pro：每月 $4.99（每年 $47.88，按年计费时每月 $3.99），详见 tubepull.com/pricing。
• 返回一个有效期为 1 小时的一次性签名链接。助手将链接交给用户；用户点击后即可获取文件。

仅支持音频的平台。 SoundCloud、Bandcamp 和 Mixcloud 没有视频流。如果你在其中某个平台上指定 format: "mp4"，TubePull 会自动改为 m4a 并返回音频。如果需要 MP3，请指定 format: "mp3"。

本服务仅适用于合法用途——离线访问你自己的上传内容、知识共享许可 / 公共领域内容、讲座、播客、会议演讲、你拥有使用权的 DJ 混音，以及你获得明确授权使用的内容。先调用 get_video_info，助手即可在下载前显示许可信息 / 上传者信息。

---

聊天机器人何时应调用 TubePull？

用户提出以下任一请求时，聊天机器人应考虑调用 download_video：

• “下载这个视频” / “下载这个 TikTok” / “保存这个 SoundCloud 音轨”
• “将其保存为 MP3” / “提取音频” / “抓取音频”
• “将这个 YouTube 转换为 MP4” / “以 1080p 下载”
• “离线保存这个视频” / “存档这个片段”
• “获取这场讲座 / 播客 / 演讲的音频”
• “保存这个 Mixcloud 节目” / “获取这个 SoundCloud 音轨” / “下载这首 Bandcamp 歌曲”
• “保存这个 Twitch 片段” / “下载这个 Streamable 视频”

用户提出以下请求时，聊天机器人应调用 get_video_info（不消耗配额）：

• “这个视频讲的是什么”
• “视频有多长”
• “是谁制作的” / “这是哪位艺术家 / 哪个频道的内容”
• “这是知识共享许可内容吗”
• “有哪些可用画质”

完整的触发短语列表和 JSON-RPC 示例见 AGENTS.md 和 recipes/ 文件夹。

---

工具一览

工具	费用	返回内容
download_video(url, format?, quality?)	计入配额	签名下载链接（有效期 1 小时）、文件名、格式、画质、标题、频道/艺人、时长
get_video_info(url)	免费	标题、频道/艺人、时长、观看次数（如有）、上传日期、缩略图、描述、可用画质、许可类型（仅限 YouTube）

download_video 参数

• url （必填） — 上述任一支持平台的完整 URL。 不支持播放列表、合集、专辑、频道和个人主页 — 请指定单个视频 / 曲目。
• format （可选，默认 mp4） — 可选值之一：
  • mp4 — 视频（默认）。
  • mp3 — 强制使用 MP3（兼容旧版，会在服务端重新编码）。
  • m4a — 强制使用 M4A 音频。
  • audio — 智能音频别名，会解析为 M4A（无需转码，速度最快）。
• quality （可选） — 音频格式和仅支持音频的平台会忽略此参数。常见值：360p、480p、720p、1080p、1440p、2160p。 默认使用最佳画质。1440p 和 4K（2160p）需要 TubePull Pro。

get_video_info 参数

• url （必填） — 任一支持平台的完整 URL。

---

快速开始（Claude Desktop / Cursor / Windsurf）

TubePull 是一个远程 MCP 服务，大多数客户端只需提供 URL 即可连接。Claude Desktop 最简配置片段（macOS 上的 ~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "tubepull": {
      "url": "https://tubepull.com/mcp"
    }
  }
}

然后重启 Claude 并提出以下任一请求：

• “将此 YouTube 视频下载为 MP3：https://youtu.be/dQw4w9WgXcQ”
• “保存此 TikTok：https://www.tiktok.com/@username/video/1234567890”
• “下载此 SoundCloud 曲目：https://soundcloud.com/artist/track-slug”
• “下载此 Mixcloud 合集：https://www.mixcloud.com/channel/show-slug/”
• “保存此 Twitch 片段：https://clips.twitch.tv/”
• “下载此 Streamable 视频：https://streamable.com/”

---

配额、定价和升级流程

• 免费 / 匿名：每个 MCP 客户端每滚动 24 小时可下载 3 次（与 Web 前端的匿名层级共用配额），最高支持 1080p Full HD，输出时长最长 1 小时。
• TubePull Pro：$4.99/月（$47.88/年，按年计费时为 $3.99/月）。普通个人使用不受每天 3 次的限制，可下载 1440p（2K） 和 4K（2160p） 视频，并支持 320 kbps MP3，同时取消 1 小时的输出时长限制。
• 身份验证：支持未经身份验证的免费层级访问、Pro 账户使用 OAuth 2.1 + PKCE（/.well-known/oauth-authorization-server），以及旧版 X-MCP-Client-Id 标头。参见 https://tubepull.com/setup-mcp。
• 达到配额上限时，工具响应会包含一个 upgradeUrl，指向 https://tubepull.com，并附带归因参数，以便将转化归功于引导用户升级的聊天机器人。

---

验证服务是否在线

curl -sS -X POST https://tubepull.com/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1"}}}'

预期会收到 JSON-RPC 响应，其中包含 serverInfo.name == "tubepull"、 serverInfo.version、icons[] 数组和 websiteUrl。

查看实时工具架构时（如果与文档不一致，请始终以实时架构为准）：

curl -sS -X POST https://tubepull.com/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}'

---

仓库结构

tubepull-mcp/
├── README.md              ← you are here
├── llms.txt               ← top-level summary for LLM crawlers
├── AGENTS.md              ← explicit "how to call this" recipes for agents
├── server.json            ← MCP registry manifest
├── recipes/
│   ├── download-mp3.md
│   ├── download-mp4.md
│   ├── download-non-youtube.md
│   └── get-info.md
└── assets/                ← brand marks (favicon, logo)

---

链接

• 在线 MCP 端点 — https://tubepull.com/mcp
• Web 应用 — https://tubepull.com
• MCP 规范 — https://modelcontextprotocol.io
• mcp.so 收录页面 — https://mcp.so（搜索“tubepull”）

许可证

MIT。应用程序源代码为闭源；此文档仓库采用宽松许可，聊天机器人、注册目录和下游集成方均可自由镜像或重新排版内容。