Browser Cdp
Testing & Qualitybrowser_cdpBrowser Cdp is an Agent Skill for testing & quality published in the mateaix/mateclaw repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
通过 Chrome DevTools Protocol (CDP) 连接已运行的浏览器,或扫描本机 CDP 端口,用于远程调试与多工具共享浏览器实例。
QUICK START
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/mateaix/mateclaw/blob/HEAD/mateclaw-server/src/main/resources/skills/browser_cdp/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/browser-cdp-d9a40d83, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
浏览器 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断开连接