Browser CDP 操作工具
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/worldwonderer-oh-story-claudecode-browser-cdp。
技能介绍
要解决什么问题
很多自动化场景并不是「开一个无头浏览器再重新登录」就够了:你要的是在已经登录过的 Chrome 档案里打开页面、读 DOM、从 localStorage 里拿 Token,或者对登录后的后台做 snapshot 点击。直接用 shell 拼 eval 还容易在引号、$ 和反引号上翻车。本技能把 CDP + agent-browser 的安装前置、启动分支和常见命令收口成一套可重复执行的流程,并强调一件容易被忽略的事:调试实例启动时可能结束用户正在用的 Chrome,所以必须先探测、再征得同意。
技能如何工作
核心链路是:无副作用探测 → 按 CDP_STATUS / Chrome 是否在跑 决定是直接 --cdp 9222 还是走 setup-cdp-chrome.js(必要时 --yes)。skill 模式里应优先用 --detect-only,看到退出码 3(NEEDS_CONSENT)时不能盲加 --yes,而要先用 AskUserQuestion 说明会杀掉多少进程、可能丢未保存标签页。
日常操作大致包括:agent-browser --cdp 9222 open <url> 打开并等加载;snapshot -i 拿可交互元素引用再做 click;get text body 抽正文;复杂 JS 用 eval -b 或 --stdin 避免 shell 转义。登录态坏了可以用 --reset 重建 ~/chrome-debug-profile,多档案时用 --profile "Profile 1"。
在 OpenCode 这类没有真正后台跑长命令的环境里,页面加载、多页抓取会阻塞会话,文档建议用 timeout(Unix)或 PowerShell Job(Windows)包一层,并约定单步超时、失败从断点重试。
适用边界与注意点
- 平台:macOS / Linux 为主,Windows 标为实验性;需要本机已装 Chrome 与 Node.js 20+,且全局装好
agent-browser。 - 清理进程:只应通过
chrome-debug-profile对应命令行核验 PID 后结束 debug 实例;手工排障不要按chrome.exe批量 kill,否则会误伤日常浏览器(--reset启动流程里的清理是另一回事,同样需要用户同意)。 - 仍可能卡死:eval 永远等不到、大批量翻页累计超时、CDP 断了但进程挂着——需要超时、重试,必要时在 opencode 里 ESC 打断。
使用场景
- 已在 Chrome 登录某 SaaS,需在助手会话里打开后台页并抽取正文,又不想重新扫码登录
- 要从当前站点 localStorage 读取 Auth Token 做接口调试,JS 含引号需用 eval -b 或 stdin 避免 shell 转义
- 页面发生跳转到登录页时,用 snapshot -i 定位登录按钮并继续自动化点击流程
- 多 Chrome 用户档案并存时,指定 Profile 1 启动 CDP 并复用该档案下的 Cookie 与本地存储
适合人员
- 维护带 Web 控制台的数据管线、需用本人浏览器登录态拉取页面的后端工程师
- 在 Claude Code / OpenCode 里编排技能、要为 CDP 启动写探测与 AskUserQuestion 同意流程的 AI Agent 作者
- 经常从已登录后台批量摘抄页面文字或做元素级交互、又不愿维护独立 Playwright 项目的测试工程师
- 本机 Chrome 登录态失效后,需要按文档用 --reset 重建 debug profile 再继续自动化的运维同学