BrowserZap
让你电脑上的人工智能代理使用你自己的Chrome浏览器——你的标签，你的登录——而你观看并保持控制。
网站和文档： https://browserzap.com/docs ·联系: [email protected] ·安全: [email protected]
BrowserZap将MCP代理（Claude Code, Codex CLI, Cursor，…）连接到您已经使用的Chrome。没有云 浏览器，没有复制的cookie，没有新的登录：代理在您的真实选项卡中工作，您可以看到每一步。
- 确切的，不是近似的。 每次单击和填充都按照角色和名称解析为一个元素。如果两个 元素匹配，什么都不发生，代理被告知是哪个。
- 你赞成重要的事情。 提交，付款，删除，帖子和文件上传等待 批准后 在 侧板。
- 你的密码是你的。 代理从不输入密码、一次性代码或卡号。页面问你 (轮到你 → 完成)，并且您键入的内容永远不会被记录。
- 随时停止。 页面上的药丸和侧板上的开关可以立即收回标签。
- 评论模式。 点击任何一页上的错误，写下注释，并立即将每个注释发送给您的编码代理 包含组件、源文件和每个元素的屏幕截图。
- 用代理调试。 它自己读取页面的控制台错误和失败的网络请求。
- 记录一次，重播多次。 将任务保存为工作流，然后使用新值重新运行它，一步一步地进行检查。
要求
- Windows 10或11（暂不支持macOS和Linux）
- 谷歌Chrome （Microsoft Edge也可以）
- Node.js 22或更新版本；24推荐(https://nodejs.org）
- MCP客户端：Claude Code、Codex CLI、Cursor或其他
安装
-
从Chrome网络商店添加扩展： https://chromewebstore.google.com/detail/bbnmhaonicbmljhbahimpgfafbjoijpe． Chrome会为你更新它。
-
安装配套程序 （网桥和MCP服务器；它需要Node.js 22或更新）：
npm install -g browserzap -
运行setup一次：
browserzap setup
browserzap setup 做两件事，再跑一次就安全了：
- 为您的Windows用户注册一个Chrome和Edge的小助手（没有管理员权限），所以 扩展连接自己，可以启动同伴程序。没有令牌可以复制。
- 查找Claude Code， Codex CLI和Cursor，显示它将为BrowserZap添加的确切条目，并仅在之后添加它
你回答
y.
npm包附带了桥、本机帮助器和MCP服务器 不 这个扩展。如果分机是
尚未安装， setup 打印商店链接。
单击BrowserZap图标打开侧板。当它连接时，它会变成绿色。检查所有的东西：
browserzap doctor
在WSL中使用Claude代码？BrowserZap停留在Windows上；在WSL中运行
claude mcp add browserzap -- cmd.exe /c browserzap (细节: https://browserzap.com/docs/platforms）。
开发人员
从源代码签出， npm run build 还在写 extension/，你可以装载 负载打开 在
chrome://extensions (打开 开发人员模式）. 运行 browserzap setup --dev 因此，助手接受该构建；
setup 没有 --dev 只能返回到商店扩展。在没有全局安装的情况下进行签出也是一样的
命令 node bridge-server/index.js setup --dev.
使用它
重新启动MCP客户端，在浏览器中请求一些东西，例如： 打开example.com，告诉我 主标题上写着。 如果Chrome是关闭的，第一个浏览器请求打开它。
当代理工作时，一个小光标显示它的作用位置，页面顶部的一个药丸表示代理的位置 工作，它的标签位于标签 BrowserZap TAB组，它在完成后清除该组。新闻 停止 在 药丸，或开关控制在侧板，接管。
可以尝试的事情：
- “在维基百科上搜索‘模型上下文协议’，总结第一段。”
- “在我的GitHub通知中，列出本周未读的邮件。” （使用您现有的登录名）
- “在本页的联系表格中填写我的详细信息，但在发送之前让我批准。”
- “在localhost:3000上打开我的应用程序，单击Save，并告诉我为什么失败-检查控制台和网络。”
- 侧板： 评论→对此页面的评论点击一些元素，写笔记， 发送，然后告诉你 代理 “应用我的BrowserZap反馈”.
每个工具和选项： https://browserzap.com/docs/tools.
故障排除
从……开始 browserzap doctor每一行失败的台词都告诉我们该怎么做。
| 你看到 | 这样做 |
|---|---|
| 侧板保持灰色或说 还没有配对 | 运行 browserzap setup，然后重新加载扩展 chrome://extensions |
| 医生: 具有不同配对秘密的桥接器持有127.0.0.1:9334 | browserzap restart-bridge,然后 重新连接 在侧板上 |
| 医生: 启动器找到Node和helper 失败 | Node moved（与fnm、Volta或nvm的版本切换）：run browserzap setup 再次 |
| 医生: 没有阻止Chrome政策 失败 | 您的计算机已被管理；请IT部门允许这个帮手 com.browserzap.bridge 而扩展 |
| Chrome说 禁用开发人员模式扩展 在启动 | 只有开发者的未打包副本：选择 保持． Chrome Web Store的安装从未显示它 |
| 一个酒吧说 “BrowserZap”开始调试这个浏览器 | 代理人可以行动时预期的；当代理结束或空闲一分钟后，它就会消失 |
| 您的代理没有列出BrowserZap的工具 | 然后重新启动代理应用程序 browserzap setup． 手工添加， browserzap --help 打印精确的MCP配置 |
| 一步止于 “需要你” | 该页面要求输入密码、代码或批准。照做，按 完成，代理继续 |
| 别的 | 电子邮件 [email protected] 输出为 browserzap doctor （不包含密码或页面内容） |
更多: https://browserzap.com/docs/troubleshooting.
命令
| 命令 | 它是做什么的 |
|---|---|
browserzap setup | 一次性设置（如上）。再次安全运行 |
browserzap doctor | 检查helper注册，启动器，Chrome策略，扩展id和连接 |
browserzap restart-bridge | 替换不能配对的桥接器（另一个安装的秘密或旧版本） |
browserzap run <workflow> --params rows.csv | 运行没有代理的已保存工作流（免费计划中的一行） |
browserzap uninstall | 删除助手注册（以及开发人员的未打包副本）；保存您的数据 |
browserzap uninstall --purge | 还会删除BrowserZap数据文件夹（无法撤消） |
环境变量（允许的站点，配置文件，上传文件夹，保留，…）： https://browserzap.com/docs/configuration.
更新
npm install -g browserzap@latest
browserzap setup
Chrome更新扩展从Chrome网络商店自己。您的工作流、运行报告和设置将被保留。
如果扩展程序比配套程序老，代理的状态结果显示：Chrome自行重试，或
开放 chrome://extensions 并按 更新.
免费和专业版
每一个实时浏览器工具，评论模式，控制台和网络阅读，每一个安全控制是免费的；今天到 保存的工作流也是免费的。BrowserZap Pro -大规模自动化：多行工作流程，后台运行， 历史和运行报告-即将到来，作为每月，每年或终身许可证。计划如有变动，将于当日公布 https://browserzap.com 第一。安全控制从来不是付费功能。
隐私
BrowserZap在您的机器上运行。它没有云服务，没有账户，没有遥测，没有分析。这座桥
只听 127.0.0.1 并且只接受经过身份验证的连接。表单值、密码和cookie永远不会
记录;评论模式截图覆盖密码和卡片字段，并留在您的计算机上。代理在一个
页面将转到您连接的AI客户端，根据该客户端的条款。完整的政策: https://browserzap.com/privacy.
已知的限制
- 目前只支持Windows （Chrome或Edge）。已规划macOS和Linux操作系统。
chrome://网页和Chrome网络商店不能自动化。- Canvas应用程序、一些自定义小部件和跨域框架可能需要你执行这个步骤。
- 在背景选项卡中，点击是在页面内部进行的；一个网站，需要一个真正的用户点击需要标签在前面。
- 风险检测是启发式的。批准就是因为这个原因。
执照
BrowserZap是专有软件，可以免费使用。看到 LICENSE． 它包括以下代码
打开浏览器控制（MIT）；看到 LICENSE-UPSTREAM 和 THIRD_PARTY_NOTICES.md.