chrome-cdp

Automate Chrome DevTools Protocol commands for debugging and testing workflows.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/BoChao1Zhang/dotfiles --skill chrome-cdp-bochao1zhang
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: chrome-cdp
Source: https://github.com/BoChao1Zhang/dotfiles/tree/main/dot_claude/skills/chrome-cdp
Command: npx skills add https://github.com/BoChao1Zhang/dotfiles --skill chrome-cdp-bochao1zhang

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Automates interactive control of a local Chrome session via the Chrome DevTools Protocol (CDP) with explicit user approval.

Core Features & Use Cases

  • Reliable CDP-based control: list tabs, navigate, capture screenshots, inspect DOM, and simulate user interactions.
  • Per-tab daemon orchestration: keeps sessions alive and enables scripted automation while ensuring safety prompts.
  • Safe debugging workflows: requires explicit permission for headful interactions and supports opening new tabs on demand.

Quick Start

Open a Chrome session with remote debugging enabled and start issuing CDP commands to automate your workflow.

Frequently Asked Questions about chrome-cdp

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate Chrome browser interactions via the DevTools Protocol securely?

Automating Chrome via the DevTools Protocol (CDP) securely requires explicit user approval for headful interactions to ensure safe and auditable operations. This approach uses a per-tab daemon and a deterministic command surface to prevent unintended actions during automated testing and debugging workflows.

What do I need to start controlling a local Chrome session with CDP commands?

To start controlling a local Chrome session with CDP commands, you need to open Chrome with remote debugging enabled. Once active, you can issue deterministic commands like list, nav, eval, and click to automate inspection and testing workflows across open tabs.

Does CDP automation support simulating user interactions like clicking and typing?

Yes, CDP automation supports simulating user interactions like clicking and typing through dedicated commands. You can use click, clickxy, and type commands to script deterministic user flows, capture screenshots, and inspect the DOM during automated testing.

Can I capture network activity and take screenshots while debugging a Chrome tab?

Yes, you can capture network activity and take screenshots while debugging a Chrome tab using specific CDP commands. The net command logs network requests, while the shot command captures visual snapshots, enabling comprehensive inspection of user flows and page states.

Why does CDP browser automation require explicit consent for headful interactions?

CDP browser automation requires explicit consent for headful interactions to maintain secure, auditable operations and prevent unauthorized scripts from controlling your browser. This safety prompt ensures that automated debugging and inspection workflows only execute with the user's direct permission.