browser-cdp

仓库创建 2026年4月23日最近提交 6 小时前SkillHot 收录 20 天前

▸ 精选理由

适合需要复用真实浏览器会话或执行 JS 的自动化任务。

▸ 风险提示

首次启动会终止用户 Chrome 进程，需征得许可并有本地高权限。

这个 Skill 做什么

通过 Chrome DevTools Protocol 控制本地 Chrome，执行自动化与登录复用。

通过 Chrome DevTools Protocol (CDP) 控制本地 Chrome，打开页面、执行 JS、截图并复用已有登录态来提取 token 或做自动化操作。需要做浏览器自动化、登录态复用或抓取登录后数据时用。能直接用真实浏览器会话提高稳定性，但首次启动可能影响当前 Chrome 进程，操作前要通知用户。

▸ 展开 SKILL.md 英文原文

Use this skill when you need to control a Chrome browser via CDP (Chrome DevTools Protocol) to reuse existing login sessions. Covers: launching Chrome in debug mode, opening URLs, waiting for page load, evaluating JavaScript, taking snapshots, and extracting auth tokens. Trigger phrases: browser automation, CDP, agent-browser, 浏览器操作, 操作浏览器, Chrome CDP, 复用登录态, extract token from browser.

自动化集成CDP控制浏览器自动化登录复用通用

4.6k

Stars

713

Forks

仓库内 Skill

+893

7 日增星

安装 / 使用

给你的 Agent 一句话（通用）

帮我安装这个 skill：https://raw.githubusercontent.com/worldwonderer/oh-story-claudecode/main/skills/browser-cdp/SKILL.md

或 curl 直取 SKILL.md

curl -fsSL "https://raw.githubusercontent.com/worldwonderer/oh-story-claudecode/main/skills/browser-cdp/SKILL.md"

SKILL.MD 节选查看完整文件 ↗

# Browser CDP 操作工具

通过 CDP 协议控制 Chrome，复用已有登录态，执行浏览器自动化操作。

## 前置条件

- macOS / Linux / Windows（实验性），已安装 Google Chrome
- Node.js 20+
- `agent-browser` 已安装：`npm install -g agent-browser`

> ⚠️ **首次启动会 kill 用户的常规 Chrome。** 在启动前必须征求用户同意（见下方"启动流程"），否则用户可能丢失未保存的标签页/草稿。

---

## 启动流程（skill-mode 强制步骤）

**第一步：探测当前状态（无副作用）**

```bash
node {SKILL_DIR}/scripts/setup-cdp-chrome.js 9222 --detect-only
```

输出形如：

```
CDP_STATUS=ready                        # 已就绪，可直接复用
CDP_URL=http://127.0.0.1:9222/json/version
BROWSER=Chrome/148.0.7778.168
```

或：

```
CDP_STATUS=needs-setup
CHROME_RUNNING=yes                      # 用户有 Chrome 在跑，启动会杀掉
CHROME_PID_COUNT=3
```

**第二步：根据探测结果分支**

- `CDP_STATUS=ready` → 直接使用 `

via SKILL·HOT · 数据来自 GitHub 公开信息 · 原文版权归作者所有