browser-bridge

Browser Bridge

通过 WebSocket 把本地工具和真实浏览器连接起来的桥，不需要 CDP。

扩展安装在浏览器里，作为"手"；server 是本地的 WebSocket 枢纽；client 是发指令的入口（Rust CLI），也可通过 bridge-mcp 暴露给 Claude / Cursor 等 agent。 项目结构 快速开始 1. 启动 server

推荐用管理脚本后台常驻（server 不会自动退出，多个 agent 共享同一个进程）：

也可以前台跑，方便看日志：

2. 加载插件

也可以 pnpm build 后，在 chrome://extensions 打开"开发者模式"，加载 extension/dist/chrome-mv3 目录。

点击扩展弹窗里的「任务面板」，或从 Chrome 侧边栏打开 Browser Bridge，可以看到当前窗口里正在执行和排队的任务。排队数据在 bridge-server 上，server 与扩展需要一起升级。 3. 使用 client

client 连接失败时会自动拉起 bridge-server（需要已构建的二进制，可用 BRIDGE_SERVER_BIN 指定路径）；插件断线后按 500ms→5s 退避自动重连。

指令速查表 多数指令支持 --tab 指定标签页，默认操作当前激活页。

标签页管理：click 点击锚点链接默认在当前标签页打开（自动覆盖 target="_blank"），需要新开时用 --new-tab（由扩展创建标签页，响应会返回新标签页的 tab_id，便于链式操作）。new-tab 指令和 click --new-tab 打开的标签页都会被扩展记录，流程结束后可用 close-auto-tabs 一键清理，不会误关你手动打开的标签页。 close-auto-tabs

清理"自动打开的标签页"，需要单独执行（CLI 手动调用，或 MCP 流程在收尾时调用一次），不会误关手动打开的标签页。支持多 agent 隔离： MCP（close_auto_tabs 工具）：每个 MCP 进程启动时生成独立身份（mcp- - ），只清理本进程创建的标签页，不会误关其他 agent 正在用的标签页；任务结束后可再调 close_agent_window 关闭自己的专用窗口（连同窗口内标签页一并释放） CLI（close-auto-tabs）：作为人工管理入口，清理全部自动标签页（不管是谁创建的）