cdp-bridge-mcp-browser-control — Claude Code skill
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.
no license 218 installs ★ 9 updated 2026-10-09
npx skills add reason-machines/mcp-skills --skill cdp-bridge-mcp-browser-control -a claude-codeWhat cdp-bridge-mcp-browser-control 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.
What it helps with
- 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 for the agent
- Connect to my browser tabs and list what's open
- Run this JavaScript in the current page
- Take a screenshot of this page
How to install cdp-bridge-mcp-browser-control
1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill cdp-bridge-mcp-browser-control -a claude-code2Manually: put the files in place
~/.claude/skills/cdp-bridge-mcp-browser-control/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/cdp-bridge-mcp-browser-control/
1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill cdp-bridge-mcp-browser-control -a codex2Manually: put the files in place
.agents/skills/cdp-bridge-mcp-browser-control/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill cdp-bridge-mcp-browser-control -a cursor2Manually: put the files in place
.cursor/skills/cdp-bridge-mcp-browser-control/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install reason-machines/mcp-skills skills/cdp-bridge-mcp-browser-control2Manually: put the files in place
.github/skills/cdp-bridge-mcp-browser-control/SKILL.md1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill cdp-bridge-mcp-browser-control -a gemini-cli2Platform CLI
gemini skills install https://github.com/reason-machines/mcp-skills --path skills/cdp-bridge-mcp-browser-controlManually: put the files in place
.devin/skills/cdp-bridge-mcp-browser-control/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill cdp-bridge-mcp-browser-control -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about cdp-bridge-mcp-browser-control
How do I install cdp-bridge-mcp-browser-control in Claude Code?
Run npx skills add reason-machines/mcp-skills --skill cdp-bridge-mcp-browser-control -a claude-code. The skill lands at ~/.claude/skills/cdp-bridge-mcp-browser-control/SKILL.md.
What does cdp-bridge-mcp-browser-control do?
It hands an agent the cdp-bridge MCP tools: tabs, page scans, JavaScript, navigation, screenshots and cookies, all against the browser you are already logged into.
What has to be running for the skill to work?
The server from uvx cdp-bridge@latest and the unpacked extension loaded from src/cdp_bridge/tmwd_cdp_bridge. The extension connects to 127.0.0.1:18765 and retries until the server responds.