Local browser bridge for agents

让 AI 接管真实 Chrome

Chrome Bridge 把 Agent 指令转成浏览器内动作它使用本地 daemon、Chrome 扩展和 WebSocket 桥接真实标签页，让自动化拥有登录态、截图、网络观测和可调试结果

查看使用方式浏览能力
chrome://bridge/session/demo

Current tool

snapshot → click → fill

$ navigate https://console.example.com

$ snapshot 返回 @e 引用

$ fill @e42 campaign_id

$ screenshot ./review.png

Status

daemon

running: true

extension

connected

session

demo

Architecture map

Chrome Bridge 架构图

Capabilities

能做浏览器里真正发生的事

真实浏览器控制

导航、点击、输入、按键、鼠标事件都发生在用户自己的 Chrome 标签页里

读取页面状态

通过 accessibility snapshot 获取结构化页面树，优先使用稳定元素引用

截图与 PDF

页面截图、元素截图和 PDF 导出写入本地文件，适合审阅、归档和交付

网络与 CDP

查看请求响应，必要时调用 Chrome DevTools Protocol 做深层调试

上传文件

把本地文件传入网页表单，覆盖后台配置、素材提交等重复流程

多会话隔离

不同任务使用不同 session，标签组隔离，复杂工作流不会互相污染

Install

安装 daemon 和浏览器扩展

Chrome Bridge 由本地 daemon 与 Chrome 扩展组成。daemon 暴露 127.0.0.1:10089 HTTP API，扩展通过 WebSocket 接入并在真实标签页里执行动作。

本地 daemon

负责接收 Agent 指令、维护 session、转发工具调用并保存截图或 PDF 输出。

连接校验

status 同时显示 daemon 运行状态和扩展连接状态，便于快速定位安装问题。

1

第一步:安装本地 daemon

macOS / Linux

curl -fsSL https://github.com/zhaocore/chrome-bridge/raw/refs/heads/master/install.sh | bash

Windows PowerShell

irm https://github.com/zhaocore/chrome-bridge/raw/refs/heads/master/install.ps1 | iex
2

第二步:安装浏览器扩展

Chrome Web Store - ChromeBridge~/.chrome-bridge/bin/chrome-bridge status

当 running: true 和 extension_connected: true 同时出现，说明 Agent 可以开始调用浏览器工具。

Quick start

三步跑通

先确认本地服务，再让扩展连接，最后由 Agent 通过 HTTP API 发起动作健康状态明确，失败也能从 status 和 logs 定位

1

启动本地守护进程

守护进程暴露 127.0.0.1:10089，负责接收 Agent 指令

~/.chrome-bridge/bin/chrome-bridge start
2

连接 Chrome 扩展

扩展通过 WebSocket 接入 daemon，并在浏览器内执行动作

~/.chrome-bridge/bin/chrome-bridge status
3

让 Agent 调用工具

Agent 发送 navigate、snapshot、click、fill、screenshot 等动作

POST http://127.0.0.1:10089/command

Use cases

适合高摩擦网页工作流

不是无头浏览器替代品它面向需要真实登录态、真实页面和本地可控边界的 Agent 自动化

运营后台批量配置

打开真实后台，读取已有配置，上传素材，填写活动参数，再截图留档

减少人工重复点击，保留可审计结果

网页登录态自动化

复用用户当前登录态处理需要 SSO、验证码后置页面或内部权限的站点

不用把账号密码交给脚本

页面验收与资料抓取

读取页面结构、抓网络请求、保存 PDF，对复杂网页产出结构化结果

适合 QA、内容归档和竞品研究

电商比价与库存检查

在多个站点搜索商品，读取价格、优惠、库存和详情页链接，再整理成可比较结果

复用真实账号和地区化页面

招聘信息筛选

打开招聘站点，按关键词、地点、薪资和公司信息筛选职位并保存来源链接

把重复搜索变成结构化清单

网页归档与交付

对关键页面批量截图或导出 PDF，保留页面在指定时间点的状态

交付物直接落到本地文件

Architecture

边界清楚，链路短

Agent 调用本地 HTTP API；daemon 校验工具参数、维护会话状态、转发到扩展；扩展在 Chrome 内执行动作，再把结果回传给 daemon

Agent
HTTP API
WebSocket Bridge
Chrome Extension
Real Browser Tab

页面动作

navigate / click / fill / send_keys / mouse_click

页面读取

snapshot / evaluate / network / cdp

文件输出

screenshot / save_as_pdf / upload

标签管理

find_tab / list_tabs / close_tab / close_session