chrome-cdp-skill
让AI agent访问你已打开的Chrome标签页
简介
chrome-cdp-skill 通过Chrome远程调试协议(CDP)连接你已经在用的Chrome会话，让AI可以：
- 读取已登录账户的页面(Gmail、GitHub等)
- 与你正在工作的标签页交互
- 查看真实页面状态（非重新加载的干净状态）
安装
前提条件
- Chrome浏览器
- Node.js 22+
启用Chrome远程调试
- 在Chrome地址栏输入：
chrome://inspect/#remote-debugging - 打开"启用远程调试"开关
安装Skill
# 克隆仓库
git clone https://github.com/pasky/chrome-cdp-skill.git
cd chrome-cdp-skill
# 或复制 skills/chrome-cdp/ 目录到你的agent skills目录使用方法
基本命令
# 列出打开的标签页
node scripts/cdp.mjs list
# 截图
node scripts/cdp.mjs shot <targetId>
# 获取可访问性树
node scripts/cdp.mjs snap <targetId>
# 获取HTML
node scripts/cdp.mjs html <targetId> [".selector"]
# 点击元素
node scripts/cdp.mjs click <targetId> "selector"
# 输入文字
node scripts/cdp.mjs type <targetId> "text"
# 导航
node scripts/cdp.mjs nav <targetId> https://...
# 评估JavaScript
node scripts/cdp.mjs eval <targetId> "expression"
# 网络资源计时
node scripts/cdp.mjs net <targetId>
# 加载更多（点击"加载更多"直到消失）
node scripts/cdp.mjs loadall <targetId> "selector"获取targetId
首先运行 list 命令获取标签页的targetId：
$ node scripts/cdp.mjs list
TargetID Title URL
--------- ----- ---
abc123def Gmail - Google Account https://mail.google.com/...
def456ghi GitHub https://github.com/...然后用targetId前缀操作：
node scripts/cdp.mjs snap abc
node scripts/cdp.mjs click abc "#compose"
node scripts/cdp.mjs type abc "Hello World"与OpenClaw集成
方法1：直接调用脚本
在OpenClaw中通过exec调用：
node /path/to/chrome-cdp-skill/scripts/cdp.mjs list方法2：创建MCP服务器
可以将其封装为MCP服务器供OpenClaw调用。
方法3：创建OpenClaw Skill
参考 skills/chrome-cdp/index.js 创建完整Skill。
优势对比
| 特性 | chrome-cdp | Puppeteer类工具 |
|---|---|---|
| 浏览器 | 已有Chrome | 新启动浏览器 |
| 登录状态 | 保持 | 需重新登录 |
| 页面状态 | 真实状态 | 干净状态 |
| 标签页数量 | 100+不卡 | 容易超时 |
| 依赖 | 仅Node.js | Puppeteer+浏览器 |
注意事项
- 首次访问标签页时，Chrome会弹出"允许调试"确认框
- 守护进程20分钟无活动自动退出
- 目标ID只需唯一前缀即可匹配
参考
- GitHub: https://github.com/pasky/chrome-cdp-skill
- 作者: pasky
- Stars: 1000+