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.txt

Usage

  • 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
View on GitHub ↗
Stars
1,577★
Forks
237
Language
Python
License
MIT
Created
2025-08-09
Last push
2026-07-24