browserwing/browserwing · 上手攻略

• 仓库：browserwing/browserwing
• 链接：https://github.com/browserwing/browserwing
• 分类：Browser Automation · MCP/Skills 生态
• 作者：Tom
• 更新：2026-08-22

是什么

BrowserWing 是一个浏览器自动化平台，将浏览器操作转化为 MCP 命令或 Claude Skill，让 AI Agent 通过结构化命令直接控制浏览器，而非依赖慢速、高 token 消耗的 LLM 视觉理解页面。

核心定位：替代「让 Agent 看截图理解页面」的慢方案，改为「Agent 调用预定义命令，BrowserWing 精确执行 JS 注入操作」。

78 个内置脚本，覆盖 10 大分类：技术、社交、资讯、财经、娱乐、购物、求职、阅读、学术、搜索。数据以 JSON/CSV 结构化输出，可直接在管道中处理。

协议支持： - MCP（Model Context Protocol）：作为 MCP HTTP 服务器运行，兼容任何支持 MCP 的 AI 工具 - Skills 协议：导出为 .md Skills 文件，导入到 OpenClaw、Cursor、Claude Code 等

解决什么问题

传统浏览器自动化方案（如 Puppeteer、Playwright）对 Agent 不友好：

BrowserWing 的核心创新是「脚本化 + 协议输出」，让 AI Agent 把浏览器当工具调用，而不是当伙伴沟通。

快速安装

方式一：npm（推荐，30 秒上手）

npm install -g browserwing
browserwing --port 8080
# 然后在浏览器打开 http://localhost:8080

使用 pnpm：

pnpm add -g browserwing
browserwing --port 8080

npm 包安装时会自动测试 GitHub 和 Gitee 镜像，选择最快的源。

方式二：安装脚本（Linux/macOS）

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

方式三：PowerShell（Windows）

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

脚本自动检测系统和架构，测试 GitHub/Gitee 镜像，下载并解压二进制文件，添加到 PATH。国内用户自动使用 Gitee 镜像。

方式四：直接下载二进制

从 Releases 下载对应 OS 的预编译二进制：

# Linux/macOS
chmod +x ./browserwing
./browserwing --port 8080

# Windows
.\browserwing.exe --port 8080

macOS 特殊注意

如果运行时遇到 killed 错误：

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

环境要求：系统已安装 Google Chrome 或 Chromium，且可正常访问。

核心用法

基础 CLI 命令

# 列出所有可用脚本（JSON 格式，方便 Agent 解析）
browserwing ls --format=json

# 运行内置脚本，直接获取 JSON 数据（无头模式，不弹浏览器窗口）
browserwing run bilibili-hot
browserwing run github-trending
browserwing run hackernews-top

# 管道组合，取前 5 条
browserwing run hackernews-top | jq '.[0:5]'

# 导出 CSV
browserwing run sinafinance-rank --format=csv > stocks.csv

# 带参数运行
browserwing run jd-search --keyword="机械键盘"

# 调试模式：显示浏览器窗口，观察操作过程
browserwing run zhihu-hot --no-headless

配置为 MCP 服务器

在任何支持 MCP 的 AI 工具中添加以下配置：

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

将配置粘贴到 AI 工具的 MCP 设置页，即可启用浏览器自动化能力。Agent 即可通过 MCP 协议调用 BrowserWing。

使用 Skills 文件

1. 启动 BrowserWing：browserwing --port 8080
2. 下载 SKILL.md
3. 导入到 AI 工具的 Skills 设置
4. 用自然语言命令开始自动化，例如：

"访问淘宝，搜索 'MacBook'，提取前 5 个商品的价格"

内置 AI Agent（对话式）

BrowserWing 自带对话式 AI Agent： 1. 打开 http://localhost:8080 2. 进入 AI Agent 区域 3. 配置 LLM（支持 OpenAI、Claude、DeepSeek 等） 4. 用自然语言描述任务，Agent 内部调用脚本执行

导出自定义脚本为 MCP/Skills

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，提供源码级指纹补丁：

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

# 启动 CloakBrowser 的 cloakserve CDP 服务器
python /path/to/cloakbrowser/bin/cloakserve --port=9222 --headless

通过 49-57 个 C++ 源码级补丁（canvas、WebGL、audio、fonts、GPU、WebRTC 等），可绕过 Cloudflare Turnstile、FingerprintJS、BrowserScan、reCAPTCHA v3 等主流检测。

典型适用场景

1. AI Agent 数据采集 想让 Agent 获取某个网站的数据但不想让它「看截图」？直接 browserwing run github-trending 获取结构化 JSON，Agent 解析后做分析。

2. 跨境电商价格监控

browserwing run jd-search --keyword="iPhone 16" | jq '.[] | {title, price}'

自动化采集商品信息，管道输出到数据分析工具。

3. 社交媒体热点追踪

browserwing run bilibili-hot
browserwing run zhihu-hot

定期获取热点，喂给大模型做摘要。

4. 金融数据提取

browserwing run sinafinance-rank --format=csv > stocks.csv

导出结构化股票数据，后续用 Python/Pandas 分析。

5. 浏览器操作的教学与演示 可视化录制脚本，导出为 Skills 分享给团队，无需写代码。

坑与注意

⚠️ Chrome/Chromium 必须预装：BrowserWing 本身是浏览器控制层，不包含 Chromium。需要系统已安装 Chrome 或 Chromium，且 browserwing 能找到可执行路径。

⚠️ macOS killed 错误：运行 killed 是因为 macOS Gatekeeper 对未签名二进制文件的限制，用 xattr -d com.apple.quarantine $(which browserwing) 解决。

⚠️ 服务必须先启动：BrowserWing 是 C/S 架构，CLI 命令默认连接 localhost:8080。没有先 browserwing --port 8080，CLI 命令会报连接失败。

⚠️ token 高效 ≠ 零 token：BrowserWing 减少了 Agent 视觉理解消耗，但脚本执行、LLM 语义提取仍消耗 token。复杂数据提取场景可结合 jq 做规则解析，减少 LLM 调用。

⚠️ CloakBrowser 集成需额外安装：CloakBrowser 是独立项目，不在 BrowserWing 包内，需要单独 pip install。

⚠️ Homebrew 安装「即将支持」：README 标注 brew install browserwing 为 coming soon，当前不要等 Homebrew，直接用 npm 或安装脚本。

⚠️ 78 个脚本覆盖范围有限：内置脚本集中在中文化网站（淘宝、京东、知乎、哔哩哔哩等），海外网站支持依赖脚本数量。需要自定义网站采集可能要自己录制脚本。

与同类对比

核心差异：BrowserWing 是目前唯一同时做到「MCP + Skills 双协议支持 + 78 个内置脚本 + 中文网站覆盖 + 可视化录制导出」的浏览器自动化工具，且 token 效率设计优于传统截图理解方案。

一句话推荐结论

如果你在构建需要浏览器操作的 AI Agent（特别是涉及中文网站数据采集或需要 MCP/Skills 协议集成），BrowserWing 是当前完成度最高、协议兼容性最好的选择；如果你只需要简单网页截图，用 Playwright MCP 更轻量；如果你需要对抗强反爬系统，加上 CloakBrowser 集成即可。

⚠️ 数字核验

• 78 个内置脚本：来自 README，✅ 核验
• 10 大分类覆盖：技术/社交/资讯/财经/娱乐/购物/求职/阅读/学术/搜索，✅ 来自 README
• 26+ HTTP API 端点：来自 README，⚠️ 未逐条核实
• CloakBrowser 49-57 个源码级补丁：来自 CloakBrowser GitHub，✅ 原文
• npm 安装自动选择 GitHub/Gitee 镜像：✅ README 明确说明
• 支持 OpenAI / Claude / DeepSeek 多 LLM：README 列出，✅ 核验

原始链接： - GitHub 仓库：https://github.com/browserwing/browserwing - SKILL.md：https://raw.githubusercontent.com/browserwing/browserwing/refs/heads/main/SKILL.md - INSTALL.md：https://raw.githubusercontent.com/browserwing/browserwing/main/INSTALL.md - Releases：https://github.com/browserwing/browserwing/releases - Gitee Releases（国内镜像）：https://gitee.com/browserwing/browserwing/releases