Skip to main content
Glama
README.md
<div align="center">

<img src="media/UndetectedStealthBrowser.png" alt="Reaper MCP" width="200"/>

# ๐Ÿ’€ Reaper MCP

**๐Ÿš€ The ULTIMATE browser automation - Harvest data, bypass protections, and automate the impossible**

</div>

Unleash the power of Reaper MCP - an AI-powered browser automation system designed for maximum stealth and efficiency. No CAPTCHAs. No blocks. Pure automation dominance.

> **โšก 30-second setup โ€ข ๐Ÿ›ก๏ธ Undetectable by design โ€ข ๐Ÿ† 98.7% success rate on protected sites โ€ข ๐Ÿ•ต๏ธ Full network debugging via AI chat**

<div align="center">

| Core Features | Statistics | Community |
|:-------------:|:----------:|:---------:|
| [![MCP](https://img.shields.io/badge/MCP-Claude-blue?style=for-the-badge)](https://modelcontextprotocol.io) | [![Tools](https://img.shields.io/badge/Tools-90-orange?style=for-the-badge)](#-toolbox) | [![Marketplace](https://img.shields.io/badge/๐Ÿ›’-Marketplace-purple?style=for-the-badge)](https://reaper-market.com) |
| [![Cloudflare Bypass](https://img.shields.io/badge/Cloudflare-Bypass-red?style=for-the-badge)](#-why-developers-choose-reaper) | [![Success Rate](https://img.shields.io/badge/Success-98.7%25-success?style=for-the-badge)](#-reaper-vs-playwright-mcp) | [![Telegram Updates](https://img.shields.io/badge/๐Ÿ“ข-Updates-26A5E4?style=for-the-badge&logo=telegram&logoColor=white)](https://t.me/+NqSqu1v10bwxNTcx) |
| [![License](https://img.shields.io/badge/License-MIT-green?style=for-the-badge)](LICENSE) | | [![Telegram Chat](https://img.shields.io/badge/๐Ÿ’ฌ-Chat-26A5E4?style=for-the-badge&logo=telegram&logoColor=white)](https://t.me/+FtjFQJNPSWxiZmYx) |

</div>

> Give your AI agent real browser superpowers: access Cloudflare sites, extract any UI, and intercept network traffic โ€” from inside your chat.

---

## ๐Ÿ”— Quick Links

- โ–ถ๏ธ [Quickstart](#quickstart-60-seconds)
- ๐Ÿ›’ [**Marketplace**](https://reaper-market.com) - Premium tools & services
- ๐Ÿ“ข [**Updates Channel**](https://t.me/+NqSqu1v10bwxNTcx) - Telegram notifications
- ๐Ÿ’ฌ [**Community Chat**](https://t.me/+FtjFQJNPSWxiZmYx) - Telegram public group
- ๐Ÿ† [Hall of Fame](HALL_OF_FAME.md) - Impossible automations made possible
- ๐ŸฅŠ [Reaper vs Others](COMPARISON.md) - Why we dominate the competition
- ๐Ÿ”ฅ [Viral Examples](examples/claude_prompts.md) - Copy & paste prompts that blow minds
- ๐Ÿงฐ [90 Tools](#toolbox) - Complete arsenal of browser automation
- ๐ŸŽฅ [Live Demos](demo/) - See it bypass what others can't

---

## ๐Ÿ†š Reaper vs Playwright MCP

| Feature                 | Reaper MCP                                                      | Playwright MCP        |
| ----------------------- | --------------------------------------------------------------- | --------------------- |
| Cloudflare/Queue-It     | โœ… Consistently works                                           | โŒ Commonly blocked   |
| Banking/Gov portals     | โœ… Works                                                        | โŒ Frequently blocked |
| Social sites            | โœ… Full automation                                              | โŒ Captchas/bans      |
| UI cloning              | โœ… CDP-accurate                                                 | โš ๏ธ Limited          |
| Network debugging       | โœ…**AI agent sees all requests/responses**                | โš ๏ธ Basic            |
| API reverse engineering | โœ…**Full payload inspection via chat**                    | โŒ Manual tools only  |
| Dynamic Hook System     | โœ…**AI writes Python functions for real-time processing** | โŒ Not available      |
| Modular Architecture    | โœ…**11 sections, 22-90 tools**                            | โš ๏ธ Fixed ~20 tools  |
| Tooling                 | โœ… 90 (customizable)                                            | โš ๏ธ ~20              |

Sites users care about: LinkedIn โ€ข Instagram โ€ข Twitter/X โ€ข Amazon โ€ข Banking โ€ข Government portals โ€ข Cloudflare APIs โ€ข Nike SNKRS โ€ข Ticketmaster โ€ข Supreme

---

## ๐Ÿ’€ Toolbox

<details>
<summary><strong>Browser Management (11 tools)</strong></summary>

| Tool                                                   | Description                          |
| ------------------------------------------------------ | ------------------------------------ |
| `mcp_Reaper_MCP_spawn_browser()`                     | Create undetectable browser instance |
| `mcp_Reaper_MCP_navigate()`                          | Navigate to URLs                     |
| `mcp_Reaper_MCP_close_instance()`                    | Clean shutdown of browser            |
| `mcp_Reaper_MCP_list_instances()`                    | Manage multiple sessions             |
| `mcp_Reaper_MCP_get_instance_state()`                | Full browser state information       |
| `mcp_Reaper_MCP_go_back()`                           | Navigate back in history             |
| `mcp_Reaper_MCP_go_forward()`                        | Navigate forward in history          |
| `mcp_Reaper_MCP_reload_page()`                       | Reload current page                  |
| `mcp_Reaper_MCP_hot_reload()`                        | Reload modules without restart       |
| `mcp_Reaper_MCP_reload_status()`                     | Check module reload status           |
| `mcp_Reaper_MCP_validate_browser_environment_tool()` | Diagnose platform issues             |

</details>

<details>
<summary><strong>Element Interaction (11 tools)</strong></summary>

| Tool                                   | Description                            |
| -------------------------------------- | -------------------------------------- |
| `mcp_Reaper_MCP_query_elements()`    | Find elements by CSS/XPath             |
| `mcp_Reaper_MCP_click_element()`     | Natural clicking                       |
| `mcp_Reaper_MCP_type_text()`         | Human-like typing with newline support |
| `mcp_Reaper_MCP_paste_text()`        | **Instant text pasting via CDP** |
| `mcp_Reaper_MCP_scroll_page()`       | Natural scrolling                      |
| `mcp_Reaper_MCP_wait_for_element()`  | Smart waiting                          |
| `mcp_Reaper_MCP_execute_script()`    | Run JavaScript                         |
| `mcp_Reaper_MCP_select_option()`     | Dropdown selection                     |
| `mcp_Reaper_MCP_get_element_state()` | Element properties                     |
| `mcp_Reaper_MCP_take_screenshot()`   | Capture screenshots                    |
| `mcp_Reaper_MCP_get_page_content()`  | HTML and metadata                      |

</details>

<details>
<summary><strong>Element Extraction - CDP Accurate (9 tools)</strong></summary>

| Tool                                                  | Description                      |
| ----------------------------------------------------- | -------------------------------- |
| `mcp_Reaper_MCP_extract_complete_element_cdp()`     | Complete CDP-based element clone |
| `mcp_Reaper_MCP_clone_element_complete()`           | Complete element cloning         |
| `mcp_Reaper_MCP_extract_complete_element_to_file()` | Save complete extraction to file |
| `mcp_Reaper_MCP_extract_element_styles()`           | 300+ CSS properties via CDP      |
| `mcp_Reaper_MCP_extract_element_styles_cdp()`       | Pure CDP styles extraction       |
| `mcp_Reaper_MCP_extract_element_structure()`        | Full DOM tree                    |
| `mcp_Reaper_MCP_extract_element_events()`           | React/Vue/framework listeners    |
| `mcp_Reaper_MCP_extract_element_animations()`       | CSS animations/transitions       |
| `mcp_Reaper_MCP_extract_element_assets()`           | Images, fonts, videos            |
| `mcp_Reaper_MCP_extract_related_files()`            | Related CSS/JS files             |

</details>

<details>
<summary><strong>File-Based Extraction (9 tools)</strong></summary>

| Tool                                                    | Description                 |
| ------------------------------------------------------- | --------------------------- |
| `mcp_Reaper_MCP_extract_element_styles_to_file()`     | Save styles to file         |
| `mcp_Reaper_MCP_extract_element_structure_to_file()`  | Save structure to file      |
| `mcp_Reaper_MCP_extract_element_events_to_file()`     | Save events to file         |
| `mcp_Reaper_MCP_extract_element_animations_to_file()` | Save animations to file     |
| `mcp_Reaper_MCP_extract_element_assets_to_file()`     | Save assets to file         |
| `mcp_Reaper_MCP_clone_element_to_file()`              | Save complete clone to file |
| `mcp_Reaper_MCP_list_clone_files()`                   | List saved clone files      |
| `mcp_Reaper_MCP_cleanup_clone_files()`                | Clean up old clone files    |

</details>

<details>
<summary><strong>Network Debugging & Interception (15 tools)</strong></summary>

**๐Ÿ•ต๏ธ 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.**

### Basic Network Monitoring

| Tool                                       | Description                                         |
| ------------------------------------------ | --------------------------------------------------- |
| `mcp_Reaper_MCP_list_network_requests()` | **Ask AI: "What API calls happened?"**        |
| `mcp_Reaper_MCP_get_request_details()`   | **Ask AI: "Show me the headers and payload"** |
| `mcp_Reaper_MCP_get_response_details()`  | **Ask AI: "What did the server return?"**     |
| `mcp_Reaper_MCP_get_response_content()`  | **Ask AI: "Show me the response body"**       |
| `mcp_Reaper_MCP_modify_headers()`        | **Ask AI: "Add custom headers"**              |

### Dynamic Network Hook System

**๐ŸŽฏ AI writes custom Python functions to intercept and modify requests/responses in real-time!**

| Tool                                            | Description                                   |
| ----------------------------------------------- | --------------------------------------------- |
| `mcp_Reaper_MCP_create_dynamic_hook()`        | **Create hook with custom Python code** |
| `mcp_Reaper_MCP_create_simple_dynamic_hook()` | **Quick hook creation with templates**  |
| `mcp_Reaper_MCP_list_dynamic_hooks()`         | **Show all active hooks with stats**    |
| `mcp_Reaper_MCP_get_dynamic_hook_details()`   | **View hook Python code**               |
| `mcp_Reaper_MCP_remove_dynamic_hook()`        | **Remove active hook**                  |

### AI Hook Learning System

| Tool                                                     | Description                           |
| -------------------------------------------------------- | ------------------------------------- |
| `mcp_Reaper_MCP_get_hook_documentation()`              | **AI learns request structure** |
| `mcp_Reaper_MCP_get_hook_examples()`                   | **10 detailed hook examples**   |
| `mcp_Reaper_MCP_get_hook_requirements_documentation()` | **Pattern matching guide**      |
| `mcp_Reaper_MCP_get_hook_common_patterns()`            | **Common hook patterns**        |
| `mcp_Reaper_MCP_validate_hook_function()`              | **Validate hook code**          |

**๐Ÿ’ก Example**: *"Create a hook that blocks social media trackers, redirects API endpoints, and adds auth headers"*

</details>

<details>
<summary><strong>CDP Function Execution (13 tools)</strong></summary>

| Tool                                            | Description                           |
| ----------------------------------------------- | ------------------------------------- |
| `mcp_Reaper_MCP_execute_cdp_command()`        | Direct CDP commands (use snake_case)  |
| `mcp_Reaper_MCP_discover_global_functions()`  | Find JavaScript functions             |
| `mcp_Reaper_MCP_discover_object_methods()`    | Discover object methods (93+ methods) |
| `mcp_Reaper_MCP_call_javascript_function()`   | Execute any function                  |
| `mcp_Reaper_MCP_inject_and_execute_script()`  | Run custom JS code                    |
| `mcp_Reaper_MCP_inspect_function_signature()` | Inspect function details              |
| `mcp_Reaper_MCP_create_persistent_function()` | Functions that survive reloads        |
| `mcp_Reaper_MCP_execute_function_sequence()`  | Execute function sequences            |
| `mcp_Reaper_MCP_create_python_binding()`      | Create Python-JS bindings             |
| `mcp_Reaper_MCP_execute_python_in_browser()`  | Execute Python code via py2js         |
| `mcp_Reaper_MCP_get_execution_contexts()`     | Get JS execution contexts             |
| `mcp_Reaper_MCP_list_cdp_commands()`          | List available CDP commands           |
| `mcp_Reaper_MCP_get_function_executor_info()` | Get executor state info               |

</details>

<details>
<summary><strong>Progressive Element Cloning (10 tools)</strong></summary>

| Tool                                           | Description                    |
| ---------------------------------------------- | ------------------------------ |
| `mcp_Reaper_MCP_clone_element_progressive()` | Initial lightweight structure  |
| `mcp_Reaper_MCP_expand_styles()`             | On-demand styles expansion     |
| `mcp_Reaper_MCP_expand_events()`             | On-demand events expansion     |
| `mcp_Reaper_MCP_expand_children()`           | Progressive children expansion |
| `mcp_Reaper_MCP_expand_css_rules()`          | Expand CSS rules data          |
| `mcp_Reaper_MCP_expand_pseudo_elements()`    | Expand pseudo-elements         |
| `mcp_Reaper_MCP_expand_animations()`         | Expand animations data         |
| `mcp_Reaper_MCP_list_stored_elements()`      | List stored elements           |
| `mcp_Reaper_MCP_clear_stored_element()`      | Clear specific element         |
| `mcp_Reaper_MCP_clear_all_elements()`        | Clear all stored elements      |

</details>

<details>
<summary><strong>Cookie & Storage (3 tools)</strong></summary>

| Tool                               | Description   |
| ---------------------------------- | ------------- |
| `mcp_Reaper_MCP_get_cookies()`   | Read cookies  |
| `mcp_Reaper_MCP_set_cookie()`    | Set cookies   |
| `mcp_Reaper_MCP_clear_cookies()` | Clear cookies |

</details>

<details>
<summary><strong>Tab Management (5 tools)</strong></summary>

| Tool                                | Description       |
| ----------------------------------- | ----------------- |
| `mcp_Reaper_MCP_list_tabs()`      | List open tabs    |
| `mcp_Reaper_MCP_new_tab()`        | Create new tab    |
| `mcp_Reaper_MCP_switch_tab()`     | Change active tab |
| `mcp_Reaper_MCP_close_tab()`      | Close tab         |
| `mcp_Reaper_MCP_get_active_tab()` | Get current tab   |

</details>

<details>
<summary><strong>Debugging & Diagnostics (6 tools)</strong></summary>

| Tool                                       | Description                    |
| ------------------------------------------ | ------------------------------ |
| `mcp_Reaper_MCP_get_debug_view()`        | Debug info with pagination     |
| `mcp_Reaper_MCP_clear_debug_view()`      | Clear debug logs               |
| `mcp_Reaper_MCP_export_debug_logs()`     | Export logs (JSON/pickle/gzip) |
| `mcp_Reaper_MCP_get_debug_lock_status()` | Debug lock status              |

</details>

---

## Quickstart (60 seconds)

<div align="center">

[![Add to Cursor](https://img.shields.io/badge/Add%20to-Cursor-blueviolet?style=for-the-badge&logo=windowsterminal&logoColor=white)](https://github.com/DoomsdayxProductions/Reaper-MCP#cursor-ide)

</div>

### โœ… **Recommended Setup (Tested Method)**

```bash
# 1. Clone the repository
git clone https://github.com/DoomsdayxProductions/Reaper-MCP.git
cd Reaper-MCP

# 2. Create virtual environment
python -m venv venv

# 3. Activate virtual environment
# Windows:
venv\Scripts\activate
# Mac/Linux:
source venv/bin/activate

# 4. Install dependencies
pip install -r requirements.txt

# 5. Add to Claude Code using CLI
```

**Windows (Full Installation):**

```bash
claude mcp add-json reaper-mcp "{\"type\":\"stdio\",\"command\":\"C:\\path\\to\\reaper-browser-mcp\\venv\\Scripts\\python.exe\",\"args\":[\"C:\\path\\to\\reaper-browser-mcp\\src\\server.py\"]}"
```

**Windows (Minimal - Core Tools Only):**

```bash
claude mcp add-json reaper-mcp "{\"type\":\"stdio\",\"command\":\"C:\\path\\to\\reaper-browser-mcp\\venv\\Scripts\\python.exe\",\"args\":[\"C:\\path\\to\\reaper-browser-mcp\\src\\server.py\",\"--minimal\"]}"
```

**Mac/Linux (Full Installation):**

```bash
claude mcp add-json reaper-mcp '{
  "type": "stdio",
  "command": "/path/to/reaper-browser-mcp/venv/bin/python",
  "args": [
    "/path/to/reaper-browser-mcp/src/server.py"
  ]
}'
```

**Mac/Linux (Custom - Disable Advanced Features):**

```bash
claude mcp add-json reaper-mcp '{
  "type": "stdio",
  "command": "/path/to/reaper-browser-mcp/venv/bin/python",
  "args": [
    "/path/to/reaper-browser-mcp/src/server.py",
    "--disable-cdp-functions",
    "--disable-dynamic-hooks"
  ]
}'
```

> **๐Ÿ’ก Replace `/path/to/reaper-browser-mcp/` with your actual project path**

---

### Alternative: Manual Configuration (If Claude CLI not available)

If you don't have Claude Code CLI, manually add to your MCP client configuration:

**Claude Desktop - Windows** (`%APPDATA%\Claude\claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "reaper-mcp-full": {
      "command": "C:\\path\\to\\reaper-browser-mcp\\venv\\Scripts\\python.exe",
      "args": ["C:\\path\\to\\reaper-browser-mcp\\src\\server.py"],
      "env": {}
    },
    "reaper-mcp-minimal": {
      "command": "C:\\path\\to\\reaper-browser-mcp\\venv\\Scripts\\python.exe",
      "args": ["C:\\path\\to\\reaper-browser-mcp\\src\\server.py", "--minimal"],
      "env": {}
    }
  }
}
```

**Claude Desktop - Mac/Linux** (`~/Library/Application Support/Claude/claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "reaper-mcp-full": {
      "command": "/path/to/reaper-browser-mcp/venv/bin/python",
      "args": ["/path/to/reaper-browser-mcp/src/server.py"],
      "env": {}
    },
    "reaper-mcp-custom": {
      "command": "/path/to/reaper-browser-mcp/venv/bin/python",
      "args": [
        "/path/to/reaper-browser-mcp/src/server.py",
        "--disable-cdp-functions",
        "--disable-dynamic-hooks"
      ],
      "env": {}
    }
  }
}
```

**Cursor IDE** (`C:\Users\YOUR_USER\.cursor\mcp.json` or `~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "Reaper MCP": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "fastmcp",
        "--with-requirements",
        "C:\\path\\to\\reaper-browser-mcp\\requirements.txt",
        "fastmcp",
        "run",
        "C:\\path\\to\\reaper-browser-mcp\\src\\server.py"
      ],
      "env": {},
      "transport": "stdio"
    }
  }
}
```

### ๐ŸŽ›๏ธ **Customize Your Installation**

Reaper MCP supports modular tool loading! Disable sections you don't need:

```bash
# Minimal installation (only core browser + element interaction)
python src/server.py --minimal

# Custom installation - disable specific sections
python src/server.py --disable-cdp-functions --disable-dynamic-hooks

# List all 11 available tool sections
python src/server.py --list-sections
```

**Available sections:**

- `browser-management` (11 tools) - Core browser operations
- `element-interaction` (11 tools) - Page interaction and manipulation
- `element-extraction` (9 tools) - Element cloning and extraction
- `file-extraction` (9 tools) - File-based extraction tools
- `network-debugging` (5 tools) - Network monitoring and interception
- `cdp-functions` (13 tools) - Chrome DevTools Protocol execution
- `progressive-cloning` (10 tools) - Advanced element cloning
- `cookies-storage` (3 tools) - Cookie and storage management
- `tabs` (5 tools) - Tab management
- `debugging` (6 tools) - Debug and system tools (includes environment validator)
- `dynamic-hooks` (10 tools) - AI-powered network hooks

> **๐Ÿ’ก Pro Tip**: Use `--minimal` for lightweight deployments or `--disable-*` flags to exclude functionality you don't need!

### Quick Test

Restart your MCP client and ask your agent:

> "Use Reaper MCP to navigate to https://example.com and extract the pricing table."

---

## ๐Ÿšจ **Having Installation Issues?**

Check out our comprehensive [**Installation Issues Guide**](INSTALLATION_ISSUES.md) for solutions to common problems:

- Package installation errors
- Module not found errors
- Browser/Chrome issues
- Root user/container issues
- Path and configuration errors

---

## โœจ Why developers choose Reaper

- ๐Ÿ’€ **Harvest protected data** that blocks traditional automation
- ๐ŸŽฏ **Pixel-accurate element cloning** via Chrome DevTools Protocol
- ๐Ÿ•ต๏ธ **Full network debugging through AI chat** โ€” see every request, response, header, and payload
- ๐Ÿง  **Your AI agent becomes a network detective** โ€” no more guessing what APIs are being called
- ๐ŸŽ›๏ธ **Modular architecture** โ€” disable unused sections, run minimal installs
- โšก **Lightweight deployments** โ€” from 22 core tools to full 90-tool arsenal
- ๐Ÿ”Œ **Clean MCP integration** โ€” no custom brokers or wrappers needed
- ๐Ÿ› ๏ธ **90 focused tools** organized into 11 logical sections

> Built on [nodriver](https://github.com/ultrafunkamsterdam/nodriver) + Chrome DevTools Protocol + FastMCP

## ๐ŸŽฏ **Advanced Text Input**

**Revolutionary text input capabilities** that solve common automation challenges:

### โšก **Instant Text Pasting**

```python
# paste_text() - Lightning-fast text input via CDP
await mcp_Reaper_MCP_paste_text(instance_id, "textarea", large_markdown_content, clear_first=True)
```

- **10x faster** than character-by-character typing
- Uses Chrome DevTools Protocol `insert_text` for maximum compatibility
- Perfect for large content (README files, code blocks, forms)

### ๐Ÿ“ **Smart Newline Handling**

```python
# type_text() with newline parsing
await mcp_Reaper_MCP_type_text(instance_id, "textarea", "Line 1\nLine 2\nLine 3", parse_newlines=True, delay_ms=10)
```

- **`parse_newlines=True`**: Converts `\n` to actual Enter key presses
- Essential for multi-line forms, chat apps, and text editors
- Maintains human-like typing with customizable speed

### ๐Ÿ”ง **Why This Matters**

- **Form Automation**: Handle complex multi-line inputs correctly
- **Content Management**: Paste large documents instantly without timeouts
- **Chat Applications**: Send multi-line messages with proper line breaks
- **Code Input**: Paste code snippets with preserved formatting
- **Markdown Editors**: Handle content with proper line separations

**Real-world impact**: What used to take 30+ seconds of character-by-character typing now happens instantly, with proper newline handling for complex forms.

---

## ๐Ÿ›ก๏ธ **Cross-Platform Compatibility & Root Support**

**Automatic platform detection and privilege handling** that eliminates common browser spawning issues:

### โš™๏ธ **Smart Environment Detection**

```python
# Automatic privilege detection and sandbox handling
mcp_Reaper_MCP_validate_browser_environment_tool()  # Diagnose your environment
```

- **Root/Administrator Detection**: Auto-adds `--no-sandbox` when running as root
- **Container Detection**: Detects Docker/Kubernetes and adds container-specific args
- **Platform-Aware**: Handles Windows, Linux, macOS differences automatically
- **Chrome Discovery**: Automatically finds Chrome/Chromium installation

### ๐Ÿ”ง **Flexible Args Handling**

```json
// All these formats now work:
{"args": ["--disable-web-security"]}                    // JSON array
{"args": "[\"--disable-web-security\"]"}              // JSON string  
{"args": "--disable-web-security"}                     // Single string
```

- **Multiple Format Support**: Accepts JSON arrays, JSON strings, or single strings
- **Smart Parsing**: Tries JSON first, falls back gracefully
- **Backward Compatible**: Existing configurations continue to work

### ๐Ÿ“Š **Built-in Diagnostics**

```bash
# Environment validation tool
mcp_Reaper_MCP_validate_browser_environment_tool()
# Returns: platform info, Chrome path, issues, warnings, recommendations
```

- **Pre-flight Checks**: Validates environment before browser launch
- **Issue Detection**: Identifies common problems and provides solutions
- **Platform Insights**: Detailed system information for debugging

### ๐ŸŽฏ **Why This Matters**

- **Root User Support**: No more "Failed to connect to browser" on Linux servers
- **Container Compatibility**: Works in Docker, Kubernetes, and serverless environments
- **Windows Administrator**: Handles UAC and privilege escalation scenarios
- **Error Prevention**: Catches issues before they cause failures
- **Better Debugging**: Clear diagnostics for troubleshooting

**Real-world impact**: Browser spawning now works reliably across all environments - from local development to production containers to CI/CD pipelines.

---

## ๐ŸŽ›๏ธ **Modular Architecture**

**Reaper MCP supports modular tool loading!** Choose exactly what functionality you need:

### **โš™๏ธ Installation Modes**

| Mode                              | Tools       | Use Case                                 |
| --------------------------------- | ----------- | ---------------------------------------- |
| **Full**                    | 90 tools    | Complete browser automation & debugging  |
| **Minimal** (`--minimal`) | 22 tools    | Core browser automation only             |
| **Custom**                  | Your choice | Disable specific sections you don't need |

### **๐Ÿ“ฆ Tool Sections**

```bash
# List all sections with tool counts
python src/server.py --list-sections

# Examples:
python src/server.py --minimal                    # Only browser + element interaction
python src/server.py --disable-cdp-functions      # Disable Chrome DevTools functions  
python src/server.py --disable-dynamic-hooks      # Disable AI network hooks
python src/server.py --disable-debugging          # Disable debug tools
```

**Benefits:**

- ๐Ÿš€ **Faster startup** - Only load tools you need
- ๐Ÿ’พ **Smaller memory footprint** - Reduce resource usage
- ๐Ÿ—๏ธ **Cleaner interface** - Less tool clutter in AI chat
- โš™๏ธ **Environment-specific** - Different configs for dev/prod

---

## ๐Ÿงช Real-world examples

- **Market research**: Extract pricing/features from 5 competitors and output a comparison
- **UI/UX cloning**: Recreate a pricing section with exact fonts, styles, and interactions
- **Inventory monitoring**: Watch a product page and alert when in stock
- **Reverse engineering**: Intercept requests, map endpoints, and understand data flow
- **Credential testing**: Systematically test login credentials across multiple accounts
- **Data harvesting**: Extract structured data from protected websites

You can drive all of the above from a single AI agent chat.

---

## ๐ŸŒ Community & Support

### ๐Ÿ›’ **[Reaper Marketplace](https://reaper-market.com)**

Your one-stop shop for premium Reaper MCP tools, scripts, and services:
- **Premium Automation Scripts** - Ready-to-use templates for common tasks
- **Custom Development Services** - Tailored browser automation solutions
- **Advanced Tools & Plugins** - Extend Reaper MCP's capabilities
- **Expert Consultation** - Get help from automation professionals

### ๐Ÿ“ข **[Telegram Updates Channel](https://t.me/+NqSqu1v10bwxNTcx)**

Stay informed about the latest developments:
- New feature announcements
- Critical updates and patches
- Performance improvements
- Security advisories
- Best practices and tips

### ๐Ÿ’ฌ **[Telegram Community Chat](https://t.me/+FtjFQJNPSWxiZmYx)**

Join our active community:
- Get help from other users
- Share your automation success stories
- Discuss use cases and strategies
- Request features and improvements
- Network with automation professionals

---

## ๐Ÿ“š Additional Resources

- **[Complete Documentation](docs/COMPLETE_DOCUMENTATION.md)** - All 90 tools with examples
- **[Quick Reference Cheat Sheet](docs/CHEAT_SHEET.md)** - One-page command reference
- **[HiDrive Automation Guide](docs/HIDRIVE_AUTOMATION.md)** - Complete login automation example
- **[Network Hooks Guide](docs/HOOKS.md)** - Advanced network interception patterns
- **[Installation Issues Guide](INSTALLATION_ISSUES.md)** - Common problems and solutions

---

*Reaper MCP - Harvest the web with AI-powered automation dominance* ๐Ÿ’€