CDP 模式#
通过 Chrome DevTools Protocol 连接到已有浏览器：
bash
# 启动 Chrome：google-chrome --remote-debugging-port=9222
# 先连接一次，然后就可以不带 --cdp 直接运行命令
agent-browser connect 9222
agent-browser snapshot
agent-browser tab
agent-browser close
# 或者在每条命令上都传入 --cdp
agent-browser --cdp 9222 snapshot远程 WebSocket URL#
通过 WebSocket URL 连接到远程浏览器服务：
bash
# 连接到远程浏览器服务
agent-browser --cdp "wss://browser-service.com/cdp?token=..." snapshot
# 适用于任何兼容 CDP 的服务
agent-browser --cdp "ws://localhost:9222/devtools/browser/abc123" open example.com--cdp 标志可以接受：
- 端口号（例如
9222），用于通过http://localhost:{port}进行本地连接 - 完整的 WebSocket URL（例如
wss://...或ws://...），用于远程浏览器服务
自动连接#
使用 --auto-connect 可以自动发现并连接到正在运行的 Chrome 实例，而无需指定端口：
bash
# 自动发现启用了远程调试的运行中 Chrome
agent-browser --auto-connect open example.com
agent-browser --auto-connect snapshot
# 或通过环境变量
AGENT_BROWSER_AUTO_CONNECT=1 agent-browser snapshot自动连接通过以下方式发现 Chrome：
- 读取默认用户数据目录中的
DevToolsActivePort文件 - 回退探测常见调试端口（9222、9229）
- 如果基于 HTTP 的发现方式（
/json/version、/json/list）失败，则回退到直接 WebSocket 连接
这在以下场景很有用：
- Chrome 144+ 通过
chrome://inspect/#remote-debugging启用了远程调试（它使用动态端口） - 你想无配置地连接到现有浏览器
- 你不想追踪 Chrome 正在使用哪个端口
配色方案#
通过 CDP 连接时，可使用 --color-scheme 设置持久化偏好：
bash
agent-browser --cdp 9222 --color-scheme dark open https://example.com
agent-browser --cdp 9222 snapshot # 保持深色模式或者通过配置或环境变量全局设置：
bash
AGENT_BROWSER_COLOR_SCHEME=dark agent-browser --cdp 9222 open https://example.com使用场景#
这使你可以控制：
- Electron 应用
- 启用了远程调试的 Chrome/Chromium
- WebView2 应用
- 远程浏览器服务（通过 WebSocket URL）
- 任何暴露 CDP 端点的浏览器
全局选项#
| 选项 | 说明 |
|---|---|
--session <name> | 使用隔离会话 |
--profile <path> | 持久化浏览器配置文件目录 |
-p <provider> | 浏览器提供商（browserbase、browseruse、kernel、browserless、agentcore，或已配置的 browser.provider 插件） |
--headers <json> | 按来源范围限定的 HTTP 头 |
--executable-path | 自定义浏览器可执行文件 |
--args <args> | 浏览器启动参数（逗号分隔） |
--user-agent <ua> | 自定义 User-Agent 字符串 |
--proxy <url> | 代理服务器 URL |
--proxy-bypass <hosts> | 绕过代理的主机 |
--json | 供脚本使用的 JSON 输出 |
--name, -n | 定位器名称过滤 |
--exact | 精确文本匹配 |
--headed | 显示浏览器窗口 |
--cdp <port|url> | CDP 连接（端口或 WebSocket URL） |
--auto-connect | 自动发现并连接到正在运行的 Chrome |
--color-scheme <scheme> | 持久化配色方案（dark、light、no-preference） |
--debug | 调试输出 |
云提供商#
使用 -p 标志可以连接到云浏览器提供商或已配置的 browser.provider 插件，而不是启动本地浏览器：
bash
agent-browser -p browserbase open https://example.com有关每个内置提供商的设置和配置，请参见 Providers 部分：Browser Use、Browserbase、Browserless、Kernel 和 AgentCore。