browser-cdp

This is a Chrome DevTools Protocol wrapper that lets Claude reuse your existing browser sessions instead of starting fresh each t…

worldwonderer 4.5k ↓ 9k MIT updated 26d ago

Claude Code

View source ↗

What it does

macOS / Linux / Windows（实验性），已安装 Google Chrome
agent-browser 已安装：npm install -g agent-browser
CDPSTATUS=ready → 直接使用 agent-browser --cdp 9222 ...，不要运行 setup。
CDPSTATUS=needs-setup 且 CHROMERUNNING=no → 安全启动：
CDPSTATUS=needs-setup 且 CHROMERUNNING=yes → 先用 AskUserQuestion 工具向用户确认：告知会杀掉 N 个 Chrome 进程、可能丢失未保存工作；用户同意后再带 --yes 启动；用户拒绝则放弃这次自动化。
关掉 debug Chrome 窗口即可（或 pkill -9 -x 'Google Chrome' / taskkill /F /IM chrome.exe）。
登录态失效：node {SKILLDIR}/scripts/setup-cdp-chrome.js 9222 --reset --yes（注意 --yes 同样需要先问用户）。

Requirements & configuration

CDPSTATUS=needs-setup
CDPSTATUS=needs-setup 且 CHROMERUNNING=no → 安全启动：
CDPSTATUS=needs-setup 且 CHROMERUNNING=yes → 先用 AskUserQuestion 工具向用户确认：告知会杀掉 N 个 Chrome 进程、可能丢失未保存工作；用户同意后再带 --yes 启动；用户拒绝则放弃这次自动化。
agent-browser --cdp 9222 eval 'localStorage.getItem("token") || document.cookie'

Configuration: CDP_STATUSCHROME_RUNNINGNEEDS_CONSENT

Derived from the skill's own SKILL.md documentation · extracted 2026-07-23

This is a Chrome DevTools Protocol wrapper that lets Claude reuse your existing browser sessions instead of starting fresh each time.

Source

Repository: https://github.com/worldwonderer/oh-story-claudecode

browser-cdp FAQ

What does the browser-cdp skill do?

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. macOS / Linux / Windows（实验性），已安装 Google Chrome agent-browser 已安装：npm install -g agent-browser

What does browser-cdp require?

CDPSTATUS=needs-setup CDPSTATUS=needs-setup 且 CHROMERUNNING=no → 安全启动： CDPSTATUS=needs-setup 且 CHROMERUNNING=yes → 先用 AskUserQuestion 工具向用户确认：告知会杀掉 N 个 Chrome 进程、可能丢失未保存工作；用户同意后再带 --yes 启动；用户拒绝则放弃这次自动化。 agent-browser --cdp 9222 eval 'localStorage.getItem("token") || document.cookie' Configuration keys: CDP_STATUS, CHROME_RUNNING, NEEDS_CONSENT.

How do I install browser-cdp?

Run: npx -y skills add https://github.com/worldwonderer/oh-story-claudecode --skill browser-cdp --agent claude-code — the source lives at github.com/worldwonderer/oh-story-claudecode.

Maintain browser-cdp?

Let people know it's listed here — add the badge (live metrics, light/dark aware) or a plain link to your README or docs.

[![browser-cdp on getagentictools](https://getagentictools.com/badge/skills/worldwonderer-oh-story-claudecode-browser-cdp.svg)](https://getagentictools.com/skills/worldwonderer-oh-story-claudecode-browser-cdp?ref=badge)

npx agentictools info skills/worldwonderer-oh-story-claudecode-browser-cdp

The second line is the CLI lookup for this page — handy in READMEs and docs.