MrScraper

官方

以 Markdown、HTML 或截图形式获取任意公开网页,并通过自动浏览器渲染、搜索网页以获取解析结果,以及查看套餐用量。

你可以用 MrScraper MCP 做什么?

  • 以 Markdown、HTML 或截图形式获取页面 — 让你的助手通过 scraperAPI 以其中一种或全部格式获取任意公开 URL。
  • 处理由浏览器渲染的页面 — 请求自动进行浏览器渲染、等待 CSS 选择器出现,或从指定国家加载页面。
  • 搜索网页 — 通过 webSearch 运行查询或完整的搜索结果 URL,并获取包含排名、标题、链接和摘要的解析结果。
  • 跨网站比较 — 结合搜索和页面读取来比较定价、产品或文档页面,同时保留来源以供参考。
  • 查看套餐用量 — 通过 status 查询你的套餐、令牌上限、已用令牌数、剩余令牌数和速率限制。

托管 MCP 服务器

npx add-mcp 'https://mcp.mrscraper.com/mcp'

可安装到 Claude Code、Codex、Cursor 等客户端

文档

MrScraper

MrScraper MCP 服务器

MrScraper 官方 Model Context Protocol (MCP) 服务器:为你的 AI 助手提供实时网页数据。通过托管端点读取任意公开页面,并以 Markdown、HTML 或截图形式获取内容;搜索网页并查看套餐用量。你可以通过浏览器登录,也可以自行运行本地服务器。

Official MrScraper server npm version License: MIT Hosted at mcp.mrscraper.com

Model Context Protocol compatible MCP Registry: io.github.mrscraper-com/mrscraper-mcp Auth: OAuth 2.1 or API key Transport: Streamable HTTP or stdio

scraperAPI: HTML, Markdown, screenshot webSearch: parsed results status: plan usage

文档 · 工具参考 · 安全 · 支持


MrScraper MCP 将 AI 助手和智能体连接到 MrScraper 网页数据服务。连接后,你的助手可以获取任意公开网页、通过网页搜索发现页面,并查看套餐剩余的 token 数量,无需你将页面复制到聊天中。

使用 MrScraper MCP,你可以:

  • 读取页面。 获取公开页面,并以 Markdown、HTML、截图或三者组合的形式返回。
  • 读取需要浏览器的页面。 页面需要浏览器时会自动启动浏览器渲染;你也可以等待某个元素出现,并从指定国家加载页面。
  • 搜索网页。 获取解析后的搜索结果(排名、标题、链接、摘要),然后抓取所需页面。
  • 研究和比较。 结合搜索和页面读取功能,比较不同网站上的价格页面、产品页面或文档,并保留来源页面以供参考。
  • 查看用量。 查询套餐剩余的 token 数量。

一键设置

选择你的 AI 客户端。首次使用工具时,每个客户端都会在浏览器中引导你登录 MrScraper,因此无需粘贴 API 密钥。

Add to Cursor
添加到 Cursor

一键安装。
Add to VS Code
添加到 VS Code

一键安装。
Get the JetBrains plugin
获取 JetBrains 插件

适用于 JetBrains AI 智能体。
Add to Claude
添加到 Claude

作为自定义连接器。
Add to Claude Code
添加到 Claude Code

一条命令。
Add to Codex
添加到 Codex

一条命令。

让你的智能体完成设置

大多数 AI 编码智能体都可以自行配置服务器。将以下提示粘贴到你的智能体中:

Connect MrScraper MCP to this agent. Detect the current MCP client and configure a Streamable HTTP server named mrscraper at https://mcp.mrscraper.com/mcp with no credential. The server uses OAuth 2.1, so the client will open a browser to sign in. If the client cannot do OAuth, fall back to a MrScraper API key from https://app.mrscraper.com/api-tokens stored through the client's environment-variable or secret-storage mechanism and sent as Authorization: Bearer <key>. Reload the MCP client when required, then list the tools and confirm that scraperAPI, webSearch, and status are the only available tools.

工具

工具功能
scraperAPI将已知 URL 获取为 HTML、Markdown、截图或其组合。选项包括浏览器渲染、等待 CSS 选择器、国家/地区、超时和重试次数限制。
webSearch根据查询文本或完整的搜索结果 URL 执行网页搜索,并返回解析后的 JSON 或结果页面 HTML。选项包括地区、语言和页码。
status返回账户套餐、token 限额、token 用量、剩余 token 数量和速率限制。

网页工具为只读。支持 MCP Apps 的主机还会显示搜索结果小组件和账户用量仪表。

手动连接

端点(Streamable HTTP):

https://mcp.mrscraper.com/mcp

将此 URL 添加到 MCP 客户端,无需提供凭据。客户端会打开浏览器,你登录 MrScraper 并批准访问后,客户端便会保存令牌。请完全按照所示使用该 URL,包括 /mcp。

Claude Code:

claude mcp add --transport http --scope user mrscraper https://mcp.mrscraper.com/mcp

Codex:

codex mcp add mrscraper --url https://mcp.mrscraper.com/mcp

通过文件配置的客户端:

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

你批准的权限

范围允许的操作
scrape:readwebSearch
scrape:writescraperAPI
account:readstatus

你可以随时在 MrScraper 账户的“已连接的应用”中断开客户端连接。

改用 API 密钥

不支持 OAuth 的客户端可以将 MrScraper API 密钥作为 bearer token 发送。你可以在 app.mrscraper.com/api-tokens 创建密钥:

{
  "mcpServers": {
    "mrscraper": {
      "url": "https://mcp.mrscraper.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_MRSCRAPER_API_KEY"
      }
    }
  }
}

API 密钥拥有你账户的全部访问权限。请将其保存在客户端的机密信息或环境变量存储中,切勿放入共享项目文件。

在本地运行

同一服务器也已开源,并以 @mrscraper/mcp 的名称发布在 npm 上。本地设置使用 MrScraper API 密钥,而非浏览器登录。

# stdio, for clients that start a local process; reads the key from MRSCRAPER_API_KEY
MRSCRAPER_API_KEY=YOUR_MRSCRAPER_API_KEY npx -y @mrscraper/mcp@latest

# local Streamable HTTP service; clients send the key as a bearer token
TRANSPORT=http npx -y @mrscraper/mcp@latest

插件

MrScraper 也以插件形式提供,其中包含 MCP 服务器和适用于 Claude Code 与 JetBrains IDEs 的技能。

数据和用量

  • 需要 MrScraper 账户。每次调用都会消耗套餐中的 token;请参阅 mrscraper.com/pricing。
  • MrScraper 会接收你发送的 URL 和工具输入(包括搜索查询),并将结果返回给你的客户端。
  • 仅获取你有权访问的内容,并遵守各网站的条款以及 MrScraper 的可接受使用政策。

链接