BrowserSolver

BrowserSolver MCP 服务

适用于 BrowserSolver 网页解锁 API 的官方 Model Context Protocol 服务。

解锁、渲染、爬取任意网站并截取屏幕截图——通过一个 API 绕过反机器人机制并检测技术栈。

它让 Claude、Cursor、VS Code、Windsurf 和任何 MCP 客户端都能将 API 作为工具调用。支持通过 stdio（本地）或 Streamable HTTP（可自托管）运行。

要求

• Node.js 20 或更高版本
• BrowserSolver API 密钥——注册，然后从控制面板复制密钥

托管服务（推荐）

BrowserSolver 会在 https://mcp.browsersolver.com/（Streamable HTTP）上为你运行此服务。只需在 x-api-key 请求头中发送 API 密钥；无需安装任何内容。

claude mcp add --transport http browsersolver https://mcp.browsersolver.com/ --header "x-api-key: YOUR_API_KEY"

{
  "mcpServers": {
    "browsersolver": {
      "url": "https://mcp.browsersolver.com/",
      "headers": {
        "x-api-key": "YOUR_API_KEY"
      }
    }
  }
}

托管服务和此软件包提供相同的 API；如果你需要使用 stdio、自定义网络出口或自行托管，可在本地运行此软件包。

在本地运行

Claude Code

claude mcp add browsersolver --env BROWSERSOLVER_API_KEY=YOUR_API_KEY -- npx -y @browsersolver/mcp

Claude Desktop、Cursor、Windsurf 和其他客户端

将服务添加到客户端的 MCP 配置中（claude_desktop_config.json、.cursor/mcp.json……）：

{
  "mcpServers": {
    "browsersolver": {
      "command": "npx",
      "args": ["-y", "@browsersolver/mcp"],
      "env": {
        "BROWSERSOLVER_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

VS Code

{
  "servers": {
    "browsersolver": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@browsersolver/mcp"],
      "env": {
        "BROWSERSOLVER_API_KEY": "${input:browsersolver-api-key}"
      }
    }
  },
  "inputs": [
    {
      "type": "promptString",
      "id": "browsersolver-api-key",
      "description": "BrowserSolver API key",
      "password": true
    }
  ]
}

Claude Desktop 扩展

从发布页面下载 .mcpb 捆绑包并打开；Claude Desktop 会提示你输入 API 密钥。

Docker

docker build -t browsersolver-mcp .
docker run -i --rm -e BROWSERSOLVER_API_KEY=YOUR_API_KEY browsersolver-mcp

工具

工具	描述
stats	查看过去一小时内某个引擎或端点的基础设施运行状况。不会限定到你的账户或租户。需为每个账户单独启用：如果返回 HTTP 403，请联系支持人员为其启用。
usage	获取 BrowserSolver 账户的实时用量统计数据和积分余额。
website_antibot	单次扫描即可识别 URL 前方的反机器人防护服务商，帮助你选择合适的 BrowserSolver 抓取层级。
website_crawler	快速通过 HTTP 获取公开 HTML，无需浏览器会话。适用于首个响应已包含所需内容的情况。
website_rendering	对公开 URL 启动托管浏览器会话，并在客户端脚本运行完毕后收集 HTML。静态标记优先使用 Crawler；在获准的主机上遇到挑战时，再升级到 WebUnlocker。
website_screenshot	将任意公开 URL 转换为由 BrowserSolver 渲染的 PNG、JPEG、WebP 或 PDF 文件。无需维护本地 Chromium 集群。
website_technology	识别公开 URL 使用的 CMS、框架、分析工具、CDN 和安全工具。可选择简明列表或包含置信度评分的专家级元数据。
website_webunlocker	BrowserSolver 面向账户白名单中零售和市场平台主机的最高级 HTML 抓取层级。可解决仍会阻止 Rendering 的持续性机器人挑战。

每个调用 API 的工具都会消耗积分。JSON 结果以文本形式返回；图像以内联形式返回，其他文件（PDF……）则作为嵌入式资源返回，最大为 4 MB。

Streamable HTTP

npx @browsersolver/mcp --http --port 3000

端点为 POST /mcp（无状态，返回 JSON）。每个客户端都在 x-api-key 请求头（或 Authorization: Bearer <key>）中发送自己的密钥；服务端不会使用自己的密钥。默认绑定到 127.0.0.1，并会拒绝浏览器来源，除非你将其加入允许列表——对外开放前，请将其置于 TLS 后面。

导出的 createHttpHandler() 适用于 Fetch 兼容运行时（Cloudflare Workers、Deno、Bun）：

import { createHttpHandler } from "@browsersolver/mcp";

export default { fetch: createHttpHandler({ allowedOrigins: [] }) };

安全

• API 密钥从 BROWSERSOLVER_API_KEY（stdio）或请求头（HTTP）读取，并会从错误消息中移除。
• 从网站获取的内容不可信：服务端指令会告知模型将其视为数据，而非指令。
• 如需报告漏洞，请参阅 SECURITY.md。

开发

npm install
npm test
npm run build
npx @modelcontextprotocol/inspector node dist/stdio.js

基于 SDK 构建

该服务端使用官方 Node.js SDK（@browsersolver/sdk）。

所有 BrowserSolver SDK

SDK	包	安装
Node.js	@browsersolver/sdk	npm install @browsersolver/sdk
Python	browsersolver	pip install browsersolver
Go	browsersolver-go	go get github.com/browsersolver/browsersolver-go
.NET	BrowserSolver	dotnet add package BrowserSolver
Ruby	browsersolver	gem install browsersolver
PHP	browsersolver/sdk	composer require browsersolver/sdk
Java	browsersolver-java	从源代码构建，详见其 README
CLI	@browsersolver/cli	npm install -g @browsersolver/cli
MCP 服务	@browsersolver/mcp	npx -y @browsersolver/mcp

许可证

MIT — 详见 LICENSE。