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 週前更新