Use this skill when you need to control a Chrome browser via CDP (Chrome DevTools Protocol) to reuse existing login sessions. Covers: launching Chrome in debug mode, opening URLs, waiting for page load, evaluating JavaScript, taking snapshots, and extracting auth tokens. Trigger phrases: browser aut

Browser CDP 操作工具通过 CDP（Chrome DevTools Protocol）连接 Chrome，复用登录态并执行浏览器操作。前置条件 macOS / Linux / Windows（实验性），已安装并使用过 Google Chrome，来源 profile 已存在 Node.js 20+ agent browser 已安装： npm install g agent browser 启动或重建时，若需结束 Chrome 进程，先按下方流程征得同意；未保存的标签页或草稿可能丢失。启动流程（每次都按这个顺序）下文 {SKILL DIR} 指本 skill（browser cdp）的目录。第一步：探测当前状态（无副作用）输出形如：或：第二步：根据探测结果分支 CDP STATUS=needs setup 且 CHROME INSTALLED=no → 本机没找到 Chrome，告诉用户先安装并用它登录一次需要的网站，不要运行 setup。 CDP STATUS=ready 且本次只需连接 → 直接使用 agent browser cdp 9222 ... ，不要运行 setup 。明确请求 reset / profile → 即使 ready 也走重建，按下方「需要结束 Chrome 时」处理。 CDP STATUS=needs setup 且 CHROME RUNNING=no → 安全启动： CDP STATUS=needs setup 且 CHROME RUNNING=yes → 按下方「需要结束 Chrome 时」处理。需要结束 Chrome 时（同意流程）：凡是会结束正在运行的 Chrome 的命令（Chrome 在运行时启动、 reset 、显式 profile ），都按这三步走： 1. 带上原定选项加 dry run 跑一次，看会结束几个 Chrome 进程； 2. 告诉用户会结束 N 个 Chrome 进程、未保存的标签页或草稿可能丢失，问是否继续； 3. 用户同意后，去掉 dry run 、加 yes 重跑；用户拒绝就放弃这次自动化。非 TTY 调用中，Chrome 在运行且未传 yes 时，脚本以退出码 3 报 NEEDS CONSENT: ... 并中止。取得同意后再重跑，不自动补 yes 。换端口：9222 被别的程序占用时可以换一个端口（如 9333），之后所有 agent browser cdp 命令用同一个端口，扫榜脚本加 port 9333 ，查资料助手传 cdp port: 9333 。启动脚本选项选项说明 detect only 只探测，不修改任何状态 yes 已征得同意，跳过交互提示 reset 启动前清空 ~/chrome debug profile （登录失效时用） profile <name 指定来源 profile（默认 Default ，如 "Profile 1" ）；显式传入即重建 dry run 打印将执行的步骤，不执行退出码： 0 成功 / 1 通用错误 / 2 用户拒绝（TTY）/ 3 需同意但缺 yes 。常用操作打开页面并等待加载提取页面文本提取 Auth Token 示例读取 localStorage 的 token 项或 JavaScript 可读的 Cookie；实际存放位置按站点确认。复杂 JS（含引号 / $ / 反引号）用 base64 或标准输入传入脚本，避免 shell 转义错误：页面交互（snapshot 拿元素引用）停止 / 清理关掉 debug Chrome 窗口即可。若窗口无响应，先按 user data dir 核验出 debug 实例的 PID 再只结束它： macOS / Linux： pgrep af chrome debug profile Windows（PowerShell）： Get CimInstance Win32 Process Where Object CommandLine like ' chrome debug profile ' Select Object ProcessId,CommandLine ；没有 PowerShell 的旧系统才用 wmic process get ProcessId,CommandLine findstr chrome debug profile 核验 PID 后用 kill 9 {PID} / taskkill /F /PID {PID} ，无法核验则停止。手工清理不得按 Chrome 可执行文件名批量结束进程；启动脚本仍走上述同意流程。登录态失效：用 node {SKILL DIR}/scripts/setup cdp chrome.js 9222 reset 重新复制来源 profile，按上方「需要结束 Chrome 时」先 dry run、征得同意再加 yes 。长命令加超时在前台执行耗时的 CDP 命令时，为页面加载和批量采集设置超时，避免单次调用长时间占住会话。超时包装 Windows 用 PowerShell Job 设置超时： macOS / Linux 有 timeout 时：已知限制场景风险缓解页面加载超时 eval 命令等待永不返回设置 30s 超时，超时后重试大批量数据抓取多页翻页时累计等待过长每页独立超时，失败后从断点继续 Chrome 进程僵死 CDP 连接断开但进程未退出先核验 debug profile 对应 PID，只结束该 debug 实例后重连；不得连带普通 Chrome 网络波动请求挂起无超时超时后自动重试一次持续卡死时，请用户在宿主里手动打断（如 OpenCode、Claude Code 按 ESC ）。常见问题问题解决方案 NEEDS CONSENT + 退出码 3 按「需要结束 Chrome 时」：先 dry run 说清会结束几个进程，同意后加 yes 重跑 CHROME INSTALLED=no 或来源 profile 不存在安装并使用 Chrome 一次；已有其他 profile 时用 profile 指定（会重建，按同意流程） CDP 端口未监听 detect only 再确认；端口被占用就换端口，下游命令一起改（见「换端口」）页面跳转到登录页 snapshot i 找登录按钮并操作 eval 返回 null 检查 localStorage key 名；含引号的 JS 用 eval b 或 stdin 登录态过期 setup cdp chrome.js 9222 reset ，按同意流程先 dry run、同意后加 yes 有多个 Chrome profile profile "Profile 1" 指定；显式传 profile 会重建，按同意流程 Chrome 不会启动（30s 超时）检查端口冲突；查看 ~/chrome debug profile/ 是否损坏；仍不行再按同意流程试 reset

browser-cdp