# 支持 OAuth 的网页抓取 MCP 服务器 | QuantumProxies.io

面向 Claude、Cursor 及任意 MCP 客户端的网页抓取 MCP 服务器。通过 OAuth 2.1 登录即可接入，无需粘贴 API 密钥，提供 scrape、search、map、crawl 等 29 个工具。

## 面向网页抓取与 AI 智能体的 MCP 服务器

QuantumProxies.io 的 MCP 服务器为 Claude、Cursor 及任意 MCP 客户端提供 29 个工具，经住宅代理对实时网页进行 scrape、search、map 与 crawl。在支持 OAuth 登录的客户端中添加 https://api.quantumproxies.io/mcp，登录账户并点击 Allow access 即可，无需复制 API 密钥。

- OAuth 2.1 登录
- 免费，仅按 API 用量付费
- 29 个工具
- 任意 MCP 客户端

## 四步完成 OAuth 连接

适用于支持 OAuth 登录的 MCP 客户端，即 MCP 规范中定义的授权流程。

1. **添加服务器 URL**: 将 https://api.quantumproxies.io/mcp 粘贴到客户端中，例如在 Claude 中添加为自定义连接器。
2. **登录**: 客户端会打开 QuantumProxies.io 登录页面。登录，或免费创建一个账户。
3. **授权访问**: 同意页面会请你确认。点击 Allow access，客户端即完成连接。
4. **向智能体提问**: 29 个工具立即可用。用量与任何 API 密钥一样从账户余额中扣除。

每个连接都会获得专属 API 密钥，在控制台的 API 密钥页面中以 MCP · \<client name> 命名。删除该密钥，客户端即断开连接。

## OAuth 还是 API 密钥？

两者访问的是同一个端点、同样的 29 个工具。

### OAuth 登录

适用于聊天应用和桌面客户端。无需复制或保存任何内容：客户端持有短期令牌，每个连接都显示为一个可单独删除的密钥。

### API 密钥

适用于脚本、CI、无头智能体以及本地 npx 包。向托管端点发送 qp_live_ 密钥，放在 Authorization: Bearer 或 X-Api-Key 中；本地服务器则设置 QUANTUMPROXIES_API_KEY。

## 面向 AI 代理的技能

五个 SKILL.md 文件教会 Claude Code、Claude.ai、Codex、Cursor、Gemini CLI 以及任何支持开放 Agent Skills 格式的代理正确使用 QuantumProxies.io。安装一次，代理会在任务需要时自动加载对应的技能。

一条命令完成安装: `npx skills add https://quantumproxies.io`. 可通过 skills CLI 在 70 多种代理中使用。Claude Code 也会加载复制到 ~/.claude/skills 的技能文件夹；Codex、Cursor 和 Gemini CLI 读取 ~/.agents/skills。

- [`use-data-api`](https://quantumproxies.io/.well-known/agent-skills/use-data-api/SKILL.md): 调用 REST Data API：认证、响应封装、异步任务、参考文档
- [`use-mcp-server`](https://quantumproxies.io/.well-known/agent-skills/use-mcp-server/SKILL.md): 连接任意 MCP 客户端：托管 OAuth 端点或本地 npm 包、工具预设
- [`scrape-to-markdown`](https://quantumproxies.io/.well-known/agent-skills/scrape-to-markdown/SKILL.md): 从单个 URL 得到干净的 Markdown 或结构化字段；多页面使用 batch、map 和 crawl
- [`generate-proxies`](https://quantumproxies.io/.well-known/agent-skills/generate-proxies/SKILL.md): 从你的套餐生成代理字符串：地理定位、粘性会话、IP 白名单
- [`find-business-leads`](https://quantumproxies.io/.well-known/agent-skills/find-business-leads/SKILL.md): 企业名单与数据集：Collectors、AI Places Finder、数据集构建器

[发现索引（/.well-known/agent-skills/）](https://quantumproxies.io/.well-known/agent-skills/index.json) · [GitHub 上的源码与 Claude Code 插件](https://github.com/quantumproxies/quantumproxies-skills)

托管端点遵循 MCP 规范中的授权部分：它是一个 OAuth 2.1 受保护资源，未携带凭据的请求会收到 401 响应，告诉客户端去哪里登录。同一 URL 上密钥依然有效，现有配置不受影响。

## 远程 MCP 服务器 URL 与发现机制

托管服务器位于 https://api.quantumproxies.io/mcp，使用 Streamable HTTP 通信。它在 https://api.quantumproxies.io/.well-known/oauth-protected-resource/mcp 发布 OAuth 受保护资源元数据（RFC 9728），并将 https://app.quantumproxies.io 指定为授权服务器。授权服务器在 /.well-known/oauth-authorization-server 发布自己的元数据（RFC 8414）。实现了 MCP 授权的客户端会从 401 响应开始，自动找到上述全部信息。

## OAuth 2.1 登录如何保障安全

每次授权都必须使用 S256 方法的 PKCE。客户端可通过 Dynamic Client Registration（RFC 7591）注册，或使用 Client ID Metadata Document 标识自身。访问令牌有效期为一小时；刷新令牌有效期为 30 天，每次使用后轮换。令牌通过资源指示符（RFC 8707）绑定到 MCP 端点，绝不会转发给其他服务。

## 管理与断开客户端

你授权的每个客户端都会获得专属 API 密钥，在控制台的 API 密钥页面中以 MCP · \<client name> 命名。其用量与其他 API 密钥一样从账户余额中扣除。删除该密钥即可断开该客户端，其他客户端和密钥照常工作。

## 改用 API 密钥连接

API 密钥在同一端点上依然有效：将 qp_live_ 密钥放在 Authorization: Bearer 或 X-Api-Key 头中发送。本地包 npx -y quantumproxies-mcp 通过 stdio 在你的机器上运行，并从 QUANTUMPROXIES_API_KEY 环境变量读取密钥。凡是没有浏览器可供登录的场景，例如脚本、CI 和无头智能体，都请使用密钥。

## 智能体可用的 29 个工具

搜索、读取、crawl 实时网页，并将其转化为有来源依据的上下文或经过验证的数据行。耗时较长的工具提供 status 调用，智能体可轮询进度，无需重复下载同一份数据。

- `scrape`: 经带真实浏览器 TLS 指纹的住宅代理，将单个 URL 转为整洁的 Markdown、HTML 或纯文本。可选 CSS 选择器或 AI 提取，输出结构化 JSON。
- `search`: Google、Bing 或 DuckDuckGo 的结构化结果，包含各引擎特有的垂直结果、富结果区块和分页元数据。
- `search_and_read`: 搜索实时网页，抓取排名靠前的来源，返回可直接引用、且控制在智能体 token 预算内的上下文。
- `read_video`: 将一个 YouTube 视频读成一条时间线：元数据、章节、原始语言的转录文本，以及在讲者指向屏幕、报出价格或进入新章节处截取的小尺寸画面。
- `map`: 基于站点地图和首页链接，数秒内发现网站的 URL，无需完整 crawl 即可先找准要 scrape 的页面。
- `crawl` + `crawl_status`: 从种子 URL 开始异步 crawl，每个页面都转为 Markdown。支持包含与排除过滤、深度控制，并可通过 crawl_status 查看进度。
- `batch` + `batch_status`: 以共享选项异步 scrape 最多 1,000 个 URL，并按 URL 增量轮询结果。
- `search_bulk` + `search_bulk_status`: 异步采集多页 SERP，保留第一页的增强信息，并合并重复的自然结果。
- `unlock`: 作为工具的 Web Unlocker：通过住宅出口重放任意 HTTP 请求（方法、请求头、请求体），用新 IP 重试，被拦截的 GET 自动升级到真实浏览器。仍被拦截的页面会带标记返回，绝不会伪装成静默的 200。
- `create_dataset` + `dataset_status`: 将自然语言需求转化为经过验证的数据集，数据行增量产出，并提供签名的 CSV/JSON 下载。
- `seo_audit`: 对比页面在无 JS 与渲染后两种视图下的 SEO：元数据、canonical、标题层级、内容及结构化数据的差异。
- `ai_visibility`: ChatGPT、Claude、Perplexity、Google AI Overview 和 Bing Copilot 能否读取并引用某个页面？按维度评分的页面审计，附带阻碍项与修复建议，并可选加一个向各引擎实际提问的引用面板。
- `generate_parser` + `save_parser_preset` + `list_parser_presets` + `parser_preset_stats` + `heal_parser_preset`: 借助 LLM 一次性学习页面布局的 CSS 选择器，之后作为免费的确定性提取反复使用。五个工具负责生成、保存、列出、评分解析器，并在网站改版时自我修复。
- `list_collectors` + `run_collector` + `collector_run_status`: list_collectors、run_collector 和 collector_run_status：以关键词、地点等语义输入代替 URL。覆盖 Amazon、Google Maps、LinkedIn 职位、应用商店，另有 70 个，按交付行数计费。
- `list_proxies` + `generate_proxies` + `proxy_locations` + `whitelist_ip`: list_proxies、generate_proxies、proxy_locations 和 whitelist_ip 让智能体直接获得各类可用的代理端点，地理定位可细化到城市、ISP 或 ASN。
- `report`: 在智能体内部直接向团队反馈：一个 bug、缺失的功能或采集器、一个问题。无需 API 密钥即可使用。

## 常见问题

### 什么是 QuantumProxies.io MCP 服务器？

它是一个免费的 Model Context Protocol 服务器，将 QuantumProxies.io Scraper API 接入 Claude、Cursor 及任意 MCP 客户端。智能体可获得 29 个工具，经带真实浏览器 TLS 指纹的住宅代理对网页进行 scrape、search、map 与 crawl。可通过 OAuth 登录使用托管端点，也可在本地运行 npx 包。

### MCP 服务器支持 OAuth 吗？

支持。托管端点 https://api.quantumproxies.io/mcp 支持 MCP 授权规范定义的 OAuth 2.1 登录。在支持 OAuth 登录的客户端中添加该 URL，登录 QuantumProxies.io 并点击 Allow access。PKCE 为必需，访问令牌有效期一小时，刷新令牌会轮换。

### 如何将 MCP 服务器连接到 Claude？

在 Claude 中，将 https://api.quantumproxies.io/mcp 添加为自定义连接器，并在 QuantumProxies.io 页面打开时登录。在 Claude Code 中，运行 claude mcp add --transport http quantumproxies https://api.quantumproxies.io/mcp，然后通过 /mcp 登录。Claude Desktop 也可以使用 API 密钥运行本地 npx 包。

### 如何断开某个客户端？

打开控制台的 API 密钥页面。每个通过 OAuth 连接的客户端都有自己的密钥，名为 MCP · \<client name>。删除该密钥，客户端即失去访问权限；其他客户端和 API 密钥不受影响。如需重新连接，添加服务器 URL 并再次登录即可。

### 还能继续使用 API 密钥吗？

可以。将 qp_live_ 密钥放在 Authorization: Bearer 或 X-Api-Key 中发送到 https://api.quantumproxies.io/mcp，或使用 npx -y quantumproxies-mcp 配合 QUANTUMPROXIES_API_KEY 环境变量运行本地包。对于没有浏览器可登录的脚本、CI 和无头智能体，密钥更简单。

### 费用是多少？

MCP 服务器本身免费。你只需为它发起的 API 调用支付标准按量计费价格，与直接调用 Scraper API 的费率相同；无论通过 OAuth 还是密钥连接，都从账户余额中扣除。新账户可获得免费测试额度，无需信用卡。

### 有远程 MCP 服务器，还是只有本地包？

两者都有。托管端点 https://api.quantumproxies.io/mcp 使用 Streamable HTTP，适合偏好 URL 的客户端，支持 OAuth 登录或 API 密钥，提供同样的 29 个工具。npx 包通过 stdio 在你的机器上运行，使用你的 API 密钥认证。

### 它在哪里运行？你们能看到我的数据吗？

本地包通过 npx 在你的机器上运行，使用你自己的 qp_live_ 密钥与公开的 QuantumProxies.io API 通信：包内没有内部机密，也没有额外中转。托管端点使用与你的连接绑定的密钥发起同样的 API 调用；OAuth 令牌绝不会转发给其他服务。

### 支持哪些 MCP 客户端？

任何支持 Model Context Protocol 的客户端。通过 Streamable HTTP 连接远程服务器并支持 OAuth 登录的客户端使用托管 URL；Claude Desktop、Claude Code、Cursor、Windsurf、VS Code 和 Zed 等 stdio 客户端可用同样的五行 JSON 运行本地包。

### 智能体能获得哪些工具？

共 29 个工具：scrape、unlock、seo_audit、ai_visibility、search、search_and_read、read_video、map、支持状态轮询的 crawl 与 batch、各自带状态工具的 search_bulk 与 create_dataset、附带四个自修复预设工具的 generate_parser、覆盖现成抓取器的三个 Collector 工具、用于端点、地理定位和 IP 白名单的四个代理工具，以及向团队发送反馈的 report。

### 为什么不让智能体自己抓取页面？

智能体发出的普通 HTTP 请求，恰恰会在最值得读的页面上被反爬虫系统拦截。MCP 服务器让每个请求都经过带浏览器级 TLS 指纹的住宅 IP，被拦截时自动重试，并可回退到隐身浏览器，因此智能体读到的是真实页面，而不是验证码。

## 相关产品

- [Extract API：任意页面转为 Markdown 或 JSON](https://quantumproxies.io/zh/extract-api)
- [面向 LLM 与 RAG 的网页数据](https://quantumproxies.io/zh/web-data-for-llms)
- [支持 Google、Bing 和 DuckDuckGo 的 SERP API](https://quantumproxies.io/zh/serp-api)
- [面向反爬虫防护网站的 Web Unlocker](https://quantumproxies.io/zh/web-unlocker)
- [住宅代理](https://quantumproxies.io/zh/residential-proxies)

## Sources

- [What is the Model Context Protocol (MCP)?](https://modelcontextprotocol.io/docs/2026-07-28/getting-started/intro)
- [Model Context Protocol Specification](https://modelcontextprotocol.io/specification/2025-06-18)
- [Introducing the Model Context Protocol (Anthropic)](https://www.anthropic.com/news/model-context-protocol)
- [modelcontextprotocol/modelcontextprotocol (GitHub)](https://github.com/modelcontextprotocol/modelcontextprotocol)
- [Model Context Protocol (Wikipedia)](https://en.wikipedia.org/wiki/Model_Context_Protocol)
