Chrome Relay

这是什么？适合谁？

Chrome Relay 是一个让 AI Agent 驱动你已登录的 Chrome 浏览器的 Skill。通过本地 CLI 桥，Agent 可以直接操作你当前打开的 Chrome 浏览器——保持 cookies、SSO、扩展、localhost 连接全部有效。

与 Playwright 等浏览器自动化的本质区别：Playwright 启动的是一个干净的浏览器实例（无登录态），Chrome Relay 驱动的是你自己的 Chrome（所有登录态完整保留）。

适合人群：需要自动化操作需要登录的 Web 应用的开发者、测试工程师、SSO 环境下的自动化场景。

使用前提：Chrome 浏览器、Chrome Relay 扩展、支持 SKILL.md 的 Agent 工具。

准备工作

• 安装 Agent 工具：Claude Code / Codex CLI / Cursor
• 安装 Chrome Relay 扩展（Chrome Web Store）
• 安装 Skill：npx skills add chrome-relay
• 价格：开源免费
• 时间预算：5 分钟安装配置

3 步快速上手

第 1 步：安装扩展 + Skill

在 Chrome Web Store 搜索 “Chrome Relay” 安装扩展。 然后在终端：

npx skills add chrome-relay

第 2 步：启动桥接

chrome-relay start

这会在本地启动一个 CLI 桥，Agent 通过它与你的 Chrome 通信。

第 3 步：让 Agent 操作浏览器

在 Agent 中输入：

• “帮我检查 GitHub issues 页面，列出所有 assigned to me 的 issue”
• “登录公司的内部管理系统，导出本周的报表”
• “在 Jira 中创建一个新的 sprint ticket”

核心技巧：

• Agent 使用的是你自己的 Chrome 实例——所有已登录的网站无需重新认证
• SSO 环境完美支持——不需要配置额外的认证
• 无需 MCP 服务器——直接本地 CLI 通信
• 比 Playwright 更真实——网站检测不到自动化痕迹

常见踩坑

1. Chrome 版本兼容性：确保 Chrome 已更新到最新版本，旧版本可能不支持扩展通信协议。
2. 扩展权限：首次安装需在 Chrome 中授权扩展访问所有网站。
3. 端口冲突：如果 9222 端口被占用，用 chrome-relay start --port 9223 指定其他端口。
4. 隐身模式不兼容：Chrome Relay 不支持隐身窗口，因为扩展在隐身模式下默认禁用。
5. 性能影响：Agent 驱动的浏览器操作比 Playwright 慢（真实的 Chrome 渲染开销），不宜用于大规模爬虫。

常见问题 FAQ

Q1: 和 Playwright 有什么区别？

A: Playwright 启动无状态的浏览器实例（干净环境），Chrome Relay 驱动你已登录的真实 Chrome（保留 cookies/SSO/扩展/书签）。Playwright 适合无状态的自动化测试，Chrome Relay 适合需要登录态的日常操作自动化。

Q2: 安全吗？

A: 所有通信在本地进行（localhost），不经过外部服务器。Agent 只能操作你已登录的网站，不会获得你的密码。

Q3: 支持哪些网站？

A: 任何你 Chrome 中能访问的网站都支持——包括需要 SSO 的企业内网、localhost 开发环境。

Q4: 可以同时操作多个标签页吗？

A: 可以，Agent 可以在不同标签页之间切换和操作。

Q5: 需要付费吗？

A: 目前开源免费。

参考链接

• Chrome Relay 官方
• Chrome Web Store
• Playwright 对比