chrome-cdp-live-browser

chrome-cdp 让 AI 智能体通过 Chrome DevTools Protocol（CDP）连接你正在运行的 Chrome，而非新建隔离浏览器，因此能操作已打开的标签页，登录态、Cookie 和页面状态保持原样。每个标签页使用一个常驻 WebSocket 守护进程，授权弹窗只出现一次；无需 npm install，仅需 Node.js 22+，支持 100 个以上标签页，类型输入可作用于跨域 iframe。安装方式：pi 技能用 pi install git:github.com/pasky/chrome-cdp-skill@v1.0.1；手动方式为 git clone https://github.com/pasky/chrome-cdp-skill，再把 skills/chrome-cdp/ 目录复制到智能体加载上下文的位置。使用前在 Chrome 打开 chrome://inspect/#remote-debugging，开启 Enable remote debugging；脚本自动识别 macOS、Linux、Windows 上的 Chrome、Chromium、Brave、Edge 和 Vivaldi，非标准安装可设 export CDP_PORT_FILE=/path/to/DevToolsActivePort。命令入口为 scripts/cdp.mjs，<target> 是 list 输出 targetId 的唯一前缀。常用命令包括：list 列出标签页；shot 截图；snap 返回语义化无障碍树；html 输出整页或按 CSS 选择器/ID 限定范围的 HTML；eval 执行 JS；nav 导航并等待加载；net 查看网络资源计时；click 按选择器点击；clickxy 按坐标点击；type 向当前焦点输入；loadall 反复点击直到元素消失；open 新建标签页；stop 停止守护进程；evalraw 透传原始 CDP 命令。限制与提示：需 Node.js 22+；守护进程空闲 20 分钟后自动退出；标签页 ID 在关闭/重开后变化，前缀歧义时用更长前缀；截图可能因后台窗口或显示缩放而空白或尺寸异常，可改用 snap 或 eval 检查 DOM；若频繁弹出授权框，确认使用同一入口并先 stop；无法自动检测浏览器时设置 CDP_PORT_FILE。