QuantumProxies — Residential, Mobile & Datacenter Proxy MCP Server

QuantumProxies MCP 服务

将 QuantumProxies 接入 Claude、Cursor 和任何 MCP 客户端。为 AI Agent 提供实时网络访问能力——通过具备真实浏览器 TLS 指纹的住宅代理进行抓取、搜索、映射和爬取， 让会屏蔽普通机器人的网页也能正常返回。它还会将你有效套餐中的各种类型的原始代理端点（住宅、移动、数据中心、ISP、IPv6） 提供给 Agent，可直接接入任何 HTTP 客户端。

它会使用你自己的 qp_live_ 密钥调用 QuantumProxies 公开的 Scraper API， 因此无需内部密钥，且可在本地运行。

工具

工具	功能说明
scrape	抓取一个 URL → Markdown/HTML/文本，包括 PDF/Office 文档。支持多格式输出、绝对链接收集、JSON-LD 元数据、结构化 CSS 提取、AI 提示词/JSON 架构提取，以及 mode: summary。
unlock	Web Unlocker：通过住宅网络出口重放任意 HTTP 请求（方法、标头、正文），使用真实浏览器 TLS 指纹；在新 IP 上重试，并将被拦截的 GET 升级为真实浏览器请求。返回原始响应（状态、标头、正文）；仍被拦截的页面会带有标记（blocked、blockClass、vendor），绝不会悄然返回 200。不会解决交互式验证码（blockClass: "captcha"）。
seo_audit	以无 JS 机器人和完整渲染两种方式抓取 URL，返回两种 SEO 视图及其差异（仅 JS 中的内容、变更的标题/描述、缺失的 canonical），以及面向机器人的元数据（robots、OG、JSON-LD）。
ai_visibility	ChatGPT、Claude、Perplexity、Google AI Overview 和 Bing Copilot 能否读取并引用某个页面？页面审计（robots.txt 中的 24 个 AI 爬虫、Content-Signal、以 GPTBot 身份抓取、noindex/nosnippet/noai、无需 JS 的文本、JSON-LD 实体、符合答案形式的文案、带时效信息的日期、作者、来源）按支柱评分，并提供拦截因素、证据和修复建议；还可选择开启引用面板，向各引擎提问并报告引用/提及/排名、声量占比，以及在您缺席的问题中胜出的是谁。
search	结构化 Google/Bing/DuckDuckGo 搜索结果。将 render: true 设为启用 Google AI Overview、PAA、Knowledge Graph 及其他 JS 增强内容。
search_and_read	SERP → 抓取排名靠前的页面 → 提供带编号、可直接引用的来源，以及适用于 AI 提示词、受 token 数量限制的上下文字符串。
search_bulk / search_bulk_status	异步多页分页，合并自然搜索结果及第一页的 AI/零点击增强内容。
map	快速发现 URL（站点地图 + 首页链接），不进行完整爬取。默认采用精简输出：最多返回 limit 个 URL（100），并附带全站 total 和各分区的 summary；使用 group_by: path 获取路径树。
crawl / crawl_status	异步 BFS 网站爬取 → 每个页面生成 Markdown；可轮询查看进度。
batch / batch_status	异步抓取多个 URL；使用 mode: summary 仅获取元数据条目。通过 since 游标增量轮询；仅在使用 include_content 时返回页面内容。
create_dataset / dataset_status	由提示词驱动的结构化数据集收集，并设置预算和行数限制。
list_collectors / run_collector / collector_run_status	现成的 Collectors：使用语义输入（关键词 + 地点、地点 ID、产品 ID、域名等）运行有版本标记的抓取器，而非使用 URL — Google Maps 地点、地点评价、Google Jobs/News/Shopping、产品优惠、酒店、本地商家潜在客户、网站联系人、公司简介。按交付的行数计费；异步运行通过 run_id 轮询，行数据可导出为 CSV。
list_proxies	列出所有类型的代理服务 — Residential Basic/Premium/Private、Mobile、Mobile V2、Datacenter、ISP、IPv6 — 并显示剩余带宽、到期时间及用于生成代理的 orderId。
generate_proxies	从任何有效套餐生成可直接使用的代理字符串（含凭据）：支持地理位置定向（国家/州/城市/ISP/ASN）、轮换或粘性会话、HTTP 或 SOCKS5，以及多种输出格式。
proxy_locations	按套餐类型列出有效的地理位置定向值：国家、州、城市、ASN，或包含 ISP 代码的完整位置树。
whitelist_ip	管理支持此功能的套餐的 IP 身份验证白名单（添加/列出/移除），包括 Mobile V2 IP 身份验证代理列表。
report	在 Agent 内向团队发送反馈：错误（结果错误/为空、发生错误、页面被拦截）、缺失的功能或 Collector，以及问题。无需 API 密钥即可使用。

快速开始

无需安装 — npx 会按需获取 quantumproxies-mcp（Node.js 18+）。

Claude Code（一条命令）：

claude mcp add quantumproxies \
  -e QUANTUMPROXIES_API_KEY=qp_live_your_key_here \
  -- npx -y quantumproxies-mcp

Claude Desktop / Cursor / 任意 MCP 客户端（claude_desktop_config.json、.cursor/mcp.json 或 .mcp.json）：

{
  "mcpServers": {
    "quantumproxies": {
      "command": "npx",
      "args": ["-y", "quantumproxies-mcp"],
      "env": { "QUANTUMPROXIES_API_KEY": "qp_live_your_key_here" }
    }
  }
}

托管端点（远程 MCP）

同一服务也以托管的 Streamable HTTP 端点运行，适用于偏好使用 URL 而非本地软件包的客户端：

https://api.quantumproxies.io/mcp

使用 OAuth 连接（无需复制密钥）

该端点支持 MCP 授权规范（OAuth 2.1）。在支持此规范的客户端中，将上面的 URL 添加为远程服务即可，无需其他操作：

1. 客户端会打开 QuantumProxies.io 登录页面。
2. 登录（或创建免费账户），然后点击 Allow access。
3. 客户端即已连接。名为 MCP · <client> 的密钥会显示在控制面板的 API 密钥页面中；删除该密钥即可断开客户端。

其底层机制包括：授权服务器元数据位于 https://app.quantumproxies.io/.well-known/oauth-authorization-server， 受保护资源元数据位于 https://api.quantumproxies.io/.well-known/oauth-protected-resource/mcp， 动态客户端注册（RFC 7591）和客户端 ID 元数据文档、 必须使用 PKCE（S256）、有效期为 1 小时且会轮换的访问令牌，以及绑定到此端点的令牌（RFC 8707）。使用量会像使用任何密钥一样从余额中扣除。

或发送 API 密钥

支持持有者令牌的客户端可以跳过 OAuth：每次请求都会通过 Authorization 标头（或 X-Api-Key）发送密钥，服务器端不会存储任何内容。

curl -X POST https://api.quantumproxies.io/mcp \
  -H "Authorization: Bearer qp_live_your_key_here" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

如果请求既不包含令牌也不包含密钥，则会返回带有 WWW-Authenticate 标头的 401，该标头指向上面的元数据：这会促使支持 OAuth 的客户端开始登录。

自行托管该端点时，此软件包会使用第二个二进制文件。设置 QUANTUMPROXIES_API_KEY 后，它会为未发送凭据的调用方提供该账户的服务：

QUANTUMPROXIES_API_KEY=qp_live_… PORT=9310 npx -y quantumproxies-mcp-remote

从源代码运行（开发）

npm install
npm run build

然后让客户端使用本地构建版本，而不是 npx：

{
  "mcpServers": {
    "quantumproxies": {
      "command": "node",
      "args": ["/absolute/path/to/scraper-mcp/dist/index.js"],
      "env": {
        "QUANTUMPROXIES_API_KEY": "qp_live_your_key_here"
      }
    }
  }
}

环境变量

变量	默认值	说明
QUANTUMPROXIES_API_KEY	—	必需。 你的 qp_live_ 密钥。
QUANTUMPROXIES_API_BASE	https://app.quantumproxies.io/api/v1	用于覆盖暂存环境/自托管配置。
QUANTUMPROXIES_TOOLS	全部 28 个	仅加载部分工具：工具名称（search,scrape）或预设（lite、web、research、collectors、proxies）。见下文。

仅适用于自托管远程端点（quantumproxies-mcp-remote），可选：

变量	默认值	说明
MCP_OAUTH_RESOURCE	https://api.quantumproxies.io/mcp	将此端点作为 OAuth 资源。
MCP_OAUTH_ISSUER	https://app.quantumproxies.io	在资源元数据中公布的授权服务器。
MCP_OAUTH_INTROSPECT_URL	http://127.0.0.1:3090/api/v1/internal/oauth/introspect	检查 OAuth 访问令牌的位置。
MCP_INTERNAL_TOKEN	—	用于内省请求的密钥。未设置 = 仅接受 API 密钥。

本地模型（Ollama、LM Studio、Qwen、Open WebUI）

28 个工具定义约占 14,000 个令牌。Ollama 默认的 4K 上下文无法容纳这些定义，而 32K 上下文在显示第一页之前就会损失将近一半的可用空间。请加载更少的工具：

预设	工具	定义令牌数
lite	search_and_read	~360
web	search, search_and_read, scrape	~4,200
research	web + map, batch, batch_status	~5,100
collectors	list_collectors, run_collector, collector_run_status	~830
proxies	list_proxies, generate_proxies, proxy_locations, whitelist_ip	~1,800

使用 stdio 时，设置 QUANTUMPROXIES_TOOLS=web。使用托管端点时，在 URL 后添加 ?tools=web，并在 Bearer 标头中发送 API 密钥： https://api.quantumproxies.io/mcp?tools=web。可以组合名称：?tools=lite,collectors。

示例提示词

• "抓取 example.com 的定价页面，并告诉我有哪些套餐及其价格。"
• "在美国的 Google Shopping 上搜索 'nintendo switch oled'，并列出最便宜的 5 个结果。"
• "映射 docs.example.com，然后只抓取 /guides/ 页面并对其进行总结。"
• "列出我的代理套餐，并生成 5 个固定会话的美国住宅代理 socks5 URL。"
• "为我获取一个位于德国的轮换移动代理，并将我的服务器 IP 203.0.113.7 加入白名单。"

隐私政策

完整政策：https://quantumproxies.io/privacy

此服务会发送的内容。 它在你的计算机上运行，只与公开的 QuantumProxies API https://app.quantumproxies.io/api/v1 通信，并使用你自己的 qp_live_ 密钥进行身份验证。每次调用都会携带你（或你的 Agent）传入的参数——目标 URL 或查询，以及任何提取提示词。不会读取或传输你计算机上的其他内容：此服务无法访问文件系统、Shell 或剪贴板。

我们收集的内容。 你提供的账户数据（姓名、电子邮件、账单信息），以及为计费、防止滥用和提供支持而保留的请求日志：目标 URL 或查询、时间戳、响应状态、传输字节数和所用的 API 密钥。我们不会保留抓取的页面内容，除非为返回结果所必需。

你通过此服务收集的数据。 你决定收集哪些公开网络数据，且你是这些数据的控制者——我们仅代表你处理数据，以完成你的请求。你有责任合法使用此服务、遵守所访问网站的条款，并对通过此服务收集的任何个人数据负责。

共享。 我们不会出售个人数据。我们仅与运营此服务的处理方共享数据——支付服务提供商、电子邮件发送服务、托管服务、CDN 和分析服务——并通过合同要求他们保护数据；也会与路由你流量的上游代理网络共享数据（仅限连接元数据，不包括账户详情）。在法律要求时，我们可能会披露数据。

保留期限。 账户数据会保留至账户注销；请求日志会在滚动时间窗口内保留，用于计费和滥用调查。你可以随时请求删除数据。

你的密钥。 Claude Desktop 会将密钥存储在操作系统密钥链中，并将其作为环境变量传递给此服务。密钥绝不会写入程序包，也绝不会发送到 QuantumProxies API 以外的任何地方。请前往 https://app.quantumproxies.io/api-keys 撤销或轮换密钥。

联系方式。 [email protected]