browserwing

环境要求

• Node.js 环境（使用 npm/pnpm 安装方式时需要）
• macOS / Linux / Windows 任一台可联网的机器
• 如需从源码构建：本机需安装 Go 与 pnpm
• 已安装 Chrome 浏览器（README 提到安装流程包含 Chrome setup）

安装与启动步骤

1. 1选择安装方式

   README 提供 npm、pnpm、Homebrew、一行安装脚本四种方式，任选其一即可；也可让 AI 代理按 INSTALL.md 自动安装。

2. 2npm 全局安装

   这是 README 推荐的包管理器安装方式，安装过程会自动测速并选择 GitHub 或 Gitee 最快的镜像。

   npm install -g browserwing

   复制

3. 3启动服务

   用 --port 指定监听端口，README 示例统一使用 8080，可按需改成其他端口。

   browserwing --port 8080

   复制

4. 4运行内置脚本

   BrowserWing 内置 78 个脚本，可直接输出结构化数据，配合 jq 还能截取前几条结果。

   browserwing run github-trending
   browserwing run bilibili-hot
   browserwing run hackernews-top | jq '.[0:5]'

   复制

5. 5macOS 报错修复

   若 macOS 运行时报 killed，用该命令去掉隔离属性即可；详细说明见官方 macOS 安装修复文档。

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

   复制

6. 6接入 AI 工具

   复制 MCP 配置或下载 Skills 文件导入 AI 工具，并填写 LLM 的 API Key 与模型，确认能连上 BrowserWing。

7. 7源码构建（可选）

   仅在需要从源码运行时使用，需本机具备 Go 与 pnpm，README 给出的构建命令为 make install。

   make install

   复制

8. 8一行脚本安装（可选）

   替代 npm 的安装方式，脚本会自动识别系统架构、测速镜像、下载二进制并写入 PATH。

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

   复制

关键配置

如何确认成功

启动命令无报错即视为服务已运行；再执行 browserwing run github-trending 能返回 JSON 数据即接入正常。

常见问题

注意事项

• README 的端口 8080 仅为示例，可用 --port 自行更换。
• 安装脚本会访问 GitHub 与 Gitee，网络受限时建议优先用自动测速的安装方式。
• 从源码构建需要 Go 与 pnpm 两套环境，普通用户建议直接用 npm 或安装脚本。
• LLM 的 API Key 与模型选择在 AI 工具侧的 MCP/Skills 配置中填写，注意不要泄露密钥。