OpenBridge

在 AI Agent 逐渐具备自主操作能力的今天，如何安全、高效地让它们控制用户的真实浏览器成为一个关键问题。OpenBridge 是一个开源的本地浏览器桥接项目，它采用类似 Kimi WebBridge 的三层架构，通过本地 Daemon 服务与 Chrome 扩展配合，让 AI Agent（如 Claude Code, Codex, OpenCode 等）能够无缝操控真实的 Chrome 标签页。

核心架构：三层解耦，安全隔离

OpenBridge 采用经典的 Client – Daemon – Extension 架构：

1. AI 客户端 / MCP 客户端 / Codex Skill：作为指令发起方，通过 stdio MCP 或本地 HTTP API 发送命令。
2. OpenBridge Daemon：长期运行的本地后台服务，监听 127.0.0.1 回环地址，负责接收指令并转发给扩展。
3. OpenBridge Chrome 扩展：运行在用户浏览器中，执行具体操作（点击、输入、截图等），并将结果返回。

优势：

• 连接复用：一个浏览器连接可被多个本地 AI 会话复用，无需重复授权。
• 安全隔离：只监听本机回环地址，扩展仅连接本地 Daemon，杜绝远程攻击风险。

功能亮点：全栈浏览器控制

1. 全面的标签页管理

• 创建、导航、选择、列出、关闭标签页。
• 基于 Session 的标签组管理，支持颜色区分，便于多任务并行。

2. 精细的交互操作

• 鼠标操作：普通点击、坐标点击。
• 键盘操作：填写表单、输入文本、按键及快捷键模拟。
• 文件操作：上传文件、导出 PDF、截图保存。

3. 深度页面感知

• 可访问性快照：获取基于节点的页面结构信息，帮助 AI 理解页面布局。
• 网络监听：观察网络请求事件，捕捉 API 响应。
• JavaScript 执行：可选开启 browser_evaluate，执行自定义 JS 代码（默认关闭，需用户显式授权）。

4. 安全与隐私保护

• 自动授权：首次连接后自动 Pairing，日常使用无需手动点击确认。
• 暂停控制：可在扩展 Popup 中随时暂停 AI 控制，夺回浏览器主权。
• 本地运行：所有数据仅在本地流转，配对 Token 不提交至仓库，.openbridge-data/ 自动加入 Git 忽略。

快速开始：一键安装与配置

1. 推荐安装（网络脚本）

curl -fsSL https://raw.githubusercontent.com/60ke/openBridge/master/install.sh | bash

脚本将自动安装依赖、构建 Daemon 和扩展、启动服务，并安装 Codex Skill。

2. 手动安装（更安全，建议审查代码）

git clone https://github.com/60ke/openBridge.git
cd openBridge
pnpm install
pnpm build
# 启动 daemon
node packages/daemon/dist/cli/index.js serve

3. 加载 Chrome 扩展

1. 打开 Chrome，进入 chrome://extensions。
2. 开启“开发者模式”。
3. 点击“加载已解压的扩展程序”，选择目录：packages/extension/.output/chrome-mv3。
4. 扩展 Popup 显示 Authorized 即表示连接成功。

不同 Agent 的接入方式

OpenBridge 提供两条主要接入路径：Skill + Local API（默认推荐）和 MCP Stdio。

常用 API 命令示例

健康检查：

curl -s "http://127.0.0.1:10088/health"

列出所有标签页：

curl -s -X POST "http://127.0.0.1:10088/command" \
  -H 'Content-Type: application/json' \
  -d '{"toolName":"browser_list_tabs","args":{}}'

导航到新页面：

curl -s -X POST "http://127.0.0.1:10088/command" \
  -H 'Content-Type: application/json' \
  -d '{"toolName":"browser_navigate","args":{"url":"https://example.com"}}'

OpenBridge 为 AI Agent 提供了一座通往真实浏览器的安全、开放、标准化的桥梁。它不仅兼容主流的 MCP 协议，还针对 Codex 等新兴 Agent 框架提供了优化的 Skill 集成方案。