BrowserWing：浏览器自动化转 MCP 命令工具

项目简介

BrowserWing 是一个用 Go 编写的浏览器自动化平台，核心思路是把浏览器操作变成 MCP 命令或 Claude Skill，让 AI 代理（OpenClaw、Cursor、Claude Code 等）直接调用命令来控制浏览器，而不必依赖缓慢、消耗大量 token 的逐步交互。

它自带可视化录制器、内置 AI Agent、78 个开箱即用的内置脚本，以及面向 AI 代理和 shell 管道的 CLI 模式。前端使用 React 18 + TypeScript + Vite，后端为 Go。

一句话概括：用一条命令把任意网站变成结构化数据。

主要功能

• 完整的浏览器控制：提供 26+ 个 HTTP API 端点，覆盖浏览器自动化的各类操作。
• 内置 AI Agent：在 Web 界面中直接通过对话完成浏览器自动化任务。
• 通用 AI 工具集成：原生支持 MCP 与 Skills 协议，兼容任何支持这两种标准的 AI 工具。
• 可视化脚本录制：录制点击、输入、跳转、等待等动作，可视化编辑并精确回放。
• 灵活导出：把录制的脚本转换为 MCP 命令或 Skills 文件，供 AI 工具使用。
• 智能数据提取：基于 LLM 的语义化提取，支持 OpenAI、Claude、DeepSeek 等模型。
• 会话管理：可靠的 Cookie 与存储处理，保证需要登录的浏览会话稳定。
• CLI 模式：面向 AI 代理的 run、list、doctor、help 命令，默认无头运行，输出结构化 JSON/CSV。
• 内置脚本库：78 个脚本覆盖 10 个类别（Bilibili、GitHub、Reddit、Hacker News、YouTube、Steam、BBC、Bloomberg、Reuters、Google Scholar、Binance、Amazon、Weibo、知乎、CNKI、Yahoo Finance 等）。
• 多 LLM 支持：可与 OpenAI、Anthropic、DeepSeek 等提供商配合使用。

安装与使用

环境要求

需要本机已安装并可访问 Google Chrome 或 Chromium。

通过包管理器安装（推荐）

npm install -g browserwing
browserwing --port 8080

或使用 pnpm：

pnpm add -g browserwing
browserwing --port 8080

安装完成后打开 http://localhost:8080 即可进入 Web 界面。npm 包在安装时会自动测试 GitHub 与 Gitee 镜像并选择最快的一个。

macOS 用户注意：若运行时出现 “killed” 错误，可执行：

xattr -d com.apple.quarantine $(which browserwing)

一键安装脚本

Linux / macOS：

curl -fsSL https://raw.githubusercontent.com/browserwing/browserwing/main/install.sh | bash

Windows（PowerShell）：

iwr -useb https://raw.githubusercontent.com/browserwing/browserwing/main/install.ps1 | iex

脚本会自动检测系统与架构、测试 GitHub / Gitee 镜像并选择最快的一个、下载解压二进制并加入 PATH。之后执行：

browserwing --port 8080
# 在浏览器中打开 http://localhost:8080

从源码构建

# 安装依赖（需要 Go + pnpm）
make install

# 构建内嵌前端的单一二进制
make build-embedded
./build/browserwing --port 8080

# 或构建全部目标并打包
make build-all
make package

方式一：作为 MCP Server 集成

在任意支持 MCP 的 AI 工具中配置：

{
  "mcpServers": {
    "browserwing": {
      "type": "http",
      "url": "http://localhost:8080/api/v1/mcp/message"
    }
  }
}

方式二：Skills 文件集成

1. 启动 BrowserWing；
2. 从仓库下载 SKILL.md；
3. 导入到 AI 工具的 Skills 设置中；
4. 用自然语言开始自动化。

示例指令：

"Navigate to example.com, search for 'AI tools', and extract the top 5 results"

方式三：CLI 模式（面向 AI 代理）

# 列出所有可用脚本
browserwing ls --format=json

# 运行脚本并获取 JSON 输出
browserwing run bilibili-hot
browserwing run github-trending
browserwing run hackernews-top

# 向脚本传参
browserwing run jd-search --keyword="机械键盘"

# 管道给其他工具
browserwing run sinafinance-rank --format=csv > stocks.csv
browserwing run hackernews-top | jq '.[0:5]'

# 显示浏览器窗口便于调试
browserwing run zhihu-hot --no-headless

典型的 AI 代理工作流：先用 browserwing ls --format=json 发现脚本及其参数，再用 browserwing run <name> --key=value 执行并获得结构化 JSON 数据，最后解析输出继续处理。

方式四：内置 AI Agent

1. 打开 http://localhost:8080；
2. 进入 “AI Agent” 区域；
3. 配置 LLM（OpenAI、Claude、DeepSeek 等）；
4. 通过对话开始浏览器自动化。

导出自定义脚本：

curl -X POST 'http://localhost:8080/api/v1/scripts/export/skill' \
  -H 'Content-Type: application/json' \
  -d '{"script_ids": []}' \
  -o MY_CUSTOM_SCRIPTS.md

可选：配合 CloakBrowser 增强隐蔽性

BrowserWing 支持 CloakBrowser —— 一个在源码层做指纹补丁的 Chromium 二进制，可作为标准 Chromium 的替代品使用。

pip install cloakbrowser
python -c "from cloakbrowser import ensure_binary; ensure_binary()"

启动其 cloakserve CDP 服务：

python /path/to/cloakbrowser/bin/cloakserve --port=9222 --headless=false

注意事项

• 必须预先安装 Google Chrome 或 Chromium，否则无法运行自动化。
• 部分内置脚本需要登录态；Web 界面中会以 “Login Required” 标记提示。
• macOS 上若遇进程被杀，需按上文命令移除 quarantine 属性。
• 中国大陆用户如果访问 GitHub 较慢，安装脚本会自动切换到 Gitee 镜像。
• 以 MCP Server 方式接入时，需先在本机启动 BrowserWing 服务，AI 工具才能连上 http://localhost:8080/api/v1/mcp/message。
• 项目采用 MIT 许可证。

---

本作品整理自 GitHub 开源项目 browserwing/browserwing，原作者 @browserwing，许可证 MIT。中文介绍由 AI 根据项目 README 整理，以原仓库为准。