FetchPan
English

FetchPan 给 AI 智能体用。

让你的智能体从文件站和国内网盘下载文件。一个令牌,用的就是你 FetchPan 账号的免费次数和流量。

FetchPan MCP 服务是什么?

FetchPan 是一个下载服务,支持文件站(Rapidgator、Katfile、Nitroflare、Turbobit 等)和国内网盘(百度网盘、夸克、PikPak 等)。它的 MCP 服务让 AI 智能体可以直接使用:智能体发一个链接,就能拿回一个直接下载地址。

任何支持远程服务器(Streamable HTTP)和 Bearer 令牌的 MCP 客户端都能用。下面有 Codex、WorkBuddy、Claude Code 的分步教程。同一个令牌也可以用在 REST API 上。

https://fetchpan.com/mcp

1. 创建 API 令牌

令牌让程序以你的账号身份操作。请像密码一样保管:拿到它的人可以使用你的免费次数和流量余额。

加载中…

2. 连接你的智能体

选你用的工具,把 YOUR_TOKEN 换成第 1 步的令牌(刚创建完时会自动填好)。

添加到 ~/.codex/config.toml

# 1) in ~/.zshrc or ~/.bashrc, then restart the terminal:
export FETCHPAN_TOKEN="YOUR_TOKEN"

# 2) in ~/.codex/config.toml:
[mcp_servers.fetchpan]
url = "https://fetchpan.com/mcp"
bearer_token_env_var = "FETCHPAN_TOKEN"

然后对智能体说:“列出 FetchPan 的工具。”如果它说出 download、check_link、get_account,就连接成功了。

安装教程

先在第 1 步创建令牌,再把 YOUR_TOKEN 换成它。每个教程大约两分钟。

Codex(OpenAI Codex 命令行、IDE 插件和应用)

  1. 在上面创建令牌并复制。
  2. 把令牌写进你的终端配置文件(~/.zshrc 或 ~/.bashrc),变量名为 FETCHPAN_TOKEN,然后重启终端。
  3. 打开 ~/.codex/config.toml(没有就新建),加入下面的 [mcp_servers.fetchpan] 配置。如果只想在某个项目里用,把它放进已信任项目里的 .codex/config.toml。
  4. 启动 Codex,输入 /mcp,应该能看到 fetchpan。在普通终端里运行 codex mcp list 也能看到。
  5. 对它说:“用 FetchPan 检查这个链接:……”。

添加到 ~/.codex/config.toml

# 1) in ~/.zshrc or ~/.bashrc, then restart the terminal:
export FETCHPAN_TOKEN="YOUR_TOKEN"

# 2) in ~/.codex/config.toml:
[mcp_servers.fetchpan]
url = "https://fetchpan.com/mcp"
bearer_token_env_var = "FETCHPAN_TOKEN"

如果你是从应用图标而不是终端启动 Codex,它可能读不到终端里的环境变量。这时把 bearer_token_env_var 那一行换成:http_headers = { Authorization = "Bearer YOUR_TOKEN" }(令牌会明文保存在文件里,请保管好这个文件)。

WorkBuddy

  1. 在上面创建令牌并复制。
  2. 在 WorkBuddy 里打开 Connectors(连接器),选 Custom connector(自定义连接器),点右上角的 Configure MCP(配置 MCP),会打开文件 ~/.workbuddy/mcp.json。不同版本的菜单名称可能略有不同。
  3. 把下面的 fetchpan 配置加到 mcpServers 里,原来已有的条目保留不动,然后点保存。
  4. 打开 My MCP(我的 MCP),把 fetchpan 开关打开。如果 WorkBuddy 问你是否信任这个服务,点确认。
  5. 新建一个任务,说:“列出 FetchPan 的工具。”应该能看到 download、check_link、get_account。

添加到 ~/.workbuddy/mcp.json

{
  "mcpServers": {
    "fetchpan": {
      "type": "http",
      "url": "https://fetchpan.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

Claude Code

  1. 在上面创建令牌并复制。
  2. 在终端里运行下面的命令。
  3. 运行 claude mcp list,或在 Claude Code 里输入 /mcp,fetchpan 应显示为已连接。
  4. 对它说:“用 FetchPan 下载这个链接:……”。
claude mcp add --transport http fetchpan https://fetchpan.com/mcp \
  --header "Authorization: Bearer YOUR_TOKEN"

智能体能做什么

共 9 个工具。通常智能体只需要用 download。

工具作用消耗
download给它一个链接,它会等文件准备好并返回下载地址。如果等待时间内没准备好,会返回任务 ID 让你继续查询。1 次免费,或流量(极速)
check_link这个网站是否支持、现在是否可用?不消耗
list_supported_sites全部支持的网站及实时状态。不消耗
start_download开始一个任务但不等待,返回任务 ID。不消耗
get_job任务状态,以及免费或极速下载分别要花多少。不消耗
get_download_link获取已完成任务的下载地址(免费或极速)。1 次免费,或流量(极速)
get_account你的邮箱、流量余额、每天免费次数和最近的下载。不消耗
list_packages可以购买的流量包。不消耗
create_payment_link生成流量包的付款页,交给你来付款。只有人可以付款。不消耗

一次下载是怎么进行的

  1. 智能体用你给它的链接调用 download。
  2. FetchPan 打开链接,返回一个 fetchpan.com 上的地址。12 小时内有效,支持断点续传(HTTP Range)。
  3. 智能体从这个地址取回文件(curl、aria2、浏览器都行)。
  4. 免费下载:每天几个文件,最大 2 GB,限速。极速下载用你余额里的流量。具体数字见“免费与极速”页面。

免费与极速 →

想直接用 HTTP?

同一个令牌也可以用在网站的 REST API 上。基础地址:https://fetchpan.com/v1/web,请求头 Authorization: Bearer YOUR_TOKEN。

POST /jobs开始一个任务。请求体:{"url": "…", "password": "…"}
GET /jobs/{id}任务状态和可选方案。
POST /jobs/{id}/download获取地址。请求体:{"tier": "free"} 或 {"tier": "fast"}
GET /session账号、余额和免费额度。
GET /account余额、最近的订单和下载。
GET /sites, GET /hosts支持的网站及实时状态。
GET /packages, POST /orders流量包;生成付款页。

需要知道的事

  • 令牌就是你本人。如果泄露,请在上面删除,它会立刻失效。
  • 限制和网站一致:每个账号每小时最多 10 个新链接,每天的免费次数见“免费与极速”页,免费文件最大 2 GB。
  • 错误会返回一个代码和一句话,例如 sign_in_required、daily_limit、too_many_links、not_ready、insufficient_balance。免费额度的错误会告诉你多久后可以重试。
  • 请只下载你有权下载的文件,详见“版权与举报”。我们不托管文件,只打开你给出的链接。

常见问题

FetchPan MCP 服务是什么?

一个 Model Context Protocol 服务,地址是 https://fetchpan.com/mcp。它给 AI 智能体提供 9 个工具:检查链接、从支持的文件站或国内网盘取回文件、返回下载地址。

怎么把 FetchPan 加到 Codex?

在本页创建令牌,把它导出为环境变量 FETCHPAN_TOKEN,然后在 ~/.codex/config.toml 里加入 [mcp_servers.fetchpan],写上 url = "https://fetchpan.com/mcp" 和 bearer_token_env_var = "FETCHPAN_TOKEN"。再在 Codex 里输入 /mcp 检查。

怎么把 FetchPan 加到 WorkBuddy?

在 WorkBuddy 里打开 Connectors、Custom connector、Configure MCP,在 mcp.json 里加一个 fetchpan 条目:type 为 http,地址 https://fetchpan.com/mcp,请求头 Authorization 为 "Bearer YOUR_TOKEN"。保存后在 My MCP 里打开开关。

免费吗?

创建令牌是免费的。下载用的是你账号每天的免费次数(几个文件,最大 2 GB,限速)或你买的流量。智能体在花费之前会先告诉你这次下载会用哪一种。

FetchPan 会存放文件吗?

不会。它打开你给的链接,返回 fetchpan.com 上的一个临时地址,12 小时内有效。请只下载你有权下载的文件。

我的令牌安全吗?

我们只保存它的指纹,所以只显示一次。拿到令牌的人可以使用你的免费次数和流量,请保密。你可以在本页删除它,它会立刻失效。

能在 ChatGPT 或 claude.ai 里作为连接器添加吗?

暂时不行。那些连接器需要 OAuth 登录,而 FetchPan 用的是 Bearer 令牌。请使用 Codex、WorkBuddy、Claude Code,或任何可以设置 Authorization 请求头的客户端。

有疑问或缺少功能?

请到反馈页告诉我们你的智能体需要什么。每条留言我们都会看。 意见反馈 →