browser-bridge

Browser Bridge

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

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

项目结构

快速开始

1. 启动 server

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

./scripts/build.sh              # 首次先构建
./scripts/server.sh start       # 后台启动（start|stop|restart|status|logs）
./scripts/server.sh status

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

cd server
cargo run            # 默认监听 ws://127.0.0.1:9225（MCP over HTTP 另开 9226）
# 换端口：BRIDGE_PORT=9226 cargo run
# 关闭 HTTP MCP：BRIDGE_HTTP_PORT=0 cargo run

2. 加载插件

cd extension
pnpm install
pnpm dev             # 会自动打开 Chrome 并加载开发版插件

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

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

3. 使用 client

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

cd client
cargo run -- list-tabs
cargo run -- --window 5 list-tabs
cargo run -- navigate https://example.com
cargo run -- click '#submit'
cargo run -- set_value '#username' alice
cargo run -- scrape 'div.card' --fields 'name:.name,price:.price,img:img@src'
cargo run -- querydomains 'browserbridge'
cargo run -- googlesearch 'Haze Seas'
cargo run -- redditsearch 'rust programming'
cargo run -- youtubesearch 'rust programming' --time week --sort popularity --max 10
cargo run -- youtubeinfo 'https://www.youtube.com/watch?v=rQ_J9WH6CGk'
cargo run -- youtuberinfo 'https://www.youtube.com/@xiaojunpodcast/videos'
cargo run -- youtuberinfo '@xiaojunpodcast' --max 20
cargo run -- googletrends 'ai image' --date 'today 1-m' --geo Worldwide
cargo run -- oldgoogletrends 'ai image detector' --date 'now 7-d' --geo Worldwide
cargo run -- googletrends-compare 'ai image' 'GPTs' --date 'today 1-m'
cargo run -- oldgoogletrends-compare 'coffee' 'tea' --date 'now 7-d'
cargo run -- get-page-markdown --url https://example.com
cargo run -- get-a11y-tree
cargo run -- screenshot --out shot.png

指令速查表

多数指令支持 --tab <id> 指定标签页，默认操作当前激活页。

标签页管理：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-<pid>-<nanos>），只清理本进程创建的标签页，不会误关其他 agent 正在用的标签页；任务结束后可再调 close_agent_window 关闭自己的专用窗口（连同窗口内标签页一并释放）
• CLI（close-auto-tabs）：作为人工管理入口，清理全部自动标签页（不管是谁创建的）

会被清理的：new-tab 指令和 click --new-tab 创建的标签页（扩展记录在 chrome.storage.session，service worker 重启不丢）。例如 googletrends 每次查询都会新开一个标签页，跑完后清理效果最明显：

cargo run -- googletrends 'ai image'
cargo run -- close-auto-tabs   # 关闭刚才 googletrends 开的标签页

不会被清理的：手动开的标签页（如 Sitemap Monitor）、以及 navigate / googlesearch / redditsearch 复用的当前标签页（这些不新开 tab，属于"工作标签页"，留着是正常的）。

get-page-markdown

Read the full README on GitHub →