test-driven-development
OBobra/superpowers298k2,631 new stars in the last 7 days
browser_cdp
通过 Chrome DevTools Protocol (CDP) 连接已运行的浏览器，或扫描本机 CDP 端口，用于远程调试与多工具共享浏览器实例。
- Star
- 1,157
- Category
- Browser & testing
- License
- Apache-2.0
- Last commit
- Oct 13, 2026
mateclaw-server/src/main/resources/skills/browser_cdp/SKILL.md
View on GitHub浏览器 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断开连接
Similar Skills
migrate-to-shoehorn
MAmattpocock/skills288k10,178 new stars in the last 7 days
agent-runtime-gateway-smoke-test
AFaffaan-m/ECC278k4,046 new stars in the last 7 days
Featured
accessibility
Audit accessibility on Web, iOS, and Android to meet WCAG 2.2, with keyboard navigation and screen-reader support.
AFaffaan-m/ECC278k4,046 new stars in the last 7 days
ai-regression-testing
AFaffaan-m/ECC278k4,046 new stars in the last 7 days
Official
firecrawl-build-interact
FIfirecrawl/firecrawl191k2,010 new stars in the last 7 days