Cdp Browser_AI Agent skill-PHP中文网

首页专区 Skill 文章专题 AI工具学习编程手册

PHP MySQL jquery HTML CSS

Cdp Browser

Polar Sponsor

爱发电赞助

.NET 9.0

立即下载

CDP浏览器控制（localhost:9222）。用于检查标签页、截取屏幕截图、网页导航、滚动、在X平台发帖或运行JavaScript代码。

cdp-浏览器.是一项面向实际任务的技能，主要用于CLI for Chrome/Cromium at localhost:9222. 检查标签,在持续浏览器会话中获取截图,导航,滚动,张贴到X,或运行JS.；Repo: https://github.com/gostlight。

实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；

涉及批量任务时，还应保存进度，避免中断后重复操作。该技能适合用于一次性任务，也可以接入自动化工作流，与其他技能或上层代理配合完成更完整的业务链路；在组合使用时，应明确每一步的输入输出关系，并避免不同步骤之间出现参数冲突。

用于本地运行的 Chrome/Chromium（地址为 localhost:9222）的命令行工具。支持查看标签页、截取全屏截图、页面跳转与滚动、向 X（原 Twitter）发帖，或在持久化浏览器会话中执行 JavaScript。

代码仓库： https://github.com/gostlightai/cdp-browser

前提条件： Chromium 已启动并启用远程调试端口：--remote-debugging-port=9222；或已通过 Docker Compose 启动，或本地 Chrome 已启用远程调试功能。

请在技能目录（bin/ 脚本所在路径）下运行以下命令：

命令	说明
`status`	列出所有标签页（返回 CDP 接口返回的 JSON 数据）
`tabs`	等同于 `status`
`new`	新建标签页并打开指定 URL
`goto`	在指定标签页中跳转至目标 URL
`snapshot`	截取当前标签页完整页面截图（PNG 格式）
`close-popup`	关闭弹窗/模态框（dismiss dialogs/modals）
`scroll [down\|up]`	按像素值或 CSS 选择器滚动页面（可选方向：down 或 up）
`query getUrl`	获取当前页面 URL
`query getText [selector]`	获取指定元素的文本内容（若未提供 selector，则返回 body 文本）
`query getHtml [selector]`	获取指定元素的 HTML 内容（若未提供 selector，则返回 body HTML）
`tweet-draft "text"`	仅填充发帖编辑框，不执行实际发布
`tweet-post --confirm "text"`	发布推文（必须将 `--confirm` 作为第二个参数传入）
`tweet "text"`	`tweet-draft` 的别名（仅填充编辑框）

tweet-draft（默认行为）：仅填充 X 发帖编辑框；用户需在浏览器中手动审阅并点击发布。
tweet-post：要求显式传入 --confirm 参数（严格校验）。仅当用户明确授权（例如回复“go ahead”、“post it”，或点击 Telegram 中的确认按钮）时使用。
可选的 Telegram 确认按钮：若配置中启用了 tweet.confirmButton，Agent 可先执行 tweet-draft --save-pending 将待发内容写入暂存状态，再发送一条带内联 “Confirm Post” 按钮的消息。用户点击该按钮后，Agent 将执行 tweet-post --confirm 完成发布。

Telegram 的 “Confirm Post” 按钮仅在存在有效配置文件时生效。请复制示例配置并放置到您的工作区中：

# 从技能目录执行（例如：~/.openclaw/workspace/skills/cdp-browser）：
cp .cdp-browser.json.example ~/.openclaw/workspace/.cdp-browser.json

配置文件位置： ~/.openclaw/workspace/.cdp-browser.json（或环境变量 $OPENCLAW_WORKSPACE/.cdp-browser.json 所指路径）

键名	默认值	说明
`tweet.confirmButton`	`false`	设为 `true` 后，Agent 将在 Telegram 中以带内联 “Confirm Post” 按钮的方式发送草稿；用户可通过点击按钮或发送 “go ahead” 等指令完成授权。

若未提供该配置，Agent 将仅使用基础版 tweet-draft（无按钮），用户须通过纯文本方式确认。

当 tweet.confirmButton 为 true（即已提供配置）且当前处于 Telegram 会话中时，请按以下步骤操作：

生成草稿： 在技能目录下运行：tweet-draft --save-pending "text"。该命令将填充 X 编辑框，并将待发内容写入 ~/.openclaw/workspace/.cdp-browser/pending-tweet.json。
发送带按钮消息： 在技能目录下运行：
```
./scripts/send-tweet-confirm.sh  ""
```
或直接调用：openclaw message send 并附加参数 --buttons '[[{"text":"Confirm Post","callback_data":"cdp:tweet:confirm"}]]'。其中应替换为当前会话的 reply target。
收到确认后执行发布： 当用户点击按钮时，OpenClaw 将投递 callback_data: cdp:tweet:confirm；用户亦可发送 “go ahead” / “post it” 等文本完成授权。以上任一方式均视为有效批准。随后请执行以下操作：
- 读取 ~/.openclaw/workspace/.cdp-browser/pending-tweet.json 获取 text 和 tabId
- 执行 tweet-post --confirm ""
- （可选）编辑或删除含确认按钮的原始消息
- 删除暂存文件 pending-tweet.json

cdp.js —— 仅封装 CDP HTTP API 的轻量级调用器（支持 /json、/json/list、/json/new 等端点），不依赖 Shell 环境。
pw.js —— 基于 Playwright 连接浏览器，实现 snapshot、goto、scroll、query、tweet-draft、tweet-post 等功能。发帖入口逻辑：优先匹配侧边栏按钮 SideNav_NewTweet_Button，其次尝试路径 /compose/post，最终 fallback 至仅含“Post”文字的按钮（避免误触回复类按钮）。提交按钮识别关键词：tweetButton、tweetButtonInline。