vibheksoni/stealth-browser-mcp
The only browser automation that bypasses anti-bot systems. AI writes network hooks, clones UIs pixel-perfect via simple chat.
1,577 ★237 forksPythonUpdated 13d ago
What you need to know
Stealth browser automation for MCP-compatible AI agents — navigates Cloudflare challenges, anti-bot checks, and login walls with real Chrome-family browser instances powered by nodriver and CDP, exposing 97 modular tools across 11 sections.
Install
git clone https://github.com/vibheksoni/stealth-browser-mcp.git && cd stealth-browser-mcp && python -m venv venv && pip install -r requirements.txt
Claude Code: claude mcp add-json stealth-browser-mcp "{"type":"stdio","command":"<venv>/bin/python","args":["<clone>/src/server.py"]}"
Manual config for Claude Desktop / Cursor via mcpServers JSON; or experimental: fastmcp install claude-desktop src/server.py --with-requirements requirements.txtUsage
- •Ask the agent: "Use stealth-browser to navigate to https://example.com and take a screenshot"
- •spawn_browser() -> navigate() -> query_elements()/click_element()/type_text() -> take_screenshot()
- •Network work: list_network_requests(), get_request_details(), get_response_content(), modify_headers()
- •Trim the surface: python src/server.py --minimal (20 tools) or --disable-cdp-functions --disable-dynamic-hooks
Key features
- ✓Anti-bot resistance: has passed Cloudflare and Queue-It style challenges in testing (results vary by site/region/browser/detector)
- ✓97 tools across 11 modular sections (browser-management, element-interaction, element-extraction, network-debugging, cdp-functions, progressive-cloning, cookies-storage, tabs, debugging, dynamic-hooks)
- ✓Pixel-accurate element cloning with CSS, DOM structure, events, animations, and assets via CDP; progressive on-demand cloning
- ✓Network inspection and a dynamic hook system (restricted Python hooks that intercept, block, redirect, fulfill, or modify requests)
- ✓CDP execution (JS, direct CDP commands, pre-document scripts), cross-platform with automatic Chrome/Chromium/Edge discovery
Best for
Web scraping, UI cloning, market research, and API reverse-engineering that must pass anti-bot checks and login walls from within an AI agent conversation.
Caveats
- ⚠Anti-bot/stealth results are point-in-time and not guaranteed — they depend on site policy, region, browser version, IP reputation, and detector version
- ⚠Trust model: exposes powerful local browser-control primitives (CDP, JS execution, cookie/storage access, network interception, file uploads from allowlisted paths) — recommended deployment is local stdio with a trusted client; set STEALTH_BROWSER_MCP_AUTH_TOKEN for HTTP and do not expose unauthenticated HTTP outside trusted networks
- ⚠Requires Python 3.10+ and an installed Chrome, Chromium, or Microsoft Edge; Linux/Docker/CI may need --sandbox=false or sandbox support
Platforms: Windows · macOS · Linux · Docker · CIClients: Claude Code · Claude Desktop · Cursor
Documentation ↗Reviewed 2026-08-07
Topics
ai-agent-toolsai-toolsanthropicanti-bot-bypassautomation-toolsbrowser-automationchrome-devtoolsclaude-mcpcloudflare-bypassdeveloper-toolsfastmcpmcp-servermodel-context-protocolnetwork-interceptionnodriverpythonstealth-browserundetectable-browserweb-automationweb-scraping
- Stars
- 1,577★
- Forks
- 237
- Language
- Python
- License
- MIT
- Created
- 2025-08-09
- Last push
- 2026-07-24