# Browser Cdp

Use this skill when the user explicitly wants to connect to a running Chrome browser...

- Repository: https://github.com/agentscope-ai/QwenPaw (37135 stars)
- Category: Testing
- License: Apache-2.0
- Last updated: 2026-10-30
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add agentscope-ai/QwenPaw --skill browser_cdp -g -a claude-code -y`
Codex: `npx skills add agentscope-ai/QwenPaw --skill browser_cdp -g -a codex -y`
Cursor: `npx skills add agentscope-ai/QwenPaw --skill browser_cdp -g -a cursor -y`
Gemini CLI: `npx skills add agentscope-ai/QwenPaw --skill browser_cdp -g -a gemini-cli -y`

## Description

Use this skill when the user explicitly wants to connect to a running Chrome browser, scan local CDP ports, specify a `cdp_port`, or share a single browser across multiple agents/tools. By default browser opens no debugging port; pass an explicit `cdp_port` only when the user wants another local tool to attach.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

> **Deprecated:** This reference supports the stable `browser` implementation.
> hatch. Prefer the unified `browser` tool when experimental mode is enabled.

# Browser CDP Reference

By default, **browser** opens no debugging port: the browser is managed directly by Playwright. This skill covers the cases where a CDP port is wanted on purpose.

This skill focuses on more "explicit" CDP usage:

1. **Scanning local CDP ports**
2. **Connecting to an existing Chrome (`connect_cdp`)**
3. **Explicitly specifying a `cdp_port` when launching the browser**
4. **Sharing a single browser instance across multiple agents/tools**

In other words:

- The default `start` opens no debugging port, so users typically do not need to understand or be aware of CDP details
- Only enter the scope of this skill when the user explicitly mentions "connect to an existing browser / scan ports / specify a port / share a browser"

> **Privacy Recommendation**
>
> The default `start` exposes nothing, no debugging port is opened. Only pass `cdp_port` when the user explicitly wants another local tool to attach, and warn about the exposure first.

> **Warning: One browser instance per workspace**
>
> Only one browser can be running or connected per workspace at a time. If a browser instance already exists, you must execute `stop` first before switching to a new browser or a new CDP connection.

---

## When to Use

Use this skill only when the user explicitly expresses one of the following intentions:

- "Connect to my already-open Chrome"
- "Scan for available CDP ports on this machine"
- "Launch the browser with a fixed debug port"
- "Let other agents/tools connect to this browser too"
- "Attach to the browser via the remote debugging port"

In the following cases, you should typically **not** use this skill:

- The user just says "open the browser"
- The user just says "open a visible window"
- The user does not mention sharing, ports, CDP, or remote debugging

The rest: https://github.com/agentscope-ai/QwenPaw/blob/HEAD/src/qwenpaw/agents/tools/deprecated_browser/skills/browser_cdp-en/SKILL.md