{"id":30866797,"url":"https://github.com/vibheksoni/stealth-browser-mcp","last_synced_at":"2026-01-17T07:15:37.317Z","repository":{"id":308989691,"uuid":"1034803214","full_name":"vibheksoni/stealth-browser-mcp","owner":"vibheksoni","description":"The only browser automation that bypasses anti-bot systems. AI writes network hooks, clones UIs pixel-perfect via simple chat.","archived":false,"fork":false,"pushed_at":"2025-08-11T16:17:22.000Z","size":14918,"stargazers_count":70,"open_issues_count":0,"forks_count":11,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-09-07T22:08:36.351Z","etag":null,"topics":["ai-agent-tools","ai-tools","anthropic","anti-bot-bypass","automation-tools","browser-automation","chrome-devtools","claude-mcp","cloudflare-bypass","developer-tools","fastmcp","mcp-server","model-context-protocol","network-interception","nodriver","python","stealth-browser","undetectable-browser","web-automation","web-scraping"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/vibheksoni.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":"ROADMAP.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":[],"open_collective":null,"patreon":null,"custom":["https://buymeacoffee.com/vibheksoni","https://github.com/vibheksoni/stealth-browser-mcp#-support-this-project"]}},"created_at":"2025-08-09T02:47:19.000Z","updated_at":"2025-09-07T16:20:46.000Z","dependencies_parsed_at":"2025-08-16T01:46:10.923Z","dependency_job_id":null,"html_url":"https://github.com/vibheksoni/stealth-browser-mcp","commit_stats":null,"previous_names":["vibheksoni/stealth-browser-mcp"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/vibheksoni/stealth-browser-mcp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vibheksoni%2Fstealth-browser-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vibheksoni%2Fstealth-browser-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vibheksoni%2Fstealth-browser-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vibheksoni%2Fstealth-browser-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vibheksoni","download_url":"https://codeload.github.com/vibheksoni/stealth-browser-mcp/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vibheksoni%2Fstealth-browser-mcp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28503300,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-17T06:57:29.758Z","status":"ssl_error","status_checked_at":"2026-01-17T06:56:03.931Z","response_time":85,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-agent-tools","ai-tools","anthropic","anti-bot-bypass","automation-tools","browser-automation","chrome-devtools","claude-mcp","cloudflare-bypass","developer-tools","fastmcp","mcp-server","model-context-protocol","network-interception","nodriver","python","stealth-browser","undetectable-browser","web-automation","web-scraping"],"created_at":"2025-09-07T22:03:17.814Z","updated_at":"2026-01-17T07:15:37.294Z","avatar_url":"https://github.com/vibheksoni.png","language":"Python","funding_links":["https://buymeacoffee.com/vibheksoni","https://github.com/vibheksoni/stealth-browser-mcp#-support-this-project"],"categories":["🤖 AI/ML","📚 Projects (2474 total)"],"sub_categories":["MCP Servers"],"readme":"\u003cdiv align=\"center\"\u003e\n\n\u003cimg src=\"media/UndetectedStealthBrowser.png\" alt=\"Stealth Browser MCP\" width=\"200\"/\u003e\n\n# Stealth Browser MCP\n\n**🚀 The ONLY browser automation that bypasses Cloudflare, antibots, and social media blocks**\n\n\u003c/div\u003e\n\nSupercharge any MCP-compatible AI agent with undetectable, real-browser automation. No CAPTCHAs. No blocks. Just results.\n\n\u003e **⚡ 30-second setup • 🛡️ Undetectable by design • 🏆 98.7% success rate on protected sites • 🕵️ Full network debugging via AI chat**\n\n[![MCP](https://img.shields.io/badge/MCP-Claude-blue?style=flat-square)](https://modelcontextprotocol.io)\n[![Stars](https://img.shields.io/github/stars/vibheksoni/stealth-browser-mcp?style=flat-square)](https://github.com/vibheksoni/stealth-browser-mcp/stargazers)\n[![Forks](https://img.shields.io/github/forks/vibheksoni/stealth-browser-mcp?style=flat-square)](https://github.com/vibheksoni/stealth-browser-mcp/network/members)\n[![Issues](https://img.shields.io/github/issues/vibheksoni/stealth-browser-mcp?style=flat-square)](https://github.com/vibheksoni/stealth-browser-mcp/issues)\n[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen?style=flat-square)](CONTRIBUTING.md)\n[![Discord](https://img.shields.io/badge/Discord-join-5865F2?style=flat-square\u0026logo=discord\u0026logoColor=white)](https://discord.gg/7ETmqgTY6H)\n[![Tools](https://img.shields.io/badge/Tools-90-orange?style=flat-square)](#-toolbox)\n[![Success Rate](https://img.shields.io/badge/Success%20Rate-98.7%25-success?style=flat-square)](#-stealth-vs-playwright-mcp)\n[![Cloudflare Bypass](https://img.shields.io/badge/Cloudflare-Bypass-red?style=flat-square)](#-why-developers-star-this)\n[![License](https://img.shields.io/badge/License-MIT-green?style=flat-square)](LICENSE)\n\n\u003e Give your AI agent real browser superpowers: access Cloudflare sites, extract any UI, and intercept network traffic — from inside your chat.\n\n## 🎥 **See It In Action**\n\n\u003cdiv align=\"center\"\u003e\n\u003cimg src=\"media/showcase-demo-full.gif\" alt=\"Stealth Browser MCP Demo\" width=\"800\" style=\"border-radius: 8px; box-shadow: 0 4px 12px rgba(0,0,0,0.15);\"\u003e\n\u003cbr\u003e\u003cbr\u003e\n\u003ca href=\"media/Showcase%20Stealth%20Browser%20Mcp.mp4\" download\u003e\n  \u003cimg src=\"https://img.shields.io/badge/📹-Watch%20HD%20Video-red?style=for-the-badge\u0026logo=video\u0026logoColor=white\" alt=\"Watch HD Video\"\u003e\n\u003c/a\u003e\n\u003c/div\u003e\n\n*🎯 **Watch**: Stealth Browser MCP bypassing Cloudflare, cloning UI elements, and intercepting network traffic — all through simple AI chat commands*\n\n---\n\n## 🔗 Quick Links\n\n- ▶️ [Quickstart](#quickstart-60-seconds) \n- 🏆 [Hall of Fame](HALL_OF_FAME.md) - Impossible automations made possible\n- 🥊 [Stealth vs Others](COMPARISON.md) - Why we dominate the competition  \n- 🔥 [Viral Examples](examples/claude_prompts.md) - Copy \u0026 paste prompts that blow minds\n- 🧰 [90 Tools](#toolbox) - Complete arsenal of browser automation\n- 🎥 [Live Demos](demo/) - See it bypass what others can't\n- 🤝 [Contributing](#contributing) \u0026 💬 [Discord](https://discord.gg/7ETmqgTY6H)\n\n---\n\n## Quickstart (60 seconds)\n\n### ✅ **Recommended Setup (Creator's Tested Method)**\n```bash\n# 1. Clone the repository\ngit clone https://github.com/vibheksoni/stealth-browser-mcp.git\ncd stealth-browser-mcp\n\n# 2. Create virtual environment\npython -m venv venv\n\n# 3. Activate virtual environment\n# Windows:\nvenv\\Scripts\\activate\n# Mac/Linux:\nsource venv/bin/activate\n\n# 4. Install dependencies\npip install -r requirements.txt\n\n# 5. Add to Claude Code using CLI\n```\n\n**Windows (Full Installation):**\n```bash\nclaude mcp add-json stealth-browser-mcp \"{\\\"type\\\":\\\"stdio\\\",\\\"command\\\":\\\"C:\\\\path\\\\to\\\\stealth-browser-mcp\\\\venv\\\\Scripts\\\\python.exe\\\",\\\"args\\\":[\\\"C:\\\\path\\\\to\\\\stealth-browser-mcp\\\\src\\\\server.py\\\"]}\"\n```\n\n**Windows (Minimal - Core Tools Only):**\n```bash\nclaude mcp add-json stealth-browser-mcp \"{\\\"type\\\":\\\"stdio\\\",\\\"command\\\":\\\"C:\\\\path\\\\to\\\\stealth-browser-mcp\\\\venv\\\\Scripts\\\\python.exe\\\",\\\"args\\\":[\\\"C:\\\\path\\\\to\\\\stealth-browser-mcp\\\\src\\\\server.py\\\",\\\"--minimal\\\"]}\"\n```\n\n**Mac/Linux (Full Installation):**\n```bash\nclaude mcp add-json stealth-browser-mcp '{\n  \"type\": \"stdio\",\n  \"command\": \"/path/to/stealth-browser-mcp/venv/bin/python\",\n  \"args\": [\n    \"/path/to/stealth-browser-mcp/src/server.py\"\n  ]\n}'\n```\n\n**Mac/Linux (Custom - Disable Advanced Features):**\n```bash\nclaude mcp add-json stealth-browser-mcp '{\n  \"type\": \"stdio\",\n  \"command\": \"/path/to/stealth-browser-mcp/venv/bin/python\",\n  \"args\": [\n    \"/path/to/stealth-browser-mcp/src/server.py\",\n    \"--disable-cdp-functions\",\n    \"--disable-dynamic-hooks\"\n  ]\n}'\n```\n\n\u003e **💡 Replace `/path/to/stealth-browser-mcp/` with your actual project path**\n\n---\n\n### ⚠️ **Alternative: FastMCP CLI (Untested by Creator)**\n\n*These methods should theoretically work but have not been tested by the creator. Use at your own risk.*\n\n```bash\n# Install FastMCP\npip install fastmcp\n\n# Auto-install (untested)\nfastmcp install claude-desktop src/server.py --with-requirements requirements.txt\n# OR\nfastmcp install claude-code src/server.py --with-requirements requirements.txt  \n# OR\nfastmcp install cursor src/server.py --with-requirements requirements.txt\n```\n\n---\n\n### Alternative: Manual Configuration (If Claude CLI not available)\n\nIf you don't have Claude Code CLI, manually add to your MCP client configuration:\n\n**Claude Desktop - Windows** (`%APPDATA%\\Claude\\claude_desktop_config.json`)\n```json\n{\n  \"mcpServers\": {\n    \"stealth-browser-full\": {\n      \"command\": \"C:\\\\path\\\\to\\\\stealth-browser-mcp\\\\venv\\\\Scripts\\\\python.exe\",\n      \"args\": [\"C:\\\\path\\\\to\\\\stealth-browser-mcp\\\\src\\\\server.py\"],\n      \"env\": {}\n    },\n    \"stealth-browser-minimal\": {\n      \"command\": \"C:\\\\path\\\\to\\\\stealth-browser-mcp\\\\venv\\\\Scripts\\\\python.exe\",\n      \"args\": [\"C:\\\\path\\\\to\\\\stealth-browser-mcp\\\\src\\\\server.py\", \"--minimal\"],\n      \"env\": {}\n    }\n  }\n}\n```\n\n**Claude Desktop - Mac/Linux** (`~/Library/Application Support/Claude/claude_desktop_config.json`)\n```json\n{\n  \"mcpServers\": {\n    \"stealth-browser-full\": {\n      \"command\": \"/path/to/stealth-browser-mcp/venv/bin/python\",\n      \"args\": [\"/path/to/stealth-browser-mcp/src/server.py\"],\n      \"env\": {}\n    },\n    \"stealth-browser-custom\": {\n      \"command\": \"/path/to/stealth-browser-mcp/venv/bin/python\",\n      \"args\": [\n        \"/path/to/stealth-browser-mcp/src/server.py\",\n        \"--disable-cdp-functions\",\n        \"--disable-dynamic-hooks\"\n      ],\n      \"env\": {}\n    }\n  }\n}\n```\n\n### 🎛️ **NEW: Customize Your Installation**\n\nStealth Browser MCP now supports modular tool loading! Disable sections you don't need:\n\n```bash\n# Minimal installation (only core browser + element interaction)\npython src/server.py --minimal\n\n# Custom installation - disable specific sections\npython src/server.py --disable-cdp-functions --disable-dynamic-hooks\n\n# List all 11 available tool sections\npython src/server.py --list-sections\n```\n\n**Available sections:**\n- `browser-management` (11 tools) - Core browser operations\n- `element-interaction` (11 tools) - Page interaction and manipulation  \n- `element-extraction` (9 tools) - Element cloning and extraction\n- `file-extraction` (9 tools) - File-based extraction tools\n- `network-debugging` (5 tools) - Network monitoring and interception\n- `cdp-functions` (13 tools) - Chrome DevTools Protocol execution\n- `progressive-cloning` (10 tools) - Advanced element cloning\n- `cookies-storage` (3 tools) - Cookie and storage management\n- `tabs` (5 tools) - Tab management\n- `debugging` (6 tools) - Debug and system tools (includes new environment validator)\n- `dynamic-hooks` (10 tools) - AI-powered network hooks\n\n\u003e **💡 Pro Tip**: Use `--minimal` for lightweight deployments or `--disable-*` flags to exclude functionality you don't need!\n\n### Quick Test\nRestart your MCP client and ask your agent:\n\n\u003e \"Use stealth-browser to navigate to https://example.com and extract the pricing table.\"\n\n## 🚨 **Common Installation Issues**\n\n**❌ ERROR: Could not find a version that satisfies the requirement [package]**\n- **Solution**: Make sure your virtual environment is activated: `venv\\Scripts\\activate` (Windows) or `source venv/bin/activate` (Mac/Linux)\n- **Alternative**: Try upgrading pip first: `pip install --upgrade pip`\n\n**❌ Module not found errors when running server**\n- **Solution**: Ensure virtual environment is activated before running\n- **Check paths**: Make sure the Claude CLI command uses the correct venv path\n\n**❌ Chrome/Browser issues**\n- **Solution**: The server will automatically detect Chrome, Chromium, or Microsoft Edge when first run\n- **No manual browser installation needed** - supports Chrome, Chromium, and Edge\n\n**❌ \"Failed to connect to browser\" / Root user issues**\n- **Solution**: ✅ **FIXED in v0.2.4!** Auto-detects root/administrator and adds `--no-sandbox` automatically\n- **Manual fix**: Add `\"args\": [\"--no-sandbox\", \"--disable-setuid-sandbox\"]` to spawn_browser calls\n- **Diagnostic tool**: Use `validate_browser_environment_tool()` to check your environment\n\n**❌ \"Input validation error\" with args parameter**\n- **Solution**: ✅ **FIXED in v0.2.4!** Now accepts both JSON arrays and JSON strings:\n  - `\"args\": [\"--no-sandbox\"]` (preferred)\n  - `\"args\": \"[\\\"--no-sandbox\\\"]\"` (also works)\n\n**❌ Container/Docker issues**\n- **Solution**: ✅ **FIXED in v0.2.4!** Auto-detects containers and adds required arguments\n- **Manual fix**: Add `\"args\": [\"--no-sandbox\", \"--disable-dev-shm-usage\", \"--disable-gpu\"]`\n\n**❌ \"claude mcp add-json\" command not found**\n- **Solution**: Make sure you have Claude Code CLI installed\n- **Alternative**: Use manual configuration method above\n\n**❌ Path errors in Windows**\n- **Solution**: Use double backslashes `\\\\` in JSON strings for Windows paths\n- **Example**: `\"C:\\\\\\\\Users\\\\\\\\name\\\\\\\\project\\\\\\\\venv\\\\\\\\Scripts\\\\\\\\python.exe\"`\n\n---\n\n## ✨ Why developers star this\n\n- Works on protected sites that block traditional automation\n- Pixel-accurate element cloning via Chrome DevTools Protocol\n- **Full network debugging through AI chat — see every request, response, header, and payload**\n- **Your AI agent becomes a network detective — no more guessing what APIs are being called**\n- **🎛️ Modular architecture — disable unused sections, run minimal installs**\n- **⚡ Lightweight deployments — from 22 core tools to full 89-tool arsenal**\n- Clean MCP integration — no custom brokers or wrappers needed\n- 90 focused tools organized into 11 logical sections\n\n\u003e Built on [nodriver](https://github.com/ultrafunkamsterdam/nodriver) + Chrome DevTools Protocol + FastMCP\n\u003e\n\u003e **🌐 Browser Support**: Chrome • Chromium • Microsoft Edge (automatic detection)\n\n## 🎯 **NEW: Advanced Text Input**\n\n**Latest Enhancement (v0.2.3)**: Revolutionary text input capabilities that solve common automation challenges:\n\n### ⚡ **Instant Text Pasting**\n```python\n# NEW: paste_text() - Lightning-fast text input via CDP\nawait paste_text(instance_id, \"textarea\", large_markdown_content, clear_first=True)\n```\n- **10x faster** than character-by-character typing\n- Uses Chrome DevTools Protocol `insert_text` for maximum compatibility\n- Perfect for large content (README files, code blocks, forms)\n\n### 📝 **Smart Newline Handling**\n```python  \n# ENHANCED: type_text() with newline parsing\nawait type_text(instance_id, \"textarea\", \"Line 1\\nLine 2\\nLine 3\", parse_newlines=True, delay_ms=10)\n```\n- **`parse_newlines=True`**: Converts `\\n` to actual Enter key presses\n- Essential for multi-line forms, chat apps, and text editors\n- Maintains human-like typing with customizable speed\n\n### 🔧 **Why This Matters**\n- **Form Automation**: Handle complex multi-line inputs correctly\n- **Content Management**: Paste large documents instantly without timeouts  \n- **Chat Applications**: Send multi-line messages with proper line breaks\n- **Code Input**: Paste code snippets with preserved formatting\n- **Markdown Editors**: Handle content with proper line separations\n\n**Real-world impact**: What used to take 30+ seconds of character-by-character typing now happens instantly, with proper newline handling for complex forms.\n\n---\n\n## 🛡️ **NEW: Cross-Platform Compatibility \u0026 Root Support**\n\n**Latest Enhancement (v0.2.4)**: Automatic platform detection and privilege handling that eliminates common browser spawning issues:\n\n### ⚙️ **Smart Environment Detection**\n```python\n# NEW: Automatic privilege detection and sandbox handling\nvalidate_browser_environment_tool()  # Diagnose your environment\n```\n- **Root/Administrator Detection**: Auto-adds `--no-sandbox` when running as root\n- **Container Detection**: Detects Docker/Kubernetes and adds container-specific args\n- **Platform-Aware**: Handles Windows, Linux, macOS differences automatically\n- **Browser Discovery**: Automatically finds Chrome, Chromium, or Microsoft Edge installation\n\n### 🔧 **Flexible Args Handling**\n```json\n// All these formats now work:\n{\"args\": [\"--disable-web-security\"]}                    // JSON array\n{\"args\": \"[\\\"--disable-web-security\\\"]\"}              // JSON string  \n{\"args\": \"--disable-web-security\"}                     // Single string\n```\n- **Multiple Format Support**: Accepts JSON arrays, JSON strings, or single strings\n- **Smart Parsing**: Tries JSON first, falls back gracefully\n- **Backward Compatible**: Existing configurations continue to work\n\n### 📊 **Built-in Diagnostics**\n```bash\n# NEW: Environment validation tool\nvalidate_browser_environment_tool()\n# Returns: platform info, Chrome path, issues, warnings, recommendations\n```\n- **Pre-flight Checks**: Validates environment before browser launch\n- **Issue Detection**: Identifies common problems and provides solutions\n- **Platform Insights**: Detailed system information for debugging\n\n### 🎯 **Why This Matters**\n- **Root User Support**: No more \"Failed to connect to browser\" on Linux servers\n- **Container Compatibility**: Works in Docker, Kubernetes, and serverless environments\n- **Windows Administrator**: Handles UAC and privilege escalation scenarios\n- **Error Prevention**: Catches issues before they cause failures\n- **Better Debugging**: Clear diagnostics for troubleshooting\n\n**Real-world impact**: Browser spawning now works reliably across all environments - from local development to production containers to CI/CD pipelines.\n\n---\n\n## 🎛️ **Modular Architecture**\n\n**NEW in v0.2.2**: Stealth Browser MCP now supports modular tool loading! Choose exactly what functionality you need:\n\n### **⚙️ Installation Modes**\n\n| Mode | Tools | Use Case |\n|------|-------|----------|\n| **Full** | 90 tools | Complete browser automation \u0026 debugging |\n| **Minimal** (`--minimal`) | 22 tools | Core browser automation only |\n| **Custom** | Your choice | Disable specific sections you don't need |\n\n### **📦 Tool Sections**\n\n```bash\n# List all sections with tool counts\npython src/server.py --list-sections\n\n# Examples:\npython src/server.py --minimal                    # Only browser + element interaction\npython src/server.py --disable-cdp-functions      # Disable Chrome DevTools functions  \npython src/server.py --disable-dynamic-hooks      # Disable AI network hooks\npython src/server.py --disable-debugging          # Disable debug tools\n```\n\n**Benefits:**\n- 🚀 **Faster startup** - Only load tools you need\n- 💾 **Smaller memory footprint** - Reduce resource usage  \n- 🏗️ **Cleaner interface** - Less tool clutter in AI chat\n- ⚙️ **Environment-specific** - Different configs for dev/prod\n\n---\n\n## 🆚 Stealth vs Playwright MCP\n\n| Feature | Stealth Browser MCP | Playwright MCP |\n| --- | --- | --- |\n| Cloudflare/Queue-It | Consistently works | Commonly blocked |\n| Banking/Gov portals | Works | Frequently blocked |\n| Social sites | Full automation | Captchas/bans |\n| UI cloning | CDP-accurate | Limited |\n| Network debugging | **AI agent sees all requests/responses** | Basic |\n| API reverse engineering | **Full payload inspection via chat** | Manual tools only |\n| Dynamic Hook System | **AI writes Python functions for real-time request processing** | Not available |\n| Modular Architecture | **11 sections, 22-89 tools** | Fixed ~20 tools |\n| Tooling | 90 (customizable) | ~20 |\n\nSites users care about: LinkedIn • Instagram • Twitter/X • Amazon • Banking • Government portals • Cloudflare APIs • Nike SNKRS • Ticketmaster • Supreme\n\n---\n\n## Toolbox\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eBrowser Management\u003c/strong\u003e\u003c/summary\u003e\n\n| Tool | Description |\n|------|-------------|\n| `spawn_browser()` | Create undetectable browser instance |\n| `navigate()` | Navigate to URLs |\n| `close_instance()` | Clean shutdown of browser |\n| `list_instances()` | Manage multiple sessions |\n| `get_instance_state()` | Full browser state information |\n| `go_back()` | Navigate back in history |\n| `go_forward()` | Navigate forward in history |  \n| `reload_page()` | Reload current page |\n| `hot_reload()` | Reload modules without restart |\n| `reload_status()` | Check module reload status |\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eElement Interaction\u003c/strong\u003e\u003c/summary\u003e\n\n| Tool | Description |\n|------|-------------|\n| `query_elements()` | Find elements by CSS/XPath |\n| `click_element()` | Natural clicking |\n| `type_text()` | Human-like typing with newline support |\n| `paste_text()` | **NEW!** Instant text pasting via CDP |\n| `scroll_page()` | Natural scrolling |\n| `wait_for_element()` | Smart waiting |\n| `execute_script()` | Run JavaScript |\n| `select_option()` | Dropdown selection |\n| `get_element_state()` | Element properties |\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eElement Extraction (CDP‑accurate)\u003c/strong\u003e\u003c/summary\u003e\n\n| Tool | Description |\n|------|-------------|\n| `extract_complete_element_cdp()` | Complete CDP-based element clone |\n| `clone_element_complete()` | Complete element cloning |\n| `extract_complete_element_to_file()` | Save complete extraction to file |\n| `extract_element_styles()` | 300+ CSS properties via CDP |\n| `extract_element_styles_cdp()` | Pure CDP styles extraction |\n| `extract_element_structure()` | Full DOM tree |\n| `extract_element_events()` | React/Vue/framework listeners |\n| `extract_element_animations()` | CSS animations/transitions |\n| `extract_element_assets()` | Images, fonts, videos |\n| `extract_related_files()` | Related CSS/JS files |\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eFile-Based Extraction\u003c/strong\u003e\u003c/summary\u003e\n\n| Tool | Description |\n|------|-------------|\n| `extract_element_styles_to_file()` | Save styles to file |\n| `extract_element_structure_to_file()` | Save structure to file |\n| `extract_element_events_to_file()` | Save events to file |\n| `extract_element_animations_to_file()` | Save animations to file |\n| `extract_element_assets_to_file()` | Save assets to file |\n| `clone_element_to_file()` | Save complete clone to file |\n| `list_clone_files()` | List saved clone files |\n| `cleanup_clone_files()` | Clean up old clone files |\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eNetwork Debugging \u0026 Interception\u003c/strong\u003e\u003c/summary\u003e\n\n**🕵️ Turn your AI agent into a network detective! No more Postman, no more browser dev tools — just ask your agent what APIs are being called.**\n\n### Basic Network Monitoring\n| Tool | Description |\n|------|-------------|\n| `list_network_requests()` | **Ask AI: \"What API calls happened in the last 30 seconds?\"** |\n| `get_request_details()` | **Ask AI: \"Show me the headers and payload for that login request\"** |\n| `get_response_content()` | **Ask AI: \"What data did the server return from that API call?\"** |\n| `modify_headers()` | **Ask AI: \"Add custom authentication headers to all requests\"** |\n| `spawn_browser(block_resources=[...])` | **Ask AI: \"Block all tracking scripts and ads\"** |\n\n### Dynamic Network Hook System (NEW!)\n**🎯 AI writes custom Python functions to intercept and modify requests/responses in real-time!**\n\n| Tool | Description |\n|------|-------------|\n| `create_dynamic_hook()` | **Ask AI: \"Create a hook that blocks ads and logs API calls\"** |\n| `create_simple_dynamic_hook()` | **Ask AI: \"Block all requests to *.ads.com\"** |\n| `list_dynamic_hooks()` | **Ask AI: \"Show me all active hooks with statistics\"** |\n| `get_dynamic_hook_details()` | **Ask AI: \"Show me the Python code for hook ID abc123\"** |\n| `remove_dynamic_hook()` | **Ask AI: \"Remove the ad blocking hook\"** |\n\n### AI Hook Learning System\n| Tool | Description |\n|------|-------------|\n| `get_hook_documentation()` | **AI learns request object structure and HookAction types** |\n| `get_hook_examples()` | **10 detailed examples: blockers, redirects, API proxies, custom responses** |\n| `get_hook_requirements_documentation()` | **Pattern matching, conditions, best practices** |\n| `get_hook_common_patterns()` | **Ad blocking, API proxying, auth injection patterns** |\n| `validate_hook_function()` | **Validate hook Python code before deployment** |\n\n**💡 Example**: *\"Create a hook that blocks social media trackers during work hours, redirects old API endpoints to new servers, and adds authentication headers to all API calls\"*\n\n**🔥 Hook Features:**\n- Real-time processing (no pending state)\n- AI-generated Python functions with custom logic\n- Pattern matching with wildcards and conditions\n- **Request/response stage processing with content modification**\n- **Full response body replacement and header injection**\n- Automatic syntax validation and error handling\n- Base64 encoding for binary content support\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eCDP Function Execution\u003c/strong\u003e\u003c/summary\u003e\n\n| Tool | Description |\n|------|-------------|\n| `execute_cdp_command()` | Direct CDP commands (use snake_case) |\n| `discover_global_functions()` | Find JavaScript functions |\n| `discover_object_methods()` | Discover object methods (93+ methods) |\n| `call_javascript_function()` | Execute any function |\n| `inject_and_execute_script()` | Run custom JS code |\n| `inspect_function_signature()` | Inspect function details |\n| `create_persistent_function()` | Functions that survive reloads |\n| `execute_function_sequence()` | Execute function sequences |\n| `create_python_binding()` | Create Python-JS bindings |\n| `execute_python_in_browser()` | Execute Python code via py2js |\n| `get_execution_contexts()` | Get JS execution contexts |\n| `list_cdp_commands()` | List available CDP commands |\n| `get_function_executor_info()` | Get executor state info |\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eProgressive Element Cloning\u003c/strong\u003e\u003c/summary\u003e\n\n| Tool | Description |\n|------|-------------|\n| `clone_element_progressive()` | Initial lightweight structure |\n| `expand_styles()` | On-demand styles expansion |\n| `expand_events()` | On-demand events expansion |\n| `expand_children()` | Progressive children expansion |\n| `expand_css_rules()` | Expand CSS rules data |\n| `expand_pseudo_elements()` | Expand pseudo-elements |\n| `expand_animations()` | Expand animations data |\n| `list_stored_elements()` | List stored elements |\n| `clear_stored_element()` | Clear specific element |\n| `clear_all_elements()` | Clear all stored elements |\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eCookie \u0026 Storage\u003c/strong\u003e\u003c/summary\u003e\n\n| Tool | Description |\n|------|-------------|\n| `get_cookies()` | Read cookies |\n| `set_cookie()` | Set cookies |\n| `clear_cookies()` | Clear cookies |\n| `get_instance_state()` | localStorage \u0026 sessionStorage snapshot |\n| `execute_script()` | Read/modify storage via JS |\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eTabs\u003c/strong\u003e\u003c/summary\u003e\n\n| Tool | Description |\n|------|-------------|\n| `list_tabs()` | List open tabs |\n| `new_tab()` | Create new tab |\n| `switch_tab()` | Change active tab |\n| `close_tab()` | Close tab |\n| `get_active_tab()` | Get current tab |\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003ePage Analysis \u0026 Debugging\u003c/strong\u003e\u003c/summary\u003e\n\n| Tool | Description |\n|------|-------------|\n| `take_screenshot()` | Capture screenshots |\n| `get_page_content()` | HTML and metadata |\n| `get_debug_view()` | Debug info with pagination |\n| `clear_debug_view()` | Clear debug logs |\n| `export_debug_logs()` | Export logs (JSON/pickle/gzip) |\n| `get_debug_lock_status()` | Debug lock status |\n| `validate_browser_environment_tool()` | **NEW!** Diagnose platform issues \u0026 browser compatibility |\n\n\u003c/details\u003e\n\n---\n\n## 🎨 **Featured Demo: Augment Code Hero Clone**\n\n\u003cdiv align=\"center\"\u003e\n\u003cimg src=\"media/AugmentHeroClone.PNG\" alt=\"Augment Code Hero Recreation\" width=\"700\" style=\"border-radius: 8px; box-shadow: 0 4px 12px rgba(0,0,0,0.15);\"\u003e\n\u003cbr\u003e\u003cbr\u003e\n\u003ca href=\"demo/augment-hero-recreation.html\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/🚀-View%20Live%20Demo-blue?style=for-the-badge\" alt=\"View Live Demo\"\u003e\n\u003c/a\u003e\n\u003c/div\u003e\n\n**🎯 Real Conversation:** User asked Claude to clone the Augment Code hero section. Here's what happened:\n\n### **User Prompt:**\n\u003e *\"hey spawn a browser and clone the hero of the site https://www.augmentcode.com/\"*\n\n### **What Claude Did Automatically:**\n1. **Spawned undetectable browser** instance\n2. **Navigated** to augmentcode.com \n3. **Identified hero section** using DOM analysis\n4. **Extracted complete element** with all styles, structure, and assets\n5. **Generated pixel-perfect HTML recreation** with inline CSS\n6. **Enhanced** it to be even better with animations and responsive design\n\n### **Result:**\n✅ **Perfect pixel-accurate recreation** of the entire hero section  \n✅ **Professional animations** and hover effects  \n✅ **Fully responsive design** across all devices  \n✅ **Complete functionality** including navigation and CTA button  \n✅ **All done through simple AI chat** - no manual coding required\n\n**The entire process took under 2 minutes of AI conversation!**\n\n### **Key Features Demonstrated:**\n- 🎨 **CDP-accurate element extraction** - Gets every CSS property perfectly\n- 🎬 **Advanced UI recreation** - Builds production-ready HTML/CSS\n- 📱 **Responsive enhancement** - Adds mobile optimization automatically\n- ✨ **Animation enhancement** - Improves the original with smooth transitions\n- 🚀 **One-command automation** - Complex task executed via simple chat\n\n**💡 This showcases the real power of Stealth Browser MCP - turning complex web cloning tasks into simple AI conversations.**\n\n---\n\n## 🧪 Real‑world examples\n\n- Market research: extract pricing/features from 5 competitors and output a comparison\n- UI/UX cloning: recreate a pricing section with exact fonts, styles, and interactions\n- Inventory monitoring: watch a product page and alert when in stock\n- Reverse engineering: intercept requests, map endpoints, and understand data flow\n\nYou can drive all of the above from a single AI agent chat.\n\n---\n\n## 🛣️ Roadmap\n\nSee the live plan in [ROADMAP.md](ROADMAP.md). Contributions welcome.\n\n---\n\n## Contributing\n\nWe love first‑time contributions. Read [CONTRIBUTING.md](CONTRIBUTING.md) and open a PR.\n\nIf this project saves you time, consider starring the repo and sharing it with a friend.\n\n---\n\n## 💼 Need Website or App Development? Try DevHive Studios\n\n**DevHive Studios** is a fair marketplace connecting businesses with skilled developers. Unlike other platforms, we put developers first while keeping costs affordable for clients.\n\n### 🏆 **Why DevHive?**\n- **For Developers**: Keep 60% of what clients pay (+ bonuses for on-time delivery)\n- **For Clients**: Quality websites/apps starting at just $50  \n- **For Everyone**: Transparent pricing, fast delivery, expert team\n\n### 🛠️ **Services Available**\nWeb development • Mobile apps • Bots \u0026 automation • E-commerce • UI/UX design • Security • Custom software • And more\n\n**Ready to start your project?** Hit up DevHive Studios today:\n- 🌐 [devhivestudios.com](https://devhivestudios.com)  \n- 💬 [Contact on Discord](https://discord.gg/mUcj5kwfrd)\n\n*DevHive Studios — Fair marketplace. Quality results.*\n\n---\n\n## ☕ Support This Project\n\nIf this browser automation MCP saved you time or made you money, consider supporting the development:\n\n- **☕ Buy me a coffee**: [buymeacoffee.com/vibheksoni](https://buymeacoffee.com/vibheksoni)\n\n*Every contribution helps maintain and improve this project! 🚀*\n\n\n---\n\n## 📄 License\n\nMIT — see [LICENSE](LICENSE).\n\n---\n\nIf you want your AI agent to access ANY website, star this repo. It helps more than you think.\n\n---\n\n## ⭐ Star History\n\n[![Star History Chart](https://api.star-history.com/svg?repos=vibheksoni/stealth-browser-mcp\u0026type=Date)](https://www.star-history.com/#vibheksoni/stealth-browser-mcp\u0026Date)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvibheksoni%2Fstealth-browser-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvibheksoni%2Fstealth-browser-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvibheksoni%2Fstealth-browser-mcp/lists"}