SKILL.md
Browser CDP 操作工具
通过 CDP 协议控制 Chrome,复用已有登录态,执行浏览器自动化操作。
前置条件
- Windows(实验性)/ macOS / Linux,已安装 Google Chrome
- Node.js 16+(Atomics.wait + SharedArrayBuffer)
agent-browser命令行工具已安装(npm install -g agent-browser)
第一步:启动 CDP Chrome 环境
node {SKILL_DIR}/scripts/setup-cdp-chrome.js 9222
成功后所有 agent-browser 命令带 --cdp 9222。
常用操作
打开页面并等待加载
agent-browser --cdp 9222 open "<URL>"
agent-browser --cdp 9222 wait 3000
提取页面文本内容
agent-browser --cdp 9222 eval 'document.body.innerText.substring(0, 8000)'
提取 Auth Token
# 从 localStorage 或 cookie 提取
agent-browser --cdp 9222 eval 'localStorage.getItem("token") || document.cookie'
页面截图 / 交互式快照
# 查找页面元素(用于登录按钮等交互)
agent-browser --cdp 9222 snapshot -i
点击元素
agent-browser --cdp 9222 click "<CSS selector>"
填写表单
agent-browser --cdp 9222 type "<CSS selector>" "<text>"
常见问题
问题
解决方案
CDP 端口未监听
重新运行 setup-cdp-chrome.js
页面跳转到登录页
snapshot -i 找登录按钮并操作
eval 返回 null
检查 localStorage key 名称,或改用 document.cookie
Chrome 进程残留
macOS/Linux: pkill -9 -x 'Google Chrome' / Windows: taskkill /F /IM chrome.exe,后重新运行脚本