webmcp-cli-cdp

WebMCP CLI (CDP 直连模式) Skill

本 Skill 指导 AI Agent 如何通过 @opentiny/webmcp-cli 的 CDP 模式（Chrome DevTools Protocol 直连）操控浏览器。

适用场景与特征

• 独立沙箱：自动在后台启动独立的 Chrome 实例（默认配置位于 ~/.webmcp_chrome_profile），无需预先开启用户浏览器。
• 自动化与 CI 优先：适合可重复的回归测试、批量网页内容提取、自动化脚本任务。
• 环境自动注入：自动向目标网页注入 webmcp-polyfill 与内置的 page-agent-tool。
• 标识特征：
  • 命令直接调用 webmcp-cli <command>（默认即 CDP 模式，无需额外参数）；
  • Tab ID 格式为 32 位 UUID 字符串（Chrome Target ID）；
  • 支持 CDP 专属的系统剪贴板操作（clipboard）。
  • 不复用用户真实浏览器的登录态与 Cookie。

安装

当 shell 终端提示找不到工具时执行：

npm install -g @opentiny/webmcp-cli

---

命令集与规范

1. 管理浏览器标签页 webmcp-cli tabs

webmcp-cli tabs open https://excalidraw.com    # 打开新网页，返回目标 tabid (UUID)
webmcp-cli tabs switch <tabid>                 # 切换到指定标签页
webmcp-cli tabs close <tabid>                  # 关闭指定标签页
webmcp-cli tabs back                           # 当前标签页后退
webmcp-cli tabs back <tabid>                   # 指定标签页后退
webmcp-cli tabs forward                        # 当前标签页前进
webmcp-cli tabs forward <tabid>                # 指定标签页前进

遇到 net::ERR_CERT_*（自签名、过期或主机名不匹配）时，加上全局参数 --ignore-certificate-errors，或设置 WEBMCP_IGNORE_CERTIFICATE_ERRORS=1。默认仍校验证书。该开关只对 CDP 模式拉起的受控浏览器生效，并保持到该浏览器进程退出。

webmcp-cli --ignore-certificate-errors tabs open https://self-signed.example

2. 查询浏览器当前状态 webmcp-cli state

返回当前活跃页签的导航元数据（URL、标题、所有打开页签、当前已注入的 webmcpTools 清单）。

webmcp-cli state
webmcp-cli state -t <tabid>   # 指定某个标签页（UUID 字符串）

输出示例：

{
  "url": "https://www.baidu.com/",
  "title": "百度一下，你就知道",
  "webmcpTools": [{ "name": "page-agent-tool" }, { "name": "baidu_search" }],
  "tabs": [
    { "tabid": "2EA73ED323E46E5E108D4E46DA4E4AA7", "title": "百度一下，你就知道", "url": "https://www.baidu.com/" }
  ]
}

注意：state 不返回页面的可交互元素（DOM 树）。获取元素必须使用 page-agent-tool 的 browserState 或 searchTree。

---

3. 系统剪贴板操作 webmcp-cli clipboard（CDP 专属）

webmcp-cli clipboard                      # 读取当前系统剪贴板文本
webmcp-cli clipboard "需要写入剪贴板的内容"   # 写入文本到系统剪贴板