# browserzap 中文文档 规范地址：https://npmcn.com/package/browserzap/ 版本：0\.7\.0 npm 元数据更新时间：2026-11-03T04:22:38.146Z 中文译文更新时间：2026-11-03T06:29:26.368Z 软件包许可：SEE LICENSE IN LICENSE 本文由上游 README 机器翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/browserzap 原文对照：https://npmcn.com/package/browserzap/?lang=original 项目主页：https://browserzap.com/ ## 关键信息（来自 npm 元数据） - 包体积（解压后）：462 kB，34 个文件 - TypeScript 类型：未声明 - Node.js 要求：\>=22 - 运行依赖：1 个 - 首次发布：2026-10-28T05:21:48.053Z - 最新版本发布：2026-11-03T04:22:37.976Z - 已发布版本数：8（近 12 个月 8 个） ## 中文简介 让你的AI代理（Claude Code, Codex， Cursor或任何MCP客户端）在你自己的Chrome中工作，你的登录，你的批准和一个停止按钮。 ## 安装 ```sh npm install browserzap ``` 也可以使用：`pnpm add browserzap`、`yarn add browserzap`、`bun add browserzap` ## README # BrowserZap **让你电脑上的人工智能代理使用你自己的Chrome浏览器——你的标签，你的登录——而你观看并保持控制。** 网站和文档： [https://browserzap.com/docs](https://browserzap.com/docs) ·联系: [hello@browserzap.com](mailto:hello@browserzap.com) ·安全: [security@browserzap.com](mailto:security@browserzap.com) BrowserZap将MCP代理（Claude Code, Codex CLI, Cursor，…）连接到您已经使用的Chrome。没有云 浏览器，没有复制的cookie，没有新的登录：代理在您的真实选项卡中工作，您可以看到每一步。 - **确切的，不是近似的。** 每次单击和填充都按照角色和名称解析为一个元素。如果两个 元素匹配，什么都不发生，代理被告知是哪个。 - **你赞成重要的事情。** 提交，付款，删除，帖子和文件上传等待 **批准后** 在 侧板。 - **你的密码是你的。** 代理从不输入密码、一次性代码或卡号。页面问你 (**轮到你** → **完成**)，并且您键入的内容永远不会被记录。 - **随时停止。** 页面上的药丸和侧板上的开关可以立即收回标签。 - **评论模式。** 点击任何一页上的错误，写下注释，并立即将每个注释发送给您的编码代理 包含组件、源文件和每个元素的屏幕截图。 - **用代理调试。** 它自己读取页面的控制台错误和失败的网络请求。 - **记录一次，重播多次。** 将任务保存为工作流，然后使用新值重新运行它，一步一步地进行检查。 ## 要求 - Windows 10或11（暂不支持macOS和Linux） - 谷歌Chrome （Microsoft Edge也可以） - Node.js 22或更新版本；24推荐([https://nodejs.org](https://nodejs.org/)） - MCP客户端：Claude Code、Codex CLI、Cursor或其他 ## 安装 1. **从Chrome网络商店添加扩展：** [https://chromewebstore.google.com/detail/bbnmhaonicbmljhbahimpgfafbjoijpe](https://chromewebstore.google.com/detail/bbnmhaonicbmljhbahimpgfafbjoijpe)． Chrome会为你更新它。 2. **安装配套程序** （网桥和MCP服务器；它需要Node.js 22或更新）： ```cmd npm install -g browserzap ``` 3. **运行setup一次：** ```cmd browserzap setup ``` `browserzap setup` 做两件事，再跑一次就安全了： 1. 为您的Windows用户注册一个Chrome和Edge的小助手（没有管理员权限），所以 扩展连接自己，可以启动同伴程序。没有令牌可以复制。 2. 查找Claude Code， Codex CLI和Cursor，显示它将为BrowserZap添加的确切条目，并仅在之后添加它 你回答 `y`. npm包附带了桥、本机帮助器和MCP服务器 **不** 这个扩展。如果分机是 尚未安装， `setup` 打印商店链接。 单击BrowserZap图标打开侧板。当它连接时，它会变成绿色。检查所有的东西： ```cmd browserzap doctor ``` 在WSL中使用Claude代码？BrowserZap停留在Windows上；在WSL中运行 `claude mcp add browserzap -- cmd.exe /c browserzap` (细节: [https://browserzap.com/docs/platforms](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](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配置 | | 一步止于 _“需要你”_ | 该页面要求输入密码、代码或批准。照做，按 **完成**，代理继续 | | 别的 | 电子邮件 [hello@browserzap.com](mailto:hello@browserzap.com) 输出为 `browserzap doctor` （不包含密码或页面内容） | 更多: [https://browserzap.com/docs/troubleshooting](https://browserzap.com/docs/troubleshooting). ## 命令 | 命令 | 它是做什么的 | | --- | --- | | `browserzap setup` | 一次性设置（如上）。再次安全运行 | | `browserzap doctor` | 检查helper注册，启动器，Chrome策略，扩展id和连接 | | `browserzap restart-bridge` | 替换不能配对的桥接器（另一个安装的秘密或旧版本） | | `browserzap run --params rows.csv` | 运行没有代理的已保存工作流（免费计划中的一行） | | `browserzap uninstall` | 删除助手注册（以及开发人员的未打包副本）；保存您的数据 | | `browserzap uninstall --purge` | 还会删除BrowserZap数据文件夹（无法撤消） | 环境变量（允许的站点，配置文件，上传文件夹，保留，…）： [https://browserzap.com/docs/configuration](https://browserzap.com/docs/configuration). ## 更新 ```cmd npm install -g browserzap@latest browserzap setup ``` Chrome更新扩展从Chrome网络商店自己。您的工作流、运行报告和设置将被保留。 如果扩展程序比配套程序老，代理的状态结果显示：Chrome自行重试，或 开放 `chrome://extensions` 并按 **更新**. ## 免费和专业版 每一个实时浏览器工具，评论模式，控制台和网络阅读，每一个安全控制是免费的；今天到 保存的工作流也是免费的。BrowserZap Pro -大规模自动化：多行工作流程，后台运行， 历史和运行报告-即将到来，作为每月，每年或终身许可证。计划如有变动，将于当日公布 [https://browserzap.com](https://browserzap.com/) 第一。安全控制从来不是付费功能。 ## 隐私 BrowserZap在您的机器上运行。它没有云服务，没有账户，没有遥测，没有分析。这座桥 只听 `127.0.0.1` 并且只接受经过身份验证的连接。表单值、密码和cookie永远不会 记录;评论模式截图覆盖密码和卡片字段，并留在您的计算机上。代理在一个 页面将转到您连接的AI客户端，根据该客户端的条款。完整的政策: [https://browserzap.com/privacy](https://browserzap.com/privacy). ## 已知的限制 - 目前只支持Windows （Chrome或Edge）。已规划macOS和Linux操作系统。 - `chrome://` 网页和Chrome网络商店不能自动化。 - Canvas应用程序、一些自定义小部件和跨域框架可能需要你执行这个步骤。 - 在背景选项卡中，点击是在页面内部进行的；一个网站，需要一个真正的用户点击需要标签在前面。 - 风险检测是启发式的。批准就是因为这个原因。 ## 执照 BrowserZap是专有软件，可以免费使用。看到 `LICENSE`． 它包括以下代码 打开浏览器控制（MIT）；看到 `LICENSE-UPSTREAM` 和 `THIRD_PARTY_NOTICES.md`. ## 常见问题 ### browserzap 是什么？ 让你的AI代理（Claude Code, Codex， Cursor或任何MCP客户端）在你自己的Chrome中工作，你的登录，你的批准和一个停止按钮。 ### 如何安装 browserzap？ 在项目目录运行 npm install browserzap，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 browserzap，可以用 npx browserzap 直接运行。 ### browserzap 支持 TypeScript 吗？ 该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/browserzap 是否存在。 ### browserzap 需要什么版本的 Node\.js？ package\.json 的 engines 字段要求 Node\.js \>=22。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。 ### browserzap 可以商用吗？ browserzap 使用 SEE LICENSE IN LICENSE 许可。许可条款写在包内的独立文件中，请阅读该文件确认可否商用。以上为概括，不构成法律意见，请以许可原文为准。 ### browserzap 还在维护吗？ 最新版本 0\.7\.0 发布于 2026/11/03（今天）；至今共发布 8 个版本，其中过去 12 个月发布了 8 个；首次发布于 2026/10/28。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。