Chrome Cdp Live Browser

作者 reason-machines2384a003145a无许可证83 个星标收录于 2026年10月8日更新于 2026年10月8日仓库3个月前更新

Give AI agents access to your live Chrome session via CDP — interact with open tabs, logged-in accounts, and current page state

仅含说明Productivity & Workflow
AI 生成的概览

通过 CDP 将 AI 代理连接到正在运行的 Chrome 会话，可读取、导航、点击、输入并截取已打开标签页。

功能
该技能让代理通过 Chrome DevTools Protocol 直接访问已在运行的 Chrome 浏览器，而不是启动一个全新的隔离浏览器。它提供列出已打开标签页、截图、获取无障碍树或限定范围的 HTML、执行 JavaScript、导航到网址、查看网络计时、点击元素或坐标、输入文本以及反复点击“加载更多”控件的命令。它还支持打开新标签页、停止守护进程以及透传原始 CDP 命令。
适用场景
当代理需要操作用户已登录的页面并保留 Cookie 与当前页面状态时使用。它适用于从已打开标签页读取内容、填写并提交表单、用 JavaScript 提取页面数据，或对实时页面截图等任务。
运行要求
需要 Node.js 22 或更高版本，以及通过 chrome://inspect/#remote-debugging 启用远程调试的 Chrome 系列浏览器（Chrome、Chromium、Brave、Edge 或 Vivaldi）。对于非标准安装，可用 CDP_PORT_FILE 环境变量指向 DevToolsActivePort 文件。该技能仅为说明文档，不附带脚本，但其中记录了 scripts/cdp.mjs 入口点。

chrome-cdp: Live Chrome Session for AI Agents

Skill by ara.so — Daily 2026 Skills collection.

chrome-cdp connects your AI agent directly to your running Chrome browser via the Chrome DevTools Protocol (CDP). Unlike browser automation tools that spin up fresh isolated browsers, this connects to tabs you already have open — with your logins, cookies, and current page state intact.

What It Does

  • Live session access — reads and interacts with tabs you're already logged into
  • Persistent daemon — one WebSocket daemon per tab; the "Allow debugging" modal appears once, not on every command
  • No npm install — only Node.js 22+ required
  • 100+ tab support — handles large numbers of open tabs reliably
  • Cross-origin iframe support — type command works even inside cross-origin iframes

Installation

As a pi skill

bash
pi install git:github.com/pasky/[email protected]

Manual (for Amp, Claude Code, Cursor, Codex, etc.)

bash
git clone https://github.com/pasky/chrome-cdp-skill# Copy the skills/chrome-cdp/ directory to wherever your agent loads context from

Enable Remote Debugging in Chrome

  1. Open Chrome and navigate to: chrome://inspect/#remote-debugging
  2. Toggle the "Enable remote debugging" switch

That's all. No flags, no relaunching Chrome.

The script auto-detects Chrome, Chromium, Brave, Edge, and Vivaldi on macOS, Linux, and Windows. For non-standard installs:

bash
export CDP_PORT_FILE=/path/to/DevToolsActivePort

Key Commands

All commands use scripts/cdp.mjs as the entry point. <target> is a unique prefix of the targetId shown by list.

List Open Tabs

bash
node scripts/cdp.mjs list# Output:# A1B2C3  https://github.com/pasky/chrome-cdp-skill  chrome-cdp-skill# D4E5F6  https://mail.google.com/mail/u/0/           Gmail

Screenshot a Tab

bash
node scripts/cdp.mjs shot A1B2# Saves screenshot to runtime dir, prints the file path

Accessibility Tree (Semantic Snapshot)

bash
node scripts/cdp.mjs snap A1B2# Returns compact, semantic accessibility tree — best for understanding page structure

Full HTML or Scoped HTML

bash
node scripts/cdp.mjs html A1B2                    # full page HTMLnode scripts/cdp.mjs html A1B2 ".main-content"    # scoped to CSS selectornode scripts/cdp.mjs html A1B2 "#article-body"    # scoped to ID

Evaluate JavaScript

bash
node scripts/cdp.mjs eval A1B2 "document.title"node scripts/cdp.mjs eval A1B2 "window.location.href"node scripts/cdp.mjs eval A1B2 "document.querySelectorAll('a').length"

Navigate to URL

bash
node scripts/cdp.mjs nav A1B2 https://example.com# Navigates and waits for page load

Network Resource Timing

bash
node scripts/cdp.mjs net A1B2# Shows network resource timing for the current page

Click an Element

bash
node scripts/cdp.mjs click A1B2 "button.submit"node scripts/cdp.mjs click A1B2 "#login-btn"node scripts/cdp.mjs click A1B2 "[data-testid='confirm']"

Click at Coordinates

bash
node scripts/cdp.mjs clickxy A1B2 320 480# Clicks at CSS pixel coordinates (x=320, y=480)

Type Text

bash
node scripts/cdp.mjs type A1B2 "Hello, world!"# Types at the currently focused element — works in cross-origin iframes

Load More (Click Until Gone)

bash
node scripts/cdp.mjs loadall A1B2 "button.load-more"# Keeps clicking the selector until it disappears from the DOM

Open a New Tab

bash
node scripts/cdp.mjs opennode scripts/cdp.mjs open https://example.com# Note: triggers Chrome's "Allow" prompt

Stop Daemons

bash
node scripts/cdp.mjs stop          # stop all daemonsnode scripts/cdp.mjs stop A1B2     # stop daemon for specific tab

Raw CDP Command Passthrough

bash
node scripts/cdp.mjs evalraw A1B2 "Page.getFrameTree"node scripts/cdp.mjs evalraw A1B2 "Runtime.evaluate" '{"expression":"1+1"}'

Common Patterns

Pattern: Read a Page You're Logged Into

bash
# List tabs to find your targetnode scripts/cdp.mjs list
# Grab the accessibility tree for a semantic viewnode scripts/cdp.mjs snap D4E5
# Or get scoped HTML for a specific sectionnode scripts/cdp.mjs html D4E5 ".email-list"

Pattern: Fill and Submit a Form

bash
# Click the input fieldnode scripts/cdp.mjs click A1B2 "input[name='search']"
# Type into itnode scripts/cdp.mjs type A1B2 "my search query"
# Click submitnode scripts/cdp.mjs click A1B2 "button[type='submit']"
# Take a screenshot to verify resultnode scripts/cdp.mjs shot A1B2

Pattern: Extract Data with JavaScript

bash
# Get all link hrefs on a pagenode scripts/cdp.mjs eval A1B2 "Array.from(document.querySelectorAll('a')).map(a => a.href)"
# Get text content of a specific elementnode scripts/cdp.mjs eval A1B2 "document.querySelector('.price').textContent.trim()"
# Get table data as JSONnode scripts/cdp.mjs eval A1B2 "  Array.from(document.querySelectorAll('table tr')).map(row =>    Array.from(row.querySelectorAll('td,th')).map(cell => cell.textContent.trim())  )"

Pattern: Navigate and Wait

bash
# Navigate and then immediately read the pagenode scripts/cdp.mjs nav A1B2 https://news.ycombinator.comnode scripts/cdp.mjs snap A1B2

Pattern: Paginated Content

bash
# Keep loading content until "Load More" button disappearsnode scripts/cdp.mjs loadall A1B2 "button[data-action='load-more']"
# Then extract all loaded contentnode scripts/cdp.mjs eval A1B2 "document.querySelectorAll('.item').length"

Pattern: Script Integration (Node.js)

javascript
import { execFile } from 'node:child_process';import { promisify } from 'node:util';
const exec = promisify(execFile);const CDP = (...args) => exec('node', ['scripts/cdp.mjs', ...args]);
async function getPageTitle(tabPrefix) {  const { stdout } = await CDP('eval', tabPrefix, 'document.title');  return stdout.trim();}
async function takeScreenshot(tabPrefix) {  const { stdout } = await CDP('shot', tabPrefix);  return stdout.trim(); // returns file path}
async function navigateAndSnap(tabPrefix, url) {  await CDP('nav', tabPrefix, url);  const { stdout } = await CDP('snap', tabPrefix);  return stdout;}
// Usageconst tabs = (await CDP('list')).stdout;console.log(tabs);

Configuration

Environment VariablePurpose
CDP_PORT_FILEPath to DevToolsActivePort file for non-standard browser installs

Daemons auto-exit after 20 minutes of inactivity — no manual cleanup needed in normal use.

Troubleshooting

"Allow debugging" modal keeps appearing

This happens if daemons aren't persisting. Make sure you're using the same scripts/cdp.mjs entry point — it manages daemon lifecycle automatically. If you switched tools mid-session, run stop and let daemons restart fresh.

Browser not detected

If auto-detection fails, find your DevToolsActivePort file and set the env var:

bash
# macOS Chrome exampleexport CDP_PORT_FILE="$HOME/Library/Application Support/Google/Chrome/Default/DevToolsActivePort"
# Linux Chrome exampleexport CDP_PORT_FILE="$HOME/.config/google-chrome/Default/DevToolsActivePort"

Target not found / prefix ambiguous

Run list again — tab IDs change when tabs are closed/reopened. Use a longer prefix if multiple tabs share the same prefix characters.

Remote debugging toggle not visible

Ensure you're on chrome://inspect/#remote-debugging (not just chrome://inspect/). The toggle is in the top-right of the page.

Node.js version error

This project requires Node.js 22+. Check with node --version and upgrade if needed via nvm or your package manager.

Screenshots are blank or wrong size

The screenshot reflects the actual rendered viewport. If the tab is in a background window or the OS has display scaling, pixel coordinates for clickxy may need adjustment. Use snap or eval to inspect DOM state instead of relying solely on screenshots.

Architecture Notes

  • No Puppeteer, no Playwright, no intermediary — pure CDP WebSocket
  • One persistent daemon process per tab (auto-spawned on first access)
  • Daemon reuse is why 100+ tabs work reliably (no timeout on target enumeration)
  • type uses CDP Input domain directly, bypassing iframe origin restrictions

来源与署名

来源：reason-machines/trending-skills位于skills/chrome-cdp-live-browser提交2384a00

许可证： 无许可证

内容归原作者所有。SourceWeft 从公开仓库中收录这些内容。

举报或申请下架

更多来自 reason-machines/trending-skills 的技能

Yourvpndead Vpn Detection

reason-machines

介绍一款 Android 应用，用于检测 VPN 客户端并探测本机 SOCKS5 与 Clash API 端口是否泄露。

Security833个月前更新

X Mentor Skill Nuwa

reason-machines

提供 X（Twitter）内容策略指导：推文与长推写作、钩子点评、增长策略与账号诊断。

Marketing & Sales833个月前更新

Wildworld Dataset

reason-machines

介绍 WildWorld 动作条件 ARPG 世界建模数据集，并给出预期的加载、筛选与基准评测代码。

Data & Analytics833个月前更新

Understand Anything Knowledge Graph

reason-machines

为代码库构建可交互的知识图谱，并支持可视化探索、搜索和提问。

Software Development833个月前更新

Webphysics Avbd Engine

reason-machines

指导将实验性 WebGPU AVBD 刚体与软体物理引擎集成到浏览器项目中。

Software Development833个月前更新

Ui Ux Pro Max Skill

reason-machines

根据产品描述生成 UI/UX 设计系统，包括页面结构、风格、配色、字体搭配与检查清单。

Design & Creative833个月前更新

更多Productivity & Workflow技能

Dd Meeting Prep

anthropics

精选

为尽职调查会议（如管理层演示、专家访谈）准备问题清单、基准数据和需重点探查的风险信号。

Productivity & Workflow39K2周前更新

Dd Checklist

anthropics

精选

生成并跟踪按行业定制的尽职调查清单，涵盖各工作流、状态跟踪与红旗升级。

Productivity & Workflow39K2周前更新

Deal Tracker

anthropics

精选

跟踪进行中的并购交易，管理里程碑、截止日期、行动项和每周交易回顾。

Productivity & Workflow39K2周前更新

Client Review

anthropics

精选

为客户回顾会议准备投资组合业绩、配置分析、谈话要点和行动事项。

Productivity & Workflow39K2周前更新

Morning Note

anthropics

精选

为覆盖股票撰写简明的晨会纪要，涵盖隔夜动态、交易想法和当日关键事件。

Productivity & Workflow39K2周前更新

Notion Spec To Implementation

openai

精选

把 Notion 规格说明转化为实施计划、关联任务和进度更新。

Productivity & Workflow27K4周前更新