| name | browser_cdp |
| version | 1.2.0 |
| description | 通过 Chrome DevTools Protocol (CDP) 连接已运行的浏览器，或扫描本机 CDP 端口，用于远程调试与多工具共享浏览器实例。 |
| dependencies | {"tools":["browser_use","execute_shell_command"]} |
浏览器 CDP 使用
仅在用户明确提出以下需求时使用本技能：
- 连接到已打开的 Chrome（附着现有实例）
- 扫描本机有哪些 CDP 端口可用
- 用固定调试端口启动浏览器
- 让多个工具 / Agent 共享同一浏览器
普通"打开浏览器"需求请用 browser_visible 技能。
场景一：扫描本机 CDP 端口
browser_use(action="list_cdp_targets")
扫描指定端口：
browser_use(action="list_cdp_targets", cdpPort=9222)
场景二：连接已有 Chrome
用户已手动用调试端口启动了 Chrome：
browser_use(action="connect_cdp", url="http://localhost:9222")
连接后可正常使用 open / snapshot / click / type 等操作。
注意：stop 只断开连接，不会关闭用户的 Chrome 进程。
场景三：启动时指定固定 CDP 端口
browser_use(action="start", cdpPort=9222)
可见窗口 + 固定端口：
browser_use(action="start", headed=true, cdpPort=9222)
仅在用户明确要求固定端口时才传 cdpPort，否则让系统自动选择空闲端口以避免冲突。
手动启动 Chrome（带调试端口）
若用户需要先手动打开 Chrome 再连接：
macOS：
execute_shell_command(
command="\"/Applications/Google Chrome.app/Contents/MacOS/Google Chrome\" --remote-debugging-port=9222 --no-first-run --no-default-browser-check"
)
Windows：
execute_shell_command(
command="\"C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe\" --remote-debugging-port=9222 --no-first-run"
)
Linux：
execute_shell_command(
command="google-chrome --remote-debugging-port=9222 --no-first-run &"
)
stop 行为区别
| 启动方式 | stop 效果 |
|---|
browser_use(action="start") | 断开连接 + 关闭 Chrome 进程 |
browser_use(action="connect_cdp", ...) | 仅断开连接，不关闭外部 Chrome |
与 browser_visible 的分工
| 需求 | 用哪个技能 |
|---|
| 显示 / 隐藏浏览器窗口 | browser_visible |
| 连接 / 暴露 / 扫描 CDP 端口 | browser_cdp（本技能） |
安全提醒
- CDP 端口暴露后，本机任何进程都可以控制该浏览器（包括读取 Cookies）
- 不要在公共 / 多用户服务器上暴露 CDP 端口
- 用完后及时
stop 断开连接
