快速开始
BrowserWing 快速入门指南，包含多种安装方式与 AI 工具集成教程
1. 环境要求
- 环境中需安装 Google Chrome 或 Chromium，并确保可正常访问。
2. 安装 BrowserWing
我们提供多种安装方式，推荐使用包管理器或一键脚本。
方式 A — 通过包管理器安装（推荐）
使用 npm：
npm install -g browserwing
browserwing --port 8080使用 pnpm：
pnpm add -g browserwing
browserwing --port 8080提示：npm 包在安装时会自动测试 GitHub 和 Gitee 镜像，选择最快的源进行下载。
使用 Homebrew (macOS/Linux)：
# 即将支持
brew install browserwing方式 B — 一键安装脚本
Linux / macOS：
curl -fsSL https://raw.githubusercontent.com/browserwing/browserwing/main/install.sh | bashWindows (PowerShell)：
iwr -useb https://raw.githubusercontent.com/browserwing/browserwing/main/install.ps1 | iex脚本功能：
- 自动检测系统和架构
- 测试 GitHub 和 Gitee 镜像，智能选择最快下载源
- 下载并解压二进制文件
- 自动添加到 PATH 环境变量
安装完成后启动：
browserwing --port 8080
# 启动后在浏览器中打开 http://localhost:8080方式 C — 手动下载
从 Releases 下载对应操作系统的预构建二进制文件。国内用户如果 GitHub 下载慢，可访问 Gitee Releases。
运行命令：
# Linux/macOS
chmod +x ./browserwing
./browserwing --port 8080
# Windows (PowerShell)
.\browserwing.exe --port 8080macOS 安全提示： 如果是 macOS 用户，运行可能出现"软件已被破坏"或"无法验证开发者"的提示。 解决方法：在 设置 -> 隐私与安全性 中，点击 仍然允许。
方式 D — 源码构建
适合开发者或需要自定义功能的用户。
# 安装依赖（需要 Go 与 pnpm）
make install
# 构建集成版本（前端嵌入后端）
make build-embedded
./build/browserwing --port 8080
# 或构建全部目标并打包
make build-all
make package3. 快速集成到 AI 工具
BrowserWing 提供了三种灵活的使用方式，让您的 AI 模型立即获得浏览器操作能力。
方式 1：MCP 服务器集成
适用于 Cursor、Claude Desktop 等支持 MCP (Model Context Protocol) 的工具。
配置如下：
{
"mcpServers": {
"browserwing": {
"type": "http",
"url": "http://localhost:8080/api/v1/mcp/message"
}
}
}将此配置添加到您的 AI 工具 MCP 设置中，即可启用浏览器自动化能力。
方式 2：Skills 文件集成
适用于支持 Skills 协议的 AI 工具。
- 启动 BrowserWing。
- 下载 SKILL.md。
- 将文件导入到 AI 工具的 Skills 设置中。
- 使用自然语言命令开始自动化。
示例指令：
"访问淘宝，搜索 'MacBook'，提取前 5 个商品的价格"
方式 3：直接使用内置 AI Agent
BrowserWing 自带了可视化的 AI Agent 界面。
- 打开浏览器访问：
http://localhost:8080。 - 进入 AI Agent 页面。
- 配置 LLM（支持 OpenAI、Claude、DeepSeek 等）。
- 建议使用支持 Function Calling 且性能较强的模型（如 DeepSeek-V3），以获得更稳定的效果。
- 在对话框中输入需求，开始自动化。
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 启动的浏览器手动登录。
- 或从您日常使用的 Chrome 浏览器导出 Cookie，在 BrowserWing 的 Cookie 管理页导入。
