前言¶
让 AI 操作浏览器时，常见做法是直接调用 Playwright、Puppeteer 或各类 MCP 浏览器工具。这些方案往往自带浏览器启动逻辑，和本机已开的 Chrome、固定调试端口 9222 不一定对齐。若你希望 Agent 先确认调试端口、接管已有 Chrome，或在已知可执行路径下拉起带 CDP 的实例，再去做 tab 选择与页面脚本，就需要一层「运行时准备」说明，而不是散落的临时命令。
下面介绍 SkillHub 上的 Chrome调用（坐标 @user_2a19425c/chrome-cdp-runtime，版本 1.0.0）。它用通用 SKILL.md 约束 Agent 的行为：只走 Chrome CDP、固定关注 9222，并为上层业务 Skill 提供可复用的连接与 tab 操作前提。
这是什么¶
Chrome调用（包内 Display Name 为 Chrome CDP Runtime）由社区发布者 user_2a19425c 维护，分类为 dev-programming，来源为 community。SkillHub 页面标注 requires_api_key=false，安装与使用不依赖额外 API Key。
一句话定位：在 Agent 侧规范 Chrome DevTools Protocol（CDP）的运行时准备——检查 9222、接管已有实例或按已知路径启动调试 Chrome，并完成基础页面连接与 tab 操作。
核心功能¶
以下能力均来自该 Skill 的 SKILL.md 与 SkillHub 简介，不含未在文档中出现的接口或脚本名。
- 检查 9222：判断本机调试端口是否已监听、是否可访问。
- 接管已有实例：若 9222 已在用，优先连接已存在的 Chrome CDP，不要求提供 Chrome 可执行路径。
- 按路径启动调试实例：若 9222 未监听且调用方提供了已确认的
chromeExecutablePath，则按该路径启动 Chrome 并开启 9222。 - tab 与页面基础操作：连接 CDP 后列出 tab、选择目标页面，支持基础页面读取、导航与脚本执行。
- 环境不满足时明确失败：Chrome 路径未知、未安装或 9222 无法使用时，只报告阻塞原因，不擅自换浏览器或猜路径。
硬约束（文档明确要求）
- 仅使用 Chrome CDP，调试端口仅使用 9222（
debugPort可选，默认 9222）。 - 不使用 Edge 或其他未授权的浏览器替代方案。
- 自动启动 Chrome 时不得硬编码路径；路径必须由输入提供且已确认。
可选输入字段
| 字段 | 说明 |
|---|---|
chromeExecutablePath |
Chrome 可执行文件路径；仅接管已有 CDP 时可省略 |
targetUrl |
目标 URL（可选） |
userDataDir |
用户数据目录（可选） |
debugPort |
调试端口，默认 9222 |
建议触发场景（When to use）
- Chrome CDP 调试与浏览器自动化前的环境准备
- 接管已有 9222 实例
- 启动 Chrome 调试实例
- 列出/选择浏览器 tab
- 通过 CDP 执行页面脚本
安装与启用¶
SkillHub 官方页面给出的安装方式是：让 Agent 依照 SkillHub 安装说明 安装坐标 @user_2a19425c/chrome-cdp-runtime。
若本机已安装 skillhub CLI，可先确认版本，再安装到当前 Agent 的 skills 目录（安装时必须使用 --dir，否则默认目录可能不会被 Agent 加载）：
command -v skillhub && skillhub --version
未安装 CLI 时，可按 SkillHub 文档执行完整安装（节选）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
将本 Skill 安装到对应客户端的 skills 目录，例如 Cursor 常用路径为 ~/.cursor/skills/：
skillhub install chrome-cdp-runtime --namespace user_2a19425c --dir ~/.cursor/skills/
其他客户端的 skills 路径以 skillhub.cn/install/skillhub.md 第四节为准（如 Claude Code：~/.claude/skills/，Codex：~/.codex/skills/ 等）。安装后按各客户端要求刷新或重启，使新 Skill 生效。
也可将下面提示词发给支持 Skill 安装的 AI，由其按官方文档完成安装：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_2a19425c/chrome-cdp-runtime`。
典型用法¶
本 Skill 不附带独立 CLI 脚本，用法体现在 Agent 遵循 SKILL.md 中的执行流程。下面按文档顺序说明可复现的逻辑（具体 CDP 命令由 Agent 在合规前提下选用，本文不编造未出现的工具名）。
流程 1：优先接管已有 Chrome
- 检查
9222是否已监听。 - 若可访问，连接已有 Chrome CDP，列出 tab 并选择目标 tab。
- 在目标页面上执行读取、导航或脚本执行。
此时无需 chromeExecutablePath。
流程 2：需要 Agent 拉起 Chrome
- 检查
9222未监听。 - 调用方提供已确认的
chromeExecutablePath（以及可选的userDataDir、targetUrl）。 - 按路径启动 Chrome，开启 9222，再连接 tab 并操作页面。
若未提供路径且 9222 不可用，Agent 应停止并说明环境不满足，而不是猜测系统 Chrome 位置或改用 Edge。
流程 3：为上层 Skill 提供运行时
完成标准为文档中的四条：成功接管或启动 Chrome CDP；9222 可访问；能列出并连接目标 tab；能执行基础页面操作。满足后，其他依赖浏览器的业务 Skill 可在该运行时之上继续工作。
适用场景与注意¶
适合谁
- 已在本机用 9222 做 Chrome 远程调试，希望 Agent 先「接上」再干活。
- 需要统一约束：只用 Chrome CDP、固定 9222，避免 Agent 自行换浏览器或乱写路径。
- 想把「浏览器环境准备」与「业务自动化」拆成两层 Skill 的开发者。
限制与注意
- 端口策略写死为 9222；若本机该端口被占用或防火墙拦截，需先处理环境，Skill 不会自动改端口策略（除非在输入中显式使用
debugPort且与文档默认一致）。 - 不能替代完整 E2E 框架：它聚焦 CDP 运行时与基础 tab/页面能力，复杂场景仍要由上层逻辑或专用工具承担。
- 自动启动依赖调用方提供真实 Chrome 路径；在 CI 或无图形环境的机器上，通常更适合预先启动好带 9222 的 Chrome，再走接管流程。
- SkillHub 统计（以页面抓取为准）：评分 100000，下载约 2991，安装约 8；数据会随时间变化，以 SkillHub 页面为准。
结尾¶
Chrome调用 把 Chrome CDP 在 Agent 侧的准备步骤写进 Skill：先 9222，再接管或按路径启动，最后连接 tab 与基础页面操作，并明确禁止换浏览器与硬编码路径。若你的自动化要从「本机调试 Chrome」起步，可以在 SkillHub 安装 @user_2a19425c/chrome-cdp-runtime。
- SkillHub 页面：https://www.skillhub.cn/skills/user_2a19425c/chrome-cdp-runtime
- API 坐标页：https://api.skillhub.cn/user_2a19425c/chrome-cdp-runtime
- 安装说明：https://skillhub.cn/install/skillhub.md
