Skills chrome-cdp

Name: chrome-cdp
Author: openclaw

chrome-cdp-skill

install

source · Clone the upstream repo

git clone https://github.com/openclaw/skills

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/adminlove520/chrome-cdp" ~/.claude/skills/openclaw-skills-chrome-cdp && rm -rf "$T"

OpenClaw · Install into ~/.openclaw/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.openclaw/skills && cp -r "$T/skills/adminlove520/chrome-cdp" ~/.openclaw/skills/openclaw-skills-chrome-cdp && rm -rf "$T"

manifest: skills/adminlove520/chrome-cdp/SKILL.md

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+