# cdp-bridge-mcp-browser-control

cdp-bridge-mcp-browser-control is a Claude Code skill that connects your agent to open Chrome tabs via CDP to read pages, run JavaScript, and take screenshots while keeping logins and cookies intact.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 218 installs · ★ 9 repo stars
- Author: reason-machines
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/reason-machines/mcp-skills/tree/HEAD/skills/cdp-bridge-mcp-browser-control/SKILL.md
- Updated: 2026-10-09
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/cdp-bridge-mcp-browser-control

## What it does

This skill teaches an agent to drive the cdp-bridge MCP server, which talks to a live browser over Chrome DevTools Protocol rather than starting a headless one. The toolset covers listing tabs, scanning a page as cleaned HTML or plain text, executing JavaScript, navigating, polling a condition, capturing base64 PNG screenshots and reading domain cookies.

The server ships on PyPI and runs through `uvx cdp-bridge@latest`; add `--transport streamable-http --port 8000` when several clients share one instance. In Chrome you turn on developer mode at `chrome://extensions/`, hit `Load unpacked` and point at `src/cdp_bridge/tmwd_cdp_bridge` from the repository. That extension keeps retrying a WebSocket to `127.0.0.1:18765` until something answers.

Page scans drop `<script>`, `<style>` and hidden nodes, so a heavy SPA arrives as a trimmed DOM. Injection tries `chrome.scripting` first and falls back to CDP `Runtime.evaluate` when a content security policy blocks it. With no extension loaded or no server running there is nothing to call.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill cdp-bridge-mcp-browser-control -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/cdp-bridge-mcp-browser-control/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/cdp-bridge-mcp-browser-control/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill cdp-bridge-mcp-browser-control -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/cdp-bridge-mcp-browser-control/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill cdp-bridge-mcp-browser-control -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/cdp-bridge-mcp-browser-control/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install reason-machines/mcp-skills skills/cdp-bridge-mcp-browser-control
```

2. **Manually: put the files in place**
- File: `.github/skills/cdp-bridge-mcp-browser-control/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill cdp-bridge-mcp-browser-control -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/reason-machines/mcp-skills --path skills/cdp-bridge-mcp-browser-control
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/cdp-bridge-mcp-browser-control/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill cdp-bridge-mcp-browser-control -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/reason-machines/mcp-skills/tree/HEAD/skills/cdp-bridge-mcp-browser-control/SKILL.md

## When to use it
- read a page you are already signed into without logging in again
- run JavaScript in a live tab and get the value back
- wait for a late element before scraping an SPA
- capture a PNG screenshot of the active tab
- pull domain cookies while debugging a session

## Example prompts
- Connect to my browser tabs and list what's open
- Run this JavaScript in the current page
- Take a screenshot of this page

## Similar
- [chrome-cdp-live-browser](https://affpapa.org/en/nevibecode/skills/chrome-cdp-live-browser.md) — skill · 1500 installs
- [web-browser](https://affpapa.org/en/nevibecode/skills/web-browser.md) — skill · 685 installs
- [browser](https://affpapa.org/en/nevibecode/skills/stellarlinkco-browser.md) — skill · 202 installs
- [mini-browser](https://affpapa.org/en/nevibecode/skills/mini-browser.md) — skill · 2400 installs
- [browser-tools](https://affpapa.org/en/nevibecode/skills/browser-tools.md) — skill · 479 installs
- [browser-harness](https://affpapa.org/en/nevibecode/plugins/browser-harness.md) — plugin · ★ 19185 repo stars

From the same set: [reason-machines/mcp-skills](https://affpapa.org/en/nevibecode/by/reason-machines/mcp-skills.md) — 98 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
