英文 · 简体中文 · 日本語 · Español · Português

browserwing.com

https://github.com/user-attachments/assets/e5377892-4b88-433a-8620-43b38a2fb28f

亮点

集成AI的原生浏览器自动化平台

• 全面的浏览器控制：26+个HTTP API端点，提供功能齐全的浏览器自动化能力
• 内置AI助手：直接通过对话式界面执行浏览器自动化任务
• 通用AI工具集成：原生支持MCP和Skills协议——兼容任何支持这些标准的AI工具
• 可视化脚本录制：录制浏览器操作、可视化编辑，并精确回放
• 灵活的导出选项：将录制的脚本转换为MCP命令或Skills文件，便于与AI工具集成
• 智能数据提取：基于LLM的语义提取功能，支持OpenAI、Claude、DeepSeek等模型
• 会话管理：强大的Cookie和存储管理，确保稳定且已认证的浏览会话

系统要求

• 您的环境中需安装并可访问Google Chrome或Chromium。

截图

将脚本转化为Claude技能

现在您可以将任意脚本整合为SKILL.md文件。

快速入门

让您的AI助手为您安装

只需向您的AI助手（OpenClaw、Cursor、Claude Code等）发送以下消息：

“请按照https://raw.githubusercontent.com/browserwing/browserwing/main/INSTALL.md帮我安装BrowserWing。”

助手将自动阅读指南并完成安装、配置、Chrome设置以及技能集成。

---

选项A — 通过包管理器安装（推荐）

使用npm：

npm install -g browserwing
browserwing --port 8080

使用pnpm：

pnpm add -g browserwing
browserwing --port 8080

npm包在安装过程中会自动测试GitHub和Gitee镜像源，并选择速度最快的镜像。

⚠️ macOS用户：
如果运行时出现“killed”错误，请使用以下命令修复：

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

详情请参阅macOS安装修复指南。

使用Homebrew（macOS/Linux）：

# 即将推出
brew install browserwing

选项B — 一行安装脚本

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：

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

中国用户请注意： 如果GitHub访问较慢，安装脚本会自动切换至Gitee镜像源。

选项C — 手动下载

从Releases页面下载适用于您操作系统的预编译二进制文件：

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

# Windows（PowerShell）
./browserwing.exe --port 8080

选项D — 从源码构建

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

# 构建集成前端的二进制文件
make build-embedded
./build/browserwing --port 8080

# 或者构建所有目标和软件包
make build-all
make package

与AI工具的快速集成

使用BrowserWing的三种方式：

1. MCP服务器集成

在任何兼容MCP的AI工具中将BrowserWing配置为MCP服务器：

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

将此配置粘贴到您的AI工具的MCP设置中，即可启用浏览器自动化功能。

2. Skills文件集成

下载并导入Skills文件到任何支持Skills协议的AI工具中：

1. 启动BrowserWing
2. 从仓库下载SKILL.md
3. 导入到您的AI工具的Skills设置中
4. 开始使用自然语言命令进行自动化操作

示例：

“导航到example.com，搜索‘AI工具’，提取前5条结果”

3. 直接使用AI助手界面

利用BrowserWing内置的AI助手实现即时浏览器自动化：

1. 打开BrowserWing的Web界面，地址为http://localhost:8080
2. 进入“AI助手”部分
3. 配置您的LLM（OpenAI、Claude、DeepSeek等）
4. 开始通过对话方式进行浏览器自动化操作

导出自定义脚本：

# 将您录制的脚本导出为Skills或MCP命令
curl -X POST 'http://localhost:8080/api/v1/scripts/export/skill' \
  -H 'Content-Type: application/json' \
  -d '{"script_ids": []}' \
  -o MY_CUSTOM_SCRIPTS.md

为什么选择 BrowserWing

融合 AI 的专业浏览器自动化

• 通用协议支持：原生 MCP 和 Skills 实现可与任何兼容的 AI 工具无缝对接
• 完整的自动化 API：提供 26+ 个 HTTP 端点，覆盖全面的浏览器控制功能
• 灵活的集成方式：可作为 MCP 服务器、Skills 文件或独立的 AI 代理使用
• 可视化工作流构建器：无需编写代码即可录制、编辑和回放浏览器操作
• 高效令牌设计：针对大模型使用进行优化，性能快速且令牌消耗极低
• 生产就绪：稳定的会话管理、Cookie 处理和错误恢复机制
• 可扩展架构：将录制的脚本转换为可重用的 MCP 命令或 Skills 文件
• 多大模型支持：兼容 OpenAI、Anthropic、DeepSeek 等多家提供商
• 企业级应用场景：数据提取、RPA、测试、监控以及基于代理的自动化

使用指南

三步快速入门

1. 选择集成方式

   • 复制 MCP 服务器配置以集成到 AI 工具中
   • 下载 Skills 文件用于支持 Skills 的 AI 工具
   • 或直接使用内置的 AI 代理，即刻开始使用

2. 配置您的 AI 工具

   • 将 MCP 配置或 Skills 文件导入您偏好的 AI 工具
   • 设置大模型相关参数（API 密钥、模型选择等）
   • 验证与 BrowserWing 的连接状态

3. 开始自动化

   • 通过自然语言指令控制浏览器
   • 录制自定义脚本以执行重复性任务
   • 将脚本导出为 MCP 命令或 Skills，便于复用

高级工作流

用于浏览器自动化：

• 启动并管理多个浏览器实例
• 配置用户配置文件、代理及浏览器设置
• 处理 Cookie 和认证会话
• 执行复杂的交互序列

用于脚本录制：

• 捕捉点击、输入、导航和等待操作
• 在脚本编辑器中直观地编辑操作步骤
• 通过逐步回放进行测试和调试
• 添加变量和条件逻辑

用于 AI 集成：

• 将脚本转换为 MCP 命令或 Skills 文件
• 与多家大模型提供商集成
• 利用语义提取技术解析数据
• 构建基于代理的自动化工作流

HTTP API 参考

BrowserWing 提供 26+ 个 RESTful 端点，用于程序化控制浏览器：

导航与控制

• 跳转至指定 URL、后退/前进、刷新页面
• 管理浏览器窗口和标签页
• 处理页面加载和超时问题

元素交互

• 点击、输入、选择和悬停操作
• 文件上传和表单提交
• 快捷键和按键操作

数据提取

• 提取文本、HTML 和属性信息
• 结合大模型进行语义内容分析
• 截图功能（全页或特定元素）

高级操作

• 执行自定义 JavaScript
• 管理 Cookie 和本地存储
• 批量操作提升效率
• 等待条件与元素可见性检查

完整文档：请参阅 docs/EXECUTOR_HTTP_API.md 获取详细的端点说明。

贡献

• 欢迎提交问题和 Pull Request。请附上清晰的复现步骤或简明的理由。
• 如有功能建议，请发起讨论，并说明使用场景和预期效果。

社区

Discord：https://discord.gg/BkqcApRj
Twitter：https://x.com/chg80333

致谢

• 灵感来源于现代浏览器自动化、代理式工作流以及 MCP 技术。

许可证

• MIT 许可证。详情请参阅 LICENSE 文件。

免责声明

• 请勿用于非法目的或违反网站条款的行为。
• 本工具仅适用于个人学习和合法的自动化用途。

BrowserWing 快速上手指南

BrowserWing 是一个原生浏览器自动化平台，集成了 AI 代理功能。它支持通过自然语言控制浏览器、录制可视化脚本，并兼容 MCP (Model Context Protocol) 和 Skills 协议，可无缝对接各类 AI 工具。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统：Linux, macOS, 或 Windows
• 浏览器内核：必须安装 Google Chrome 或 Chromium，并确保其可在系统环境中被访问到。
• 网络环境：安装脚本会自动检测网络速度，优先使用 Gitee 镜像（针对中国大陆用户优化）。

安装步骤

您可以选择以下任意一种方式进行安装。推荐中国开发者使用“一键安装脚本”，它会自动选择最快的下载源。

方式一：一键安装脚本（推荐）

该脚本会自动检测操作系统架构，测试 GitHub 和 Gitee 镜像速度，并自动配置环境变量。

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

方式二：包管理器安装

使用 npm:

npm install -g browserwing

使用 pnpm:

pnpm add -g browserwing

注意：npm/pnpm 包在安装时也会自动测试并选择最快的镜像源。

⚠️ macOS 用户特别提示： 如果在运行时报错 killed，请执行以下命令移除隔离属性：

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

方式三：手动下载

前往 Releases 页面 下载对应系统的二进制文件，解压后赋予执行权限即可。

基本使用

安装完成后，只需一条命令即可启动服务。

1. 启动服务

在终端运行以下命令（默认端口为 8080）：

browserwing --port 8080

启动成功后，在浏览器中访问： http://localhost:8080

2. 快速体验自动化

您有三种方式立即开始使用 BrowserWing：

方案 A：使用内置 AI 代理（最简单）

1. 打开 Web 界面 http://localhost:8080。
2. 进入 "AI Agent" 板块。
3. 配置您的 LLM API Key（支持 OpenAI, Claude, DeepSeek 等）。
4. 直接在对话框输入自然语言指令，例如：

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

方案 B：集成到现有 AI 工具 (MCP 协议)

如果您使用 Cursor、Claude Code 或其他支持 MCP 的工具，请在配置文件中添加：

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

配置完成后，即可在 AI 编辑器中直接调用浏览器自动化能力。

方案 C：导入 Skills 文件

1. 下载 SKILL.md 文件。
2. 将其导入到支持 Skills 协议的 AI 工具设置中。
3. 通过自然语言对话控制浏览器。

3. 录制与回放

在 Web 界面中，您可以点击"Record"按钮录制浏览器操作，编辑后可直接回放，或导出为 MCP 命令/Skills 文件供 AI 重复使用。