catalog/repos/0xuniko--vibe-browser.md

AI直连真实浏览器

浏览器自动化 Chrome扩展 CDP AI工具 MCP

vibe-browser

Chrome 从 146 版本开始支持直接开启 MCP 连接，所以这个项目已经完成了它的历史使命

English

---

项目简介

vibe-browser 让 AI 直接连接你正在使用的真实浏览器实例。

它不会启动新的自动化浏览器，而是附加到当前浏览器进程，共享同一套运行时和会话状态。

因此 AI 可以直接：

• 复用登录状态
• 访问 Cookie
• 读取 Local Storage
• 操作真实标签页

无需重新登录，也无需同步环境。

这是 vibe-browser 与市面同类浏览器自动化工具最大的区别。

项目不使用 Playwright，而是直接基于 Chrome DevTools Protocol（CDP）实现，提供更底层、更轻量的控制能力。

---

快速开始

1. 构建扩展

cd extension
bun install
bun run build

浏览器加载：

extension/.output/chrome-mv3

开启扩展并切换为 Active。

---

2. 为你的项目添加 skill

bunx skills add https://github.com/0xUniko/vibe-browser

---

3. 启动 relay

bun skill/scripts/relay.ts

默认地址：

http://127.0.0.1:9111

连接成功后扩展里会显示：

Connected to relay

---

技术架构

• extension/
  Chromium 扩展（WXT + TypeScript + effect）
  负责 CDP 控制、Tab 路由和事件转发

• skill/
  本地 Relay 服务（对外 HTTP + SSE）
  连接你的工具 / 脚本 / AI 与扩展

---

Relay 接口（默认）

• 健康检查：GET /health
• 发送命令：POST /command
• 事件流（SSE）：GET /events

环境变量：

SKILL_HOST
SKILL_PORT
SKILL_REQUEST_TIMEOUT_MS
SKILL_HEALTH_PROBE_TIMEOUT_MS

---

常见问题（阻塞/超时）

• 不要一次做非常"重"的操作：尽量拆成多次小操作，并且每次都等上一条命令返回后再发下一条。
• GET /health 只能说明"可连通/可快速探测"，并不能保证当前没有长任务在跑或扩展没有被卡住。
• 如果 POST /command 经常超时（默认 15s），大概率是扩展端被长任务卡住或调试链路拥塞；此时停止继续发命令，去浏览器手动刷新扩展（chrome://extensions 或 edge://extensions 里找到 vibe-browser 点刷新/重载），再重新切到 Active。

待办事项

• 优化架构和实现细节，以节省 token 并降低对模型智力的要求

许可证

MIT