SuperAPI AI 工具集

chrome

办公与效率

查看项目

更新于 10-15 23:33

技能介绍

用途:该技能用于检查或控制用户自己的 Chrome 浏览器会话,通过 CDP(Chrome DevTools Protocol)与远程机器上真实运行的 Chrome 实例通信。远程 Chrome 需以 --remote-debugging-port=<PORT> 启动,例如 chrome.exe --remote-debugging-port=9222 --user-data-dir=C:\chrome-debug;普通 Chrome 会话不会暴露 CDP。

主要能力:可通过 SSH 加 PowerShell 调用列出标签页(按 /json 中 type 为 page 过滤,用标题或 URL 子串匹配);提供通用 CDP 调用脚本 scripts/cdp-call.ps1,发送单次 JSON-RPC 调用并输出原始响应,支持 Page.navigate、Runtime.evaluate、Network.getCookies、Storage.getCookies、Page.reload、Target.closeTarget、DOMSnapshot.captureSnapshot 等任意 CDP 方法,-Browser 可切换到浏览器级端点;提供 cdp-shot.ps1 对指定标签页截图,CDP 离屏渲染,窗口最小化也可用,captureBeyondViewport 可做整页截图。

必要用法:先做健康检查,确认 http://127.0.0.1:$CHROME_PORT/json/version 可达;用 scp 把两个 ps1 脚本传到远程目录后使用。默认 SSH_TARGET 为 steamy-wsl、端口 9222,可通过环境变量覆盖,或写入 ~/.claude/settings.json 的 env 块。评估 JS 时建议 returnByValue:true 并用 -ParamsStdin 传递表达式以避开多层 shell 引号问题。

限制:CDP 只感知在 Runtime.enable / Network.enable 之后发生的事件,不重放历史控制台与网络记录,需历史数据时应让用户从 DevTools 导出 HAR。cdp-call.ps1 每次调用只用一个 WebSocket 连接,适合临时操作,事件流需改用长连接脚本(cdp-listen.ps1 未随附)。若目标非 Windows,需去掉 PowerShell,改用 curl 与 websocat。当调试 Chrome 不可用时的降级顺序及更多细节,资料中另有说明,暂未在本简介全部列出。