brave-real-browser-mcp-server 2.9.5 → 2.9.7

package/README.md

@@ -61,6 +61,20 @@ If you're just using this MCP server (not developing it), you don't need to run
 }
 ```
 
+```json
+{
+  "mcpServers": {
+    "brave-real-browser": {
+      "command": "npx",
+      "args": ["brave-real-browser-mcp-server@latest"],
+      "env": {
+        "BRAVE_PATH": "C:\\Program Files\\BraveSoftware\\Brave-Browser\\Application\\brave.exe"
+      }
+    }
+  }
+}
+```
+
 **For Mac:**
 1. Open Finder and press `Cmd+Shift+G`
 2. Go to: `~/Library/Application Support/Claude/`
@@ -113,16 +127,23 @@ assistants to control a real browser, extract content, and more.
 ## Features
 
 - **🔄 Auto-Update System**: Automatically updates all dependencies to latest versions on every `npm install`
-- **🦁 Brave Browser Priority**: Automatically detects and uses Brave Browser first, Chrome as fallback
-- **Stealth by default**: All browser instances use anti-detection features
-- **Enhanced cross-platform support**: Comprehensive browser detection (Brave + Chrome) on Windows/Mac/Linux
-- **Smart browser detection**: Registry-based + file system detection for both Brave and Chrome
+- **🦁 Brave Browser Exclusive**: Specially designed for Brave Browser with exclusive optimizations
+  - Advanced Brave path detection (Registry + File System + Environment Variables)
+  - Brave-specific launch arguments and configurations
+  - Full compatibility with Brave Browser's privacy features
+  - Automatic detection across all Brave versions (Stable, Beta, Dev, Nightly)
+- **Stealth by default**: All browser instances use anti-detection features powered by `brave-real-browser`
+- **Enhanced cross-platform support**: Comprehensive Brave browser detection on Windows/Mac/Linux
+  - **Windows**: Registry-based detection + 15+ installation paths
+  - **macOS**: Application bundle detection for all Brave variants
+  - **Linux**: Package manager and manual installation detection
+- **Smart browser detection**: Multi-layer detection system with automatic fallbacks
 - **Connection resilience**: Automatic localhost/127.0.0.1 fallback with port management
 - **Multiple retry strategies**: 5 different connection approaches with progressive fallback
 - **Advanced configuration**: Full support for all brave-real-browser options
 - **Dynamic selector discovery**: Intelligent element finding without hardcoded selectors
 - **Random scrolling**: Tools for natural scrolling to avoid detection
-- **Comprehensive toolset**: 11 tools covering all browser automation needs
+- **Comprehensive toolset**: 62+ professional tools covering all browser automation needs
 - **Proxy support**: Built-in proxy configuration for enhanced privacy
 - **Captcha handling**: Support for solving reCAPTCHA, hCaptcha, and Turnstile
 - **Robust error handling**: Advanced error recovery with circuit breaker pattern
@@ -134,54 +155,56 @@ assistants to control a real browser, extract content, and more.
 
 - Node.js >= 18.0.0
 - npm or yarn
-- **Brave Browser (RECOMMENDED)** or Google Chrome/Chromium browser installed
+- **Brave Browser (REQUIRED)** - This project exclusively uses Brave Browser
 - Basic understanding of TypeScript/JavaScript (for development)
 
 ### Browser Requirements
 
-#### 🦁 Brave Browser (Recommended)
+#### 🦁 Brave Browser (Required)
 
-This project **automatically detects and prioritizes Brave Browser** as it's specifically designed for the brave-real-browser package. Brave is detected first, then Chrome as fallback.
+This project **exclusively uses Brave Browser** and is specifically optimized for the `brave-real-browser` package with advanced integration features.
 
-**Why Brave?**
-- 🎯 Perfect compatibility with brave-real-browser
-- 🔒 Better privacy and security by default
-- 🚀 Faster performance
-- ✅ Automatic detection after installation
+**Why Brave Browser Exclusively?**
+- **🎯 Perfect Compatibility**: Designed specifically for `brave-real-browser` package
+- **🔒 Enhanced Privacy**: Built-in ad-blocking and tracking protection
+- **🚀 Superior Performance**: Faster page loads and reduced memory usage
+- **🛡️ Anti-Detection**: Better stealth capabilities compared to regular browsers
+- **✅ Advanced Auto-Detection**: Multi-layer detection system across all platforms
+- **🎯 Reliability**: Simplified codebase focused on single browser for better stability
+- **🦁 Native Integration**: Custom launch arguments and configurations optimized for Brave
 
 **Install Brave:**
 - **All Platforms**: Download from [brave.com/download](https://brave.com/download/)
 - Brave is automatically detected in all standard installation locations
 - Use `BRAVE_PATH` environment variable for custom installations
 
-#### 🌐 Chrome/Chromium (Fallback)
-
-Chrome/Chromium works as a fallback if Brave is not installed.
-
-**Windows:**
-- Automatic detection includes (in order of priority):
-  1. **Brave Browser** paths (Registry + standard locations)
-  2. Chrome paths (Registry + 15+ standard locations)
-  - Standard: `C:\Program Files\Google\Chrome\Application\chrome.exe`
-  - 32-bit: `C:\Program Files (x86)\Google\Chrome\Application\chrome.exe`
-  - User: `%LOCALAPPDATA%\Google\Chrome\Application\chrome.exe`
-  - Chrome Canary, Portable installations
-- Manual path: Use `BRAVE_PATH` or `CHROME_PATH` environment variable
+**Windows (Advanced Detection):**
+- **Registry-Based Detection**: Queries Windows Registry for all Brave installations
+- **File System Scanning**: Searches 15+ common installation paths
+- **Standard Paths Detected**:
+  - System-wide: `C:\Program Files\BraveSoftware\Brave-Browser\Application\brave.exe`
+  - 32-bit: `C:\Program Files (x86)\BraveSoftware\Brave-Browser\Application\brave.exe`
+  - User-specific: `%LOCALAPPDATA%\BraveSoftware\Brave-Browser\Application\brave.exe`
+  - Portable installations in common directories
+- **All Brave Variants Supported**:
+  - Brave Browser (Stable)
+  - Brave Browser Beta
+  - Brave Browser Dev
+  - Brave Browser Nightly
+- **Environment Variable Support**: `BRAVE_PATH` for custom locations
+- **Automatic Fallback**: Progressive detection with multiple strategies
 
 **macOS:**
-- **Brave Browser** (priority):
+- **Brave Browser** paths:
   - `/Applications/Brave Browser.app/Contents/MacOS/Brave Browser`
-  - Beta/Nightly/Dev versions also detected
-- Chrome/Chromium (fallback):
-  - `/Applications/Google Chrome.app/Contents/MacOS/Google Chrome`
-  - Chromium and Chrome Canary also supported
+  - `/Applications/Brave Browser Beta.app/Contents/MacOS/Brave Browser Beta`
+  - `/Applications/Brave Browser Nightly.app/Contents/MacOS/Brave Browser Nightly`
+  - `/Applications/Brave Browser Dev.app/Contents/MacOS/Brave Browser Dev`
 
 **Linux:**
-- **Brave Browser** (priority):
+- **Brave Browser** installation:
   - Install: `sudo apt install brave-browser` or from [brave.com](https://brave.com/)
-  - Detected paths: `/usr/bin/brave-browser`, `/snap/bin/brave`, etc.
-- Chrome/Chromium (fallback):
-  - Install: `sudo apt-get install -y google-chrome-stable` or `chromium-browser`
+  - Detected paths: `/usr/bin/brave-browser`, `/snap/bin/brave`, `/usr/bin/brave`, `/opt/brave.com/brave/brave-browser`
 - Install xvfb for headless operation: `sudo apt-get install -y xvfb`
 
 ## Installation for Developers
@@ -261,11 +284,11 @@ This command:
 
 #### Method 2: Add with Environment Variables
 
-If you need to configure proxy settings or custom Chrome paths:
+If you need to configure proxy settings or custom Brave paths:
 
 ```bash
 claude mcp add brave-real-browser \
-  -e CHROME_PATH="/path/to/chrome" \
+  -e BRAVE_PATH="/path/to/brave" \
   -e PROXY_URL="http://proxy:8080" \
   -- npx brave-real-browser-mcp-server@latest
 ```
@@ -292,7 +315,7 @@ claude mcp add-json brave-real-browser '{
   "command": "npx",
   "args": ["brave-real-browser-mcp-server@latest"],
   "env": {
-    "CHROME_PATH": "/path/to/chrome",
+    "BRAVE_PATH": "/path/to/brave",
     "PROXY_URL": "http://proxy:8080"
   }
 }'
@@ -329,7 +352,7 @@ After adding the server:
 
 - **Automatic Updates**: Using `@latest` ensures you get bug fixes and improvements
 - **No Installation**: npx handles downloading and running automatically  
-- **Environment Variables**: Easy configuration of proxies, Chrome paths, etc.
+- **Environment Variables**: Easy configuration of proxies, Brave paths, etc.
 - **Scope Control**: Choose where the server is available (local/project/user)
 - **Team Sharing**: Project scope allows sharing configurations with teammates
 - **Status Monitoring**: Built-in `/mcp` command for server health checks
@@ -367,7 +390,7 @@ Cursor IDE uses the same npx approach - no installation needed! Here are the set
 
 > **Important:** Just like Claude Desktop, Cursor will use `npx` to automatically download and run the server. You don't need to install anything with npm!
 
-**Windows-Specific Configuration (if experiencing Chrome path issues):**
+**Windows-Specific Configuration (if experiencing Brave path issues):**
 ```json
 {
   "mcpServers": {
@@ -375,7 +398,7 @@ Cursor IDE uses the same npx approach - no installation needed! Here are the set
       "command": "npx",
       "args": ["brave-real-browser-mcp-server@latest"],
       "env": {
-        "CHROME_PATH": "C:/Program Files/Google/Chrome/Application/chrome.exe"
+        "BRAVE_PATH": "C:/Program Files/BraveSoftware/Brave-Browser/Application/brave.exe"
       }
     }
   }
@@ -384,7 +407,7 @@ Cursor IDE uses the same npx approach - no installation needed! Here are the set
 
 > **Note**: Browser options like headless mode should be configured when initializing the browser through the `browser_init` tool, not via environment variables.
 
-**Advanced Configuration with Custom Chrome Path:**
+**Advanced Configuration with Custom Brave Path:**
 ```json
 {
   "mcpServers": {
@@ -392,7 +415,7 @@ Cursor IDE uses the same npx approach - no installation needed! Here are the set
       "command": "npx",
       "args": ["brave-real-browser-mcp-server@latest"],
       "env": {
-        "CHROME_PATH": "C:/Program Files/Google/Chrome/Application/chrome.exe"
+        "BRAVE_PATH": "C:/Program Files/BraveSoftware/Brave-Browser/Application/brave.exe"
       }
     }
   }
@@ -401,34 +424,34 @@ Cursor IDE uses the same npx approach - no installation needed! Here are the set
 
 > **Note**: Proxy settings and browser options should be configured when asking Claude to initialize the browser using the `browser_init` tool.
 
-#### Platform-Specific Chrome Paths for Cursor IDE
+#### Platform-Specific Brave Paths for Cursor IDE
 
-If Chrome auto-detection fails, you can specify the Chrome path using the `CHROME_PATH` environment variable:
+If Brave auto-detection fails, you can specify the Brave path using the `BRAVE_PATH` environment variable:
 
 **Windows:**
 ```json
 "env": {
-  "CHROME_PATH": "C:/Program Files/Google/Chrome/Application/chrome.exe"
+  "BRAVE_PATH": "C:/Program Files/BraveSoftware/Brave-Browser/Application/brave.exe"
 }
 ```
 Alternative Windows paths:
-- `"C:/Program Files (x86)/Google/Chrome/Application/chrome.exe"`
-- `"%LOCALAPPDATA%/Google/Chrome/Application/chrome.exe"`
+- `"C:/Program Files (x86)/BraveSoftware/Brave-Browser/Application/brave.exe"`
+- `"%LOCALAPPDATA%/BraveSoftware/Brave-Browser/Application/brave.exe"`
 
 **macOS:**
 ```json
 "env": {
-  "CHROME_PATH": "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome"
+  "BRAVE_PATH": "/Applications/Brave Browser.app/Contents/MacOS/Brave Browser"
 }
 ```
 
 **Linux:**
 ```json
 "env": {
-  "CHROME_PATH": "/usr/bin/google-chrome"
+  "BRAVE_PATH": "/usr/bin/brave-browser"
 }
 ```
-Alternative Linux paths: `/usr/bin/chromium-browser`, `/snap/bin/chromium`
+Alternative Linux paths: `/snap/bin/brave`, `/usr/bin/brave`, `/opt/brave.com/brave/brave-browser`
 
 
 #### Testing Cursor IDE Setup
@@ -453,9 +476,9 @@ If successful, you should see:
    - Ensure Node.js 18+ is installed
 
 2. **"Browser failed to launch" on Windows**
-   - Add explicit Chrome path in `executablePath`
+   - Add explicit Brave path in `BRAVE_PATH` environment variable
    - Try running Cursor IDE as Administrator
-   - Check Windows Defender isn't blocking Chrome
+   - Check Windows Defender isn't blocking Brave Browser
 
 3. **"Permission denied"**
    - Use `sudo npm install -g brave-real-browser-mcp-server` on Linux/Mac
@@ -528,48 +551,106 @@ AI: I'll set up the browser with your proxy configuration.
 
 ## Available Tools
 
-### Core Browser Tools
-
-| Tool Name | Description | Required Parameters | Optional Parameters |
-|-----------|-------------|---------------------|-------------------|
-| `browser_init` | Initialize stealth browser with advanced options | None | `headless`, `disableXvfb`, `ignoreAllFlags`, `proxy`, `plugins`, `connectOption` |
-| `navigate` | Navigate to a URL | `url` | `waitUntil` |
-| `get_content` | Get page content (HTML or text) | None | `type`, `selector` |
-| `browser_close` | Close the browser instance | None | None |
-
-### Interaction Tools
-
-| Tool Name | Description | Required Parameters | Optional Parameters |
-|-----------|-------------|---------------------|-------------------|
-| `click` | Standard click on element | `selector` | `waitForNavigation` |
-| `type` | Type text into input field | `selector`, `text` | `delay` |
-| `wait` | Wait for various conditions | `type`, `value` | `timeout` |
-| `find_selector` | Find CSS selector for element containing specific text | `text` | `elementType`, `exact` |
-
-
-### Behavior Tools
-
-| Tool Name | Description | Required Parameters | Optional Parameters |
-|-----------|-------------|---------------------|-------------------|
-| `random_scroll` | Perform random scrolling with natural timing | None | None |
-
-### Element Discovery Tools
-
-| Tool Name | Description | Required Parameters | Optional Parameters |
-|-----------|-------------|---------------------|-------------------|
-| `find_selector` | Find CSS selector for element containing specific text | `text` | `elementType`, `exact` |
-
-### Content Tools
-
-| Tool Name | Description | Required Parameters | Optional Parameters |
-|-----------|-------------|---------------------|-------------------|
-| `save_content_as_markdown` | Extract page content and save it as a formatted markdown file | `filePath` | `contentType`, `selector`, `formatOptions` |
-
-### Anti-Detection Tools
-
-| Tool Name | Description | Required Parameters | Optional Parameters |
-|-----------|-------------|---------------------|-------------------|
-| `solve_captcha` | Attempt to solve captchas | `type` | None |
+### 🎯 **Complete Professional Toolset - 62 Tools**
+
+This MCP server provides **62 professional-grade tools** organized into 11 major categories:
+
+### 🔥 **Core Browser Management (11 Tools)**
+1. `browser_init` - Initialize stealth browser with advanced options
+2. `navigate` - Navigate to a URL
+3. `get_content` - Get page content (HTML or text) 
+4. `click` - Click on elements
+5. `type` - Type text into input fields
+6. `wait` - Wait for various conditions
+7. `browser_close` - Close browser instance
+8. `solve_captcha` - Solve captchas (reCAPTCHA, hCaptcha, Turnstile)
+9. `random_scroll` - Natural scrolling behavior
+10. `find_selector` - Find CSS selectors by text content
+11. `save_content_as_markdown` - Save page content as markdown
+
+### 📊 **Smart Data Extractors (5 Tools)**
+12. `scrape_table` - Extract structured data from HTML tables
+13. `extract_list` - Extract data from bullet and numbered lists
+14. `extract_json` - Extract embedded JSON/API data
+15. `scrape_meta_tags` - Extract SEO meta tags and Open Graph data
+16. `extract_schema` - Extract Schema.org structured data
+
+### 🔄 **Multi-Element Extractors (7 Tools)**
+17. `batch_element_scraper` - Scrape multiple similar elements in batch
+18. `nested_data_extraction` - Extract data maintaining parent-child relationships
+19. `attribute_harvester` - Collect element attributes (href, src, data-*)
+20. `image_scraper` - Extract image URLs, alt text, dimensions
+21. `link_harvester` - Collect internal/external links with classification
+22. `media_extractor` - Extract video, audio, iframe URLs and metadata
+23. `pdf_link_finder` - Find downloadable files (PDF, DOC, etc.)
+
+### 📄 **Pagination Tools (5 Tools)**
+24. `auto_pagination` - Automatically detect and navigate through pages
+25. `infinite_scroll` - Handle lazy-loading pages with auto-scroll
+26. `multi_page_scraper` - Collect data from multiple pages
+27. `sitemap_parser` - Extract URLs from sitemap.xml
+28. `breadcrumb_navigator` - Navigate site structure using breadcrumbs
+
+### 🧹 **Data Processing Tools (8 Tools)**
+29. `smart_text_cleaner` - Clean and normalize text data
+30. `html_to_text` - Convert HTML to clean text
+31. `price_parser` - Extract numbers from currency strings
+32. `date_normalizer` - Convert various date formats to standard format
+33. `contact_extractor` - Detect phone numbers and email addresses
+34. `schema_validator` - Validate data against JSON schema
+35. `required_fields_checker` - Check for missing required fields
+36. `duplicate_remover` - Remove duplicate items from arrays
+
+### 🤖 **AI-Powered Features (5 Tools)**
+37. `smart_selector_generator` - AI-based CSS selector generation
+38. `content_classification` - Classify webpage content into categories
+39. `sentiment_analysis` - Analyze sentiment of page content
+40. `summary_generator` - Generate page content summaries using TF-IDF
+41. `translation_support` - Detect language and provide translation info
+
+### 🔍 **Search & Filter Tools (5 Tools)**
+42. `keyword_search` - Advanced keyword search with context
+43. `regex_pattern_matcher` - Search using regular expressions
+44. `xpath_support` - Query elements using XPath expressions
+45. `advanced_css_selectors` - Support for complex CSS selectors
+46. `visual_element_finder` - Find elements by visual properties
+
+### 🔧 **Data Quality & Validation (5 Tools)**
+47. `data_deduplication` - Advanced duplicate removal with fuzzy matching
+48. `missing_data_handler` - Detect and handle missing data
+49. `data_type_validator` - Validate data types against JSON schema
+50. `outlier_detection` - Detect outliers in numerical data
+51. `consistency_checker` - Check data consistency across fields
+
+### 🛡️ **Advanced Captcha Handling (3 Tools)**
+52. `ocr_engine` - Extract text from images using OCR
+53. `audio_captcha_solver` - Handle audio captchas
+54. `puzzle_captcha_handler` - Handle slider and puzzle captchas
+
+### 📸 **Screenshot & Visual Tools (5 Tools)**
+55. `full_page_screenshot` - Capture complete page screenshots
+56. `element_screenshot` - Capture screenshots of specific elements
+57. `pdf_generation` - Convert pages to PDF
+58. `video_recording` - Record browser sessions
+59. `visual_comparison` - Compare two screenshots for differences
+
+### 🌐 **Website API Integration (3 Tools)**
+60. `rest_api_endpoint_finder` - Discover REST API endpoints
+61. `webhook_support` - Set up and test webhooks
+62. `all_website_api_finder` - Comprehensive API discovery
+
+---
+
+### 📝 **Usage Examples**
+
+| Category | Example Usage |
+|----------|---------------|
+| **Basic Browsing** | `browser_init` → `navigate` → `get_content` |
+| **Data Extraction** | `scrape_table` → `smart_text_cleaner` → `duplicate_remover` |
+| **Form Automation** | `find_selector` → `type` → `click` → `wait` |
+| **Content Analysis** | `get_content` → `sentiment_analysis` → `summary_generator` |
+| **Visual Capture** | `full_page_screenshot` → `element_screenshot` |
+| **Quality Control** | `data_type_validator` → `consistency_checker` |
 
 ## Advanced Features
 
@@ -578,7 +659,7 @@ AI: I'll set up the browser with your proxy configuration.
 The server includes intelligent element discovery capabilities through the `find_selector` tool:
 
 - **Text-based element finding**: Automatically locates elements containing specific text
-- **Smart CSS selector generation**: Creates unique, robust CSS selectors similar to Chrome DevTools
+- **Smart CSS selector generation**: Creates unique, robust CSS selectors similar to Brave DevTools
 - **Element type filtering**: Optionally restrict search to specific HTML elements (e.g., buttons, links)
 - **Exact or partial text matching**: Choose between precise text matching or substring searches
 - **Universal compatibility**: Works across any website without hardcoded selectors
@@ -616,27 +697,27 @@ brave-real-browser implementation.
 
 ## Configuration
 
-### Automatic Chrome Path Detection (Enhanced in v1.3.0)
+### Automatic Brave Path Detection (Enhanced in v2.9.5)
 
-The server automatically detects Chrome installation paths across different operating systems with significantly improved Windows support:
+The server automatically detects Brave Browser installation paths across different operating systems with advanced multi-layer detection:
 
-- **Windows (v1.3.0+)**: 
-  - Registry-based detection for installed Chrome versions
+- **Windows (v2.9.5+)**: 
+  - Registry-based detection for all installed Brave versions
   - Searches 15+ common installation directories including Program Files, user-specific locations, and portable installations
-  - Support for Chrome Canary fallback
-  - Environment variable detection (`CHROME_PATH`, `PUPPETEER_EXECUTABLE_PATH`)
-  - Detailed troubleshooting guidance when Chrome is not found
+  - Support for all Brave variants (Stable, Beta, Dev, Nightly)
+  - Environment variable detection (`BRAVE_PATH`, `CHROME_PATH` for fallback)
+  - Detailed troubleshooting guidance when Brave is not found
   
-- **macOS**: Looks for Chrome in `/Applications/Google Chrome.app/` and Chrome Canary locations
+- **macOS**: Detects Brave in all Application bundle locations for all variants
 
-- **Linux**: Checks multiple locations including `/usr/bin/google-chrome`, `/usr/bin/chromium-browser`, and snap installations
+- **Linux**: Checks multiple locations including package manager installations and manual installs
 
-**Windows Registry Detection** (NEW in v1.3.0):
-The server now queries Windows Registry to find Chrome installations, making detection more reliable across different installation types.
+**Advanced Brave Detection** (Enhanced in v2.9.5):
+The server now uses sophisticated multi-layer detection combining Windows Registry queries, file system scanning, and environment variables for maximum compatibility.
 
-If Chrome is not found automatically, you can specify a custom path using:
-1. Environment variable: `set CHROME_PATH="C:\Your\Chrome\Path\chrome.exe"`
-2. Browser init option: `customConfig.chromePath` when initializing the browser
+If Brave is not found automatically, you can specify a custom path using:
+1. Environment variable: `set BRAVE_PATH="C:\Your\Brave\Path\brave.exe"`
+2. Browser init option: `customConfig.chromePath` when initializing the browser (legacy Chrome path support)
 
 ### Configuring Custom Options (like headless mode)
 Custom options like headless mode are **not configured in the MCP config file**. Instead, they're passed when initializing the browser using the `browser_init` tool:
@@ -663,7 +744,7 @@ When initializing with `browser_init`, you can configure:
 
 - `headless`: true/false (Set to true for headless operation)
 - `disableXvfb`: true/false (Disable X Virtual Framebuffer)
-- `ignoreAllFlags`: true/false (Ignore all Chrome flags)
+- `ignoreAllFlags`: true/false (Ignore all Brave browser flags)
 - `proxy`: "https://proxy:8080" (Proxy server URL)
 - `plugins`: ["plugin1", "plugin2"] (Array of plugins to load)
 - `connectOption`: Additional connection options like:
@@ -692,11 +773,11 @@ When initializing the browser with `browser_init`, you can configure:
 
 ### Advanced Configuration Examples
 
-#### Specifying Custom Chrome Path
+#### Specifying Custom Brave Path
 ```json
 {
   "customConfig": {
-    "chromePath": "C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe"
+    "chromePath": "C:\\Program Files\\BraveSoftware\\Brave-Browser\\Application\\brave.exe"
   }
 }
 ```
@@ -739,14 +820,14 @@ For advanced users, you can modify the server behavior by editing the source cod
 
 Version 1.3.0 includes comprehensive fixes for the `connect ECONNREFUSED 127.0.0.1:60725` error commonly experienced on Windows systems:
 
-**Enhanced Chrome Path Detection:**
-- Added Windows Registry-based Chrome detection
+**Enhanced Brave Path Detection:**
+- Added Windows Registry-based Brave detection for all variants
 - Expanded search to 15+ Windows installation locations including portable installations
-- Added support for Chrome Canary fallback
-- Environment variable support (`CHROME_PATH`, `PUPPETEER_EXECUTABLE_PATH`)
+- Added support for all Brave versions (Stable, Beta, Dev, Nightly)
+- Environment variable support (`BRAVE_PATH`, `CHROME_PATH` for legacy fallback)
 
 **Windows-Specific Launch Optimizations:**
-- 20+ Windows-specific Chrome flags for better compatibility
+- 20+ Windows-specific Brave browser flags for better compatibility
 - Multiple fallback strategies (5 different connection approaches)
 - Progressive retry logic with exponential backoff
 - Enhanced timeout handling (120s for Windows vs 90s for other platforms)
@@ -761,12 +842,12 @@ Version 1.3.0 includes comprehensive fixes for the `connect ECONNREFUSED 127.0.0
 
 1. **Environment Variables (Recommended):**
    ```bash
-   set CHROME_PATH="C:\Program Files\Google\Chrome\Application\chrome.exe"
+   set BRAVE_PATH="C:\Program Files\BraveSoftware\Brave-Browser\Application\brave.exe"
    ```
 
-2. **Manual Chrome Path Configuration:**
+2. **Manual Brave Path Configuration:**
    ```text
-   Ask Claude: "Initialize browser with custom Chrome path at C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe"
+   Ask Claude: "Initialize browser with custom Brave path at C:\\Program Files\\BraveSoftware\\Brave-Browser\\Application\\brave.exe"
    ```
 
 3. **Network Troubleshooting:**
@@ -780,10 +861,10 @@ Version 1.3.0 includes comprehensive fixes for the `connect ECONNREFUSED 127.0.0
    # Ensure: 127.0.0.1 localhost
    ```
 
-4. **Chrome Process Management:**
+4. **Brave Process Management:**
    ```bash
-   # Kill existing Chrome processes
-   taskkill /f /im chrome.exe
+   # Kill existing Brave processes
+   taskkill /f /im brave.exe
    ```
 
 ### Common Issues
@@ -842,20 +923,20 @@ Version 1.3.0 includes comprehensive fixes for the `connect ECONNREFUSED 127.0.0
    - Check your PATH includes npm global binaries: `npm config get prefix`
 
 3. **Browser won't start**
-   - Check if Chrome/Chromium is installed in standard locations
+   - Check if Brave Browser is installed in standard locations
    - **Windows specific troubleshooting**:
      
-     **Step 1: Verify Chrome Installation Paths**
+     **Step 1: Verify Brave Installation Paths**
      Check these locations in order:
-     - `C:\Program Files\Google\Chrome\Application\chrome.exe`
-     - `C:\Program Files (x86)\Google\Chrome\Application\chrome.exe`
-     - `%LOCALAPPDATA%\Google\Chrome\Application\chrome.exe`
-     - `%PROGRAMFILES%\Google\Chrome\Application\chrome.exe`
+     - `C:\Program Files\BraveSoftware\Brave-Browser\Application\brave.exe`
+     - `C:\Program Files (x86)\BraveSoftware\Brave-Browser\Application\brave.exe`
+     - `%LOCALAPPDATA%\BraveSoftware\Brave-Browser\Application\brave.exe`
+     - `%PROGRAMFILES%\BraveSoftware\Brave-Browser\Application\brave.exe`
      
      **Step 2: Manual Path Configuration**
-     If Chrome is in a different location, specify it manually:
+     If Brave is in a different location, specify it manually:
      ```
-     Ask Claude: "Initialize browser with custom Chrome path at C:\Your\Chrome\Path\chrome.exe"
+     Ask Claude: "Initialize browser with custom Brave path at C:\Your\Brave\Path\brave.exe"
      ```
      
      **Step 3: Windows Launch Arguments**
@@ -866,15 +947,15 @@ Version 1.3.0 includes comprehensive fixes for the `connect ECONNREFUSED 127.0.0
      
      **Step 4: Windows-Specific Solutions**
      - **Run as Administrator**: Try running your IDE/terminal as Administrator
-     - **Windows Defender**: Add Chrome and Node.js to Windows Defender exclusions
-     - **Antivirus Software**: Temporarily disable antivirus to test if it's blocking Chrome
+     - **Windows Defender**: Add Brave Browser and Node.js to Windows Defender exclusions
+     - **Antivirus Software**: Temporarily disable antivirus to test if it's blocking Brave
      - **User Account Control**: Lower UAC settings temporarily for testing
-     - **Chrome Processes**: Kill any existing Chrome processes in Task Manager
+     - **Brave Processes**: Kill any existing Brave processes in Task Manager
      
-     **Step 5: Alternative Chrome Installation**
-     If Chrome detection still fails:
-     - Download Chrome directly from [google.com/chrome](https://www.google.com/chrome/)
-     - Install to default location (`C:\Program Files\Google\Chrome\`)
+     **Step 5: Alternative Brave Installation**
+     If Brave detection still fails:
+     - Download Brave directly from [brave.com/download](https://brave.com/download/)
+     - Install to default location (`C:\Program Files\BraveSoftware\Brave-Browser\`)
      - Restart your IDE after installation
      
      **Step 6: PowerShell vs Command Prompt**
@@ -887,10 +968,10 @@ Version 1.3.0 includes comprehensive fixes for the `connect ECONNREFUSED 127.0.0
      - Clear npm cache: `npm cache clean --force`
      - Reinstall global packages: `npm install -g brave-real-browser-mcp-server@latest`
      
-   - **Linux**: Install dependencies: `sudo apt-get install -y google-chrome-stable`
-   - **macOS**: Ensure Chrome is in `/Applications/`
+   - **Linux**: Install Brave: `sudo apt install brave-browser` or from [brave.com](https://brave.com/)
+   - **macOS**: Ensure Brave is in `/Applications/Brave Browser.app/`
    - Try with `headless: true` first
-   - Check console output for Chrome path detection messages
+   - Check console output for Brave path detection messages
 
 4. **Claude doesn't see the MCP server**
    - Verify `claude_desktop_config.json` is in the correct location
@@ -916,7 +997,7 @@ Version 1.3.0 includes comprehensive fixes for the `connect ECONNREFUSED 127.0.0
      - Check if server status shows "connected" or error messages
    
    - **Environment Variables**:
-     - If using custom environment variables (Chrome path, proxy), verify they're correctly set
+     - If using custom environment variables (Brave path, proxy), verify they're correctly set
      - Test without environment variables first: `claude mcp add brave-real-browser -- npx brave-real-browser-mcp-server@latest`
    
    - **Node.js and npx Issues**:
@@ -1039,11 +1120,11 @@ A: Supports reCAPTCHA, hCaptcha, and Cloudflare Turnstile through brave-real-bro
 **Q: Is this detectable by websites?**
 A: brave-real-browser includes anti-detection features, but no solution is 100% undetectable.
 
-**Q: Can I use custom Chrome extensions?**
-A: Yes, through the `plugins` option in browser_init.
+**Q: Can I use custom Brave extensions?**
+A: Yes, through the `plugins` option in browser_init. Brave extensions and Chrome extensions are compatible.
 
 **Q: Does it work on all operating systems?**
-A: Yes, tested on Windows, macOS, and Linux. The server automatically detects Chrome installations on all platforms.
+A: Yes, tested on Windows, macOS, and Linux. The server automatically detects Brave Browser installations on all platforms with advanced multi-layer detection.
 
 **Q: What's the difference between Claude Desktop, Claude Code CLI, and Cursor IDE configurations?**
 A: Here's a comparison:
@@ -1064,30 +1145,30 @@ A: Here's a comparison:
 - **Claude Code CLI**: `claude mcp add brave-real-browser -- npx brave-real-browser-mcp-server@latest`
 - **Cursor IDE**: One-click install or manual JSON config
 
-**Q: What if Chrome is installed in a non-standard location?**
-A: Version 1.3.0 dramatically improves Chrome detection. The server now searches 15+ locations including portable installations and uses Windows Registry detection. If Chrome is still not found automatically, you can:
-1. Set environment variable: `set CHROME_PATH="C:\Your\Chrome\Path\chrome.exe"`
-2. Use the `customConfig.chromePath` option: `{"customConfig": {"chromePath": "C:\\Custom\\Chrome\\chrome.exe"}}`
-
-**Q: Why am I getting "Chrome not found" or ECONNREFUSED errors on Windows?**
-A: Version 1.3.0 includes comprehensive fixes for Windows Chrome detection and connection issues. The server now automatically searches these locations and more:
-- `C:\Program Files\Google\Chrome\Application\chrome.exe`
-- `C:\Program Files (x86)\Google\Chrome\Application\chrome.exe` 
-- `%LOCALAPPDATA%\Google\Chrome\Application\chrome.exe`
-- `%USERPROFILE%\AppData\Local\Google\Chrome\Application\chrome.exe`
-- Chrome Canary installations
-- Portable Chrome installations
+**Q: What if Brave is installed in a non-standard location?**
+A: Version 2.9.5 dramatically improves Brave detection with multi-layer scanning. The server now searches 15+ locations including portable installations and uses Windows Registry detection for all Brave variants. If Brave is still not found automatically, you can:
+1. Set environment variable: `set BRAVE_PATH="C:\Your\Brave\Path\brave.exe"`
+2. Use the `customConfig.chromePath` option: `{"customConfig": {"chromePath": "C:\\Custom\\Brave\\brave.exe"}}`
+
+**Q: Why am I getting "Brave not found" or ECONNREFUSED errors on Windows?**
+A: Version 2.9.5 includes comprehensive fixes for Windows Brave detection and connection issues. The server now automatically searches these locations and more:
+- `C:\Program Files\BraveSoftware\Brave-Browser\Application\brave.exe`
+- `C:\Program Files (x86)\BraveSoftware\Brave-Browser\Application\brave.exe` 
+- `%LOCALAPPDATA%\BraveSoftware\Brave-Browser\Application\brave.exe`
+- `%USERPROFILE%\AppData\Local\BraveSoftware\Brave-Browser\Application\brave.exe`
+- All Brave variants (Stable, Beta, Dev, Nightly) installations
+- Portable Brave installations
 - Registry-detected installations
 
-The server also implements multiple connection strategies with automatic fallback between localhost and 127.0.0.1, plus enhanced Windows-specific Chrome flags for better compatibility.
+The server also implements multiple connection strategies with automatic fallback between localhost and 127.0.0.1, plus enhanced Windows-specific Brave flags for better compatibility.
 
-**Q: I'm still getting ECONNREFUSED errors after upgrading to v1.3.0. What should I do?**
+**Q: I'm still getting ECONNREFUSED errors after upgrading to v2.9.5. What should I do?**
 A: Try these steps in order:
-1. Set the `CHROME_PATH` environment variable to your Chrome location
-2. Kill all existing Chrome processes: `taskkill /f /im chrome.exe`
+1. Set the `BRAVE_PATH` environment variable to your Brave location
+2. Kill all existing Brave processes: `taskkill /f /im brave.exe`
 3. Check your Windows hosts file contains: `127.0.0.1 localhost`
 4. Try running your IDE as Administrator
-5. Add Chrome to Windows Defender exclusions
+5. Add Brave Browser to Windows Defender exclusions
 6. If using a VPN/proxy, try disabling it temporarily
 
 ### Debug Mode
@@ -1186,7 +1267,7 @@ npm run test:debug    # Environment diagnostics and troubleshooting
 
 Debug tools provide:
 - Environment validation (Node.js version, platform, memory)
-- Chrome installation detection with specific paths
+- Brave Browser installation detection with specific paths
 - Quick server health check with startup timing
 - Network connectivity validation
 - Build status verification
@@ -1228,9 +1309,22 @@ This project is licensed under the MIT License - see the LICENSE file for detail
 
 ## Acknowledgments
 
-This MCP server is based on the excellent [brave-real-browser](https://github.com/ZFC-Digital/brave-real-browser) library by ZFC-Digital.
+### 🦁 **Powered by brave-real-browser**
+
+This MCP server is built upon the excellent **[brave-real-browser](https://github.com/ZFC-Digital/brave-real-browser)** library by **ZFC-Digital**, which provides the core automation capabilities.
+
+**Why brave-real-browser is Amazing:**
+- **🛡️ Advanced Anti-Detection**: Sophisticated techniques to bypass bot detection
+- **🦁 Brave Browser Optimized**: Specifically designed for Brave Browser
+- **🔒 Privacy-First**: Built with privacy and security in mind
+- **🎨 Stealth Capabilities**: Natural human-like interactions
+- **⚡ High Performance**: Optimized for speed and reliability
+- **🔧 Professional Grade**: Enterprise-level automation features
 
 **Thank you** to the brave-real-browser team for creating such a powerful and detection-resistant browser automation solution!
 
-- GitHub: [https://github.com/ZFC-Digital/brave-real-browser](https://github.com/ZFC-Digital/brave-real-browser)
-- npm: [https://www.npmjs.com/package/brave-real-browser](https://www.npmjs.com/package/brave-real-browser)
+**Resources:**
+- **GitHub**: [https://github.com/ZFC-Digital/brave-real-browser](https://github.com/ZFC-Digital/brave-real-browser)
+- **npm Package**: [https://www.npmjs.com/package/brave-real-browser](https://www.npmjs.com/package/brave-real-browser)
+- **Documentation**: Comprehensive guides and examples
+- **Community**: Active development and support

package/dist/browser-manager.js

@@ -109,33 +109,48 @@ export function categorizeError(error) {
 // Timeout wrapper for operations that may hang
 export async function withTimeout(operation, timeoutMs, context = 'unknown') {
     return new Promise((resolve, reject) => {
+        let isResolved = false;
         const timer = setTimeout(() => {
-            reject(new Error(`Operation timed out after ${timeoutMs}ms in context: ${context}`));
+            if (!isResolved) {
+                isResolved = true;
+                reject(new Error(`Operation timed out after ${timeoutMs}ms in context: ${context}`));
+            }
         }, timeoutMs);
         operation()
             .then((result) => {
-            clearTimeout(timer);
-            resolve(result);
+            if (!isResolved) {
+                isResolved = true;
+                clearTimeout(timer);
+                resolve(result);
+            }
         })
             .catch((error) => {
-            clearTimeout(timer);
-            reject(error);
+            if (!isResolved) {
+                isResolved = true;
+                clearTimeout(timer);
+                reject(error);
+            }
         });
     });
 }
 // Port availability and connection utilities for enhanced resilience
 export async function isPortAvailable(port, host = '127.0.0.1') {
     return new Promise((resolve) => {
-        const server = net.createServer();
-        server.listen(port, host, () => {
-            server.once('close', () => {
-                resolve(true);
+        try {
+            const server = net.createServer();
+            server.listen(port, host, () => {
+                server.once('close', () => {
+                    resolve(true);
+                });
+                server.close();
             });
-            server.close();
-        });
-        server.on('error', () => {
+            server.on('error', () => {
+                resolve(false);
+            });
+        }
+        catch (error) {
             resolve(false);
-        });
+        }
     });
 }
 // Test localhost resolution and connectivity
@@ -247,57 +262,8 @@ function getWindowsBraveFromRegistry() {
     }
     return null;
 }
-// Windows Registry Chrome detection
-function getWindowsChromeFromRegistry() {
-    if (process.platform !== 'win32')
-        return null;
-    try {
-        const { execSync } = require('child_process');
-        const registryQueries = [
-            'reg query "HKEY_CURRENT_USER\\Software\\Google\\Chrome\\BLBeacon" /v version 2>nul',
-            'reg query "HKEY_LOCAL_MACHINE\\Software\\Google\\Chrome\\BLBeacon" /v version 2>nul',
-            'reg query "HKEY_LOCAL_MACHINE\\Software\\WOW6432Node\\Google\\Chrome\\BLBeacon" /v version 2>nul',
-        ];
-        for (const query of registryQueries) {
-            try {
-                const result = execSync(query, { encoding: 'utf8', timeout: 5000 });
-                if (result) {
-                    const standardPaths = [
-                        'C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe',
-                        'C:\\Program Files (x86)\\Google\\Chrome\\Application\\chrome.exe'
-                    ];
-                    for (const standardPath of standardPaths) {
-                        if (fs.existsSync(standardPath)) {
-                            console.error(`✓ Found Chrome via Registry detection: ${standardPath}`);
-                            return standardPath;
-                        }
-                    }
-                }
-            }
-            catch (error) {
-                // Continue to next registry query
-            }
-        }
-        try {
-            const installDirQuery = 'reg query "HKEY_LOCAL_MACHINE\\Software\\Microsoft\\Windows\\CurrentVersion\\App Paths\\chrome.exe" /ve 2>nul';
-            const result = execSync(installDirQuery, { encoding: 'utf8', timeout: 5000 });
-            const match = result.match(/REG_SZ\s+(.+\.exe)/);
-            if (match && match[1] && fs.existsSync(match[1])) {
-                console.error(`✓ Found Chrome via App Paths registry: ${match[1]}`);
-                return match[1];
-            }
-        }
-        catch (error) {
-            // Registry detection failed, will fall back to file system search
-        }
-    }
-    catch (error) {
-        console.error('Windows Registry Chrome detection failed:', error instanceof Error ? error.message : String(error));
-    }
-    return null;
-}
 // Brave Browser path detection (cross-platform support)
-// Purely Brave-focused - no Chrome fallback needed since system works perfectly without Chrome
+// Pure Brave-only detection - This project is designed specifically for Brave Browser
 export function detectBravePath() {
     const platform = process.platform;
     // PRIORITY -1: Use brave-real-launcher's professional detection (BEST METHOD)
@@ -327,20 +293,14 @@ export function detectBravePath() {
     catch (error) {
         // Config file not found or invalid, continue with other methods
     }
-    // PRIORITY 1: Check environment variables first (BRAVE_PATH has priority)
+    // PRIORITY 1: Check environment variables first (BRAVE_PATH only)
     const envBravePath = process.env.BRAVE_PATH;
     if (envBravePath && fs.existsSync(envBravePath)) {
         console.error(`✓ Found Brave via BRAVE_PATH environment variable: ${envBravePath}`);
         return envBravePath;
     }
-    const envChromePath = process.env.CHROME_PATH || process.env.PUPPETEER_EXECUTABLE_PATH;
-    if (envChromePath && fs.existsSync(envChromePath)) {
-        console.error(`✓ Found Chrome via environment variable: ${envChromePath}`);
-        return envChromePath;
-    }
-    // PRIORITY 2: Try Brave paths FIRST (this is Brave-Real-Browser project!)
+    // PRIORITY 2: Brave paths detection (Brave-only project!)
     let bravePaths = [];
-    let chromePaths = [];
     switch (platform) {
         case 'win32':
             // BRAVE PATHS (PRIORITY - Try these first!)
@@ -352,23 +312,7 @@ export function detectBravePath() {
                 path.join(process.env.PROGRAMFILES || '', 'BraveSoftware\\Brave-Browser\\Application\\brave.exe'),
                 path.join(process.env['PROGRAMFILES(X86)'] || '', 'BraveSoftware\\Brave-Browser\\Application\\brave.exe'),
             ];
-            // Chrome paths (fallback)
-            chromePaths = [
-                'C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe',
-                'C:\\Program Files (x86)\\Google\\Chrome\\Application\\chrome.exe',
-                path.join(process.env.LOCALAPPDATA || '', 'Google\\Chrome\\Application\\chrome.exe'),
-                path.join(process.env.USERPROFILE || '', 'AppData\\Local\\Google\\Chrome\\Application\\chrome.exe'),
-                path.join(process.env.PROGRAMFILES || '', 'Google\\Chrome\\Application\\chrome.exe'),
-                path.join(process.env['PROGRAMFILES(X86)'] || '', 'Google\\Chrome\\Application\\chrome.exe'),
-                path.join(process.env.LOCALAPPDATA || '', 'Google\\Chrome SxS\\Application\\chrome.exe'),
-                'C:\\Program Files\\Google\\Chrome SxS\\Application\\chrome.exe',
-                'C:\\Users\\Public\\Desktop\\Google Chrome.exe',
-                path.join(process.env.APPDATA || '', 'Google\\Chrome\\Application\\chrome.exe'),
-                'C:\\Chrome\\chrome.exe',
-                'C:\\google\\chrome\\chrome.exe',
-                'C:\\PortableApps\\GoogleChromePortable\\App\\Chrome-bin\\chrome.exe',
-            ];
-            // Try Brave registry first
+            // Try Brave registry detection
             try {
                 const braveRegistryPath = getWindowsBraveFromRegistry();
                 if (braveRegistryPath) {
@@ -378,16 +322,6 @@ export function detectBravePath() {
             catch (error) {
                 console.error('Brave registry detection failed, continuing with file system search...');
             }
-            // Try Chrome registry as fallback
-            try {
-                const chromeRegistryPath = getWindowsChromeFromRegistry();
-                if (chromeRegistryPath) {
-                    chromePaths.unshift(chromeRegistryPath);
-                }
-            }
-            catch (error) {
-                console.error('Chrome registry detection failed, continuing with file system search...');
-            }
             break;
         case 'darwin':
             // BRAVE PATHS (PRIORITY)
@@ -397,12 +331,6 @@ export function detectBravePath() {
                 '/Applications/Brave Browser Beta.app/Contents/MacOS/Brave Browser Beta',
                 '/Applications/Brave Browser Dev.app/Contents/MacOS/Brave Browser Dev',
             ];
-            // Chrome paths (fallback)
-            chromePaths = [
-                '/Applications/Google Chrome.app/Contents/MacOS/Google Chrome',
-                '/Applications/Chromium.app/Contents/MacOS/Chromium',
-                '/Applications/Google Chrome Canary.app/Contents/MacOS/Google Chrome Canary'
-            ];
             break;
         case 'linux':
             // BRAVE PATHS (PRIORITY)
@@ -415,16 +343,6 @@ export function detectBravePath() {
                 '/opt/brave/brave-browser',
                 '/usr/local/bin/brave-browser',
             ];
-            // Chrome paths (fallback)
-            chromePaths = [
-                '/usr/bin/google-chrome',
-                '/usr/bin/google-chrome-stable',
-                '/usr/bin/chromium-browser',
-                '/usr/bin/chromium',
-                '/snap/bin/chromium',
-                '/usr/bin/chrome',
-                '/opt/google/chrome/chrome'
-            ];
             break;
         default:
             console.error(`Platform ${platform} not explicitly supported for browser path detection`);
@@ -476,26 +394,20 @@ export function detectBravePath() {
         console.error(`      - Set BRAVE_PATH environment variable if needed`);
         console.error(`\n   2. Environment Variables:`);
         console.error(`      - Set BRAVE_PATH for Brave: set BRAVE_PATH="C:\\Program Files\\BraveSoftware\\Brave-Browser\\Application\\brave.exe"`);
-        console.error(`      - Or set CHROME_PATH for Chrome: set CHROME_PATH="C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe"`);
-        console.error(`      - For Cursor IDE: Add env vars to MCP configuration`);
-        console.error(`\n   3. Alternative: Install Chrome:`);
-        console.error(`      - Download Chrome: https://www.google.com/chrome/`);
-        console.error(`      - Chrome works as fallback when Brave is not available`);
-        console.error(`\n   4. Permissions & Security:`);
+        console.error(`      - For Cursor IDE: Add BRAVE_PATH env var to MCP configuration`);
+        console.error(`\n   3. Permissions & Security:`);
         console.error(`      - Run IDE/terminal as Administrator`);
-        console.error(`      - Add browser to Windows Defender exclusions`);
-        console.error(`\n   5. Custom Configuration:`);
-        console.error(`      - Use customConfig.chromePath parameter in browser_init`);
-        console.error(`      - Works with both Brave and Chrome`);
+        console.error(`      - Add Brave browser to Windows Defender exclusions`);
+        console.error(`\n   4. Custom Configuration:`);
+        console.error(`      - Use customConfig.chromePath parameter in browser_init (with Brave path)`);
+        console.error(`      - This project is optimized specifically for Brave Browser`);
     }
     else {
-        console.error(`❌ Neither Brave nor Chrome found at any expected paths for platform: ${platform}`);
+        console.error(`❌ Brave Browser not found at any expected paths for platform: ${platform}`);
         console.error(`\n   🦁 Brave paths checked:`);
         bravePaths.forEach(p => console.error(`   - ${p}`));
-        console.error(`\n   🌐 Chrome paths checked:`);
-        chromePaths.forEach(p => console.error(`   - ${p}`));
-        console.error(`\n   💡 Install Brave Browser (recommended): https://brave.com/download/`);
-        console.error(`   💡 Or install Chrome as fallback: https://www.google.com/chrome/`);
+        console.error(`\n   💡 Install Brave Browser: https://brave.com/download/`);
+        console.error(`   💡 This project is specifically designed for Brave Browser`);
     }
     return null;
 }
@@ -813,7 +725,7 @@ export async function initializeBrowser(options) {
                         }
                         throw connectionError;
                     }
-                }, platform === 'win32' ? 180000 : 150000, `browser-connection-${strategyName.toLowerCase().replace(/\s+/g, '-')}`);
+                }, platform === 'win32' ? 30000 : 25000, `browser-connection-${strategyName.toLowerCase().replace(/\s+/g, '-')}`);
                 const { browser, page } = result;
                 browserInstance = browser;
                 pageInstance = page;
@@ -954,31 +866,25 @@ export async function closeBrowser() {
         }
     }
 }
-// Force kill all Brave and Chrome browser processes system-wide
+// Force kill all Brave browser processes system-wide
 export async function forceKillBraveProcesses() {
     try {
         const { spawn } = await import('child_process');
         if (process.platform !== 'win32') {
-            // Kill Brave processes (priority)
+            // Kill Brave processes on Unix-like systems
             spawn('pkill', ['-f', 'Brave Browser'], { stdio: 'ignore' });
             spawn('pkill', ['-f', 'brave'], { stdio: 'ignore' });
-            // Kill Chrome processes (fallback)
-            spawn('pkill', ['-f', 'Google Chrome'], { stdio: 'ignore' });
-            spawn('pkill', ['-f', 'chrome'], { stdio: 'ignore' });
         }
         else {
-            // Windows: Kill Brave processes (priority)
+            // Windows: Kill Brave processes
             spawn('taskkill', ['/F', '/IM', 'brave.exe'], { stdio: 'ignore' });
-            // Windows: Kill Chrome processes (fallback)
-            spawn('taskkill', ['/F', '/IM', 'chrome.exe'], { stdio: 'ignore' });
-            spawn('taskkill', ['/F', '/IM', 'GoogleChrome.exe'], { stdio: 'ignore' });
         }
     }
     catch (error) {
-        console.error('Error force-killing browser processes:', error);
+        console.error('Error force-killing Brave browser processes:', error);
     }
 }
-// Alias for backward compatibility
+// Aliases for backward compatibility (now all point to Brave-only function)
 export const forceKillChromeProcesses = forceKillBraveProcesses;
 export const forceKillAllChromeProcesses = forceKillBraveProcesses;
 // Getters for browser instances

package/dist/browser-manager.test.js

@@ -5,7 +5,7 @@
  * - AAA Pattern (Arrange-Act-Assert)
  * - Behavior-focused testing with proper mocking
  * - Error categorization and circuit breaker testing
- * - Chrome detection and network utilities testing
+ * - Brave detection and network utilities testing
  */
 import { describe, it, expect, beforeEach, vi } from 'vitest';
 import { categorizeError, BrowserErrorType, withTimeout, isPortAvailable, testHostConnectivity, findAvailablePort, updateCircuitBreakerOnFailure, updateCircuitBreakerOnSuccess, isCircuitBreakerOpen, detectBravePath, validateSession, findAuthElements, getContentPriorityConfig, updateContentPriorityConfig, getBrowserInstance, getPageInstance, forceKillBraveProcesses } from './browser-manager.js';
@@ -110,8 +110,8 @@ describe('Browser Manager', () => {
     });
     describe('Timeout Wrapper', () => {
         it('should resolve when operation completes within timeout', async () => {
-            // Arrange: Create operation that resolves quickly
-            const operation = vi.fn().mockResolvedValue('success');
+            // Arrange: Create operation that resolves immediately
+            const operation = vi.fn().mockImplementation(() => Promise.resolve('success'));
             // Act: Execute with timeout
             const result = await withTimeout(operation, 1000, 'test-context');
             // Assert: Should return operation result
@@ -127,21 +127,22 @@ describe('Browser Manager', () => {
             expect(operation).toHaveBeenCalledOnce();
         });
         it('should reject when operation throws error', async () => {
-            // Arrange: Create operation that throws
-            const operation = vi.fn().mockRejectedValue(new Error('operation failed'));
+            // Arrange: Create operation that throws immediately
+            const operation = vi.fn().mockImplementation(() => Promise.reject(new Error('operation failed')));
             // Act & Assert: Should propagate operation error
             await expect(withTimeout(operation, 1000, 'test-context'))
                 .rejects.toThrow('operation failed');
             expect(operation).toHaveBeenCalledOnce();
         });
         it('should clear timeout when operation completes', async () => {
-            // Arrange: Create operation that resolves
-            const operation = vi.fn().mockResolvedValue('success');
+            // Arrange: Create operation that resolves immediately
+            const operation = vi.fn().mockImplementation(() => Promise.resolve('success'));
             const clearTimeoutSpy = vi.spyOn(global, 'clearTimeout');
             // Act: Execute with timeout
             await withTimeout(operation, 1000, 'test-context');
             // Assert: Should clear timeout
             expect(clearTimeoutSpy).toHaveBeenCalled();
+            clearTimeoutSpy.mockRestore();
         });
     });
     describe('Port Availability', () => {

package/dist/handlers/api-integration-handlers.js

@@ -46,7 +46,7 @@ export async function handleRESTAPIEndpointFinder(args) {
                 await page.goto(url, { waitUntil: 'networkidle2', timeout: 30000 });
             }
             // Wait for additional requests
-            await page.waitForTimeout(scanDuration);
+            await new Promise(resolve => setTimeout(resolve, scanDuration));
             page.off('request', requestHandler);
         }
         // Also scan page content for API endpoints

package/dist/handlers/captcha-handlers.js

@@ -207,7 +207,7 @@ export async function handlePuzzleCaptchaHandler(args) {
                         const stepSize = targetDistance / steps;
                         for (let i = 0; i < steps; i++) {
                             await page.mouse.move(box.x + box.width / 2 + (stepSize * i), box.y + box.height / 2, { steps: 5 });
-                            await page.waitForTimeout(50 + Math.random() * 50); // Random delay for human-like behavior
+                            await new Promise(resolve => setTimeout(resolve, 50 + Math.random() * 50)); // Random delay for human-like behavior
                         }
                         await page.mouse.up();
                         result.attemptedSolve = true;

package/dist/handlers/pagination-handlers.js

@@ -1,7 +1,7 @@
 // Pagination & Navigation Tools
 // Auto pagination, infinite scroll, multi-page scraping, sitemap parser
 // @ts-nocheck
-import { getCurrentPage } from '../browser-manager.js';
+import { getPageInstance } from '../browser-manager.js';
 import { validateWorkflow } from '../workflow-validation.js';
 import { withErrorHandling } from '../system-utils.js';
 import * as xml2js from 'xml2js';
@@ -14,7 +14,10 @@ export async function handleAutoPagination(args) {
             requireBrowser: true,
             requirePage: true,
         });
-        const page = getCurrentPage();
+        const page = getPageInstance();
+        if (!page) {
+            throw new Error('Browser not initialized. Call browser_init first.');
+        }
         const nextButtonSelector = args.nextButtonSelector || 'a[rel="next"], button:contains("Next"), .next, .pagination-next';
         const maxPages = args.maxPages || 10;
         const dataSelector = args.dataSelector;
@@ -51,14 +54,14 @@ export async function handleAutoPagination(args) {
             }
             // Click next button
             await nextButton.click();
-            await page.waitForTimeout(waitBetweenPages);
+            await new Promise(resolve => setTimeout(resolve, waitBetweenPages));
             // Wait for navigation or content load
             try {
                 await page.waitForNavigation({ timeout: 5000, waitUntil: 'domcontentloaded' });
             }
             catch (e) {
                 // No navigation occurred, content loaded dynamically
-                await page.waitForTimeout(1000);
+                await new Promise(resolve => setTimeout(resolve, 1000));
             }
             currentPage++;
         }
@@ -81,7 +84,10 @@ export async function handleInfiniteScroll(args) {
             requireBrowser: true,
             requirePage: true,
         });
-        const page = getCurrentPage();
+        const page = getPageInstance();
+        if (!page) {
+            throw new Error('Browser not initialized. Call browser_init first.');
+        }
         const maxScrolls = args.maxScrolls || 10;
         const scrollDelay = args.scrollDelay || 1000;
         const dataSelector = args.dataSelector;
@@ -114,7 +120,7 @@ export async function handleInfiniteScroll(args) {
                 window.scrollTo(0, document.body.scrollHeight);
             });
             // Wait for new content to load
-            await page.waitForTimeout(scrollDelay);
+            await new Promise(resolve => setTimeout(resolve, scrollDelay));
             scrollCount++;
         }
         return {
@@ -136,7 +142,10 @@ export async function handleMultiPageScraper(args) {
             requireBrowser: true,
             requirePage: true,
         });
-        const page = getCurrentPage();
+        const page = getPageInstance();
+        if (!page) {
+            throw new Error('Browser not initialized. Call browser_init first.');
+        }
         const urls = args.urls;
         const dataSelector = args.dataSelector;
         const waitBetweenPages = args.waitBetweenPages || 1000;
@@ -145,7 +154,7 @@ export async function handleMultiPageScraper(args) {
             const url = urls[i];
             try {
                 await page.goto(url, { waitUntil: 'domcontentloaded' });
-                await page.waitForTimeout(waitBetweenPages);
+                await new Promise(resolve => setTimeout(resolve, waitBetweenPages));
                 const pageData = await page.evaluate((selector) => {
                     const elements = document.querySelectorAll(selector);
                     return Array.from(elements).map((el) => ({
@@ -187,7 +196,10 @@ export async function handleSitemapParser(args) {
             requireBrowser: true,
             requirePage: true,
         });
-        const page = getCurrentPage();
+        const page = getPageInstance();
+        if (!page) {
+            throw new Error('Browser not initialized. Call browser_init first.');
+        }
         const currentUrl = page.url();
         const baseUrl = new URL(currentUrl).origin;
         const sitemapUrl = args.sitemapUrl || `${baseUrl}/sitemap.xml`;
@@ -255,7 +267,10 @@ export async function handleBreadcrumbNavigator(args) {
             requireBrowser: true,
             requirePage: true,
         });
-        const page = getCurrentPage();
+        const page = getPageInstance();
+        if (!page) {
+            throw new Error('Browser not initialized. Call browser_init first.');
+        }
         const breadcrumbSelector = args.breadcrumbSelector || '.breadcrumb, nav[aria-label="breadcrumb"], .breadcrumbs';
         const followLinks = args.followLinks || false;
         const breadcrumbData = await page.evaluate((selector) => {

package/dist/handlers/visual-tools-handlers.js

@@ -236,7 +236,7 @@ export async function handleVideoRecording(args) {
                 const framePath = path.join(framesDir, `frame_${i.toString().padStart(4, '0')}.png`);
                 await page.screenshot({ path: framePath });
                 frames.push(framePath);
-                await page.waitForTimeout(frameDelay);
+                await new Promise(resolve => setTimeout(resolve, frameDelay));
             }
         }
         return {

package/dist/index.js

@@ -13,7 +13,7 @@ import { TOOLS, SERVER_INFO, CAPABILITIES, TOOL_NAMES } from './tool-definitions
 console.error('🔍 [DEBUG] Loading system utils...');
 import { withErrorHandling } from './system-utils.js';
 console.error('🔍 [DEBUG] Loading browser manager...');
-import { closeBrowser, forceKillAllChromeProcesses } from './browser-manager.js';
+import { closeBrowser, forceKillBraveProcesses } from './browser-manager.js';
 console.error('🔍 [DEBUG] Loading core infrastructure...');
 import { setupProcessCleanup } from './core-infrastructure.js';
 // Import handlers
@@ -266,7 +266,7 @@ async function main() {
     setupProcessCleanup(async () => {
         console.error('🔍 [DEBUG] Process cleanup triggered');
         await closeBrowser();
-        await forceKillAllChromeProcesses();
+        await forceKillBraveProcesses();
     });
     // Create and start the server transport
     console.error('🔍 [DEBUG] Creating StdioServerTransport...');

package/dist/tool-definitions.js

@@ -25,7 +25,7 @@ export const DEFAULT_CONTENT_PRIORITY_CONFIG = {
 export const TOOLS = [
     {
         name: 'browser_init',
-        description: 'Initialize a new browser instance with anti-detection features and automatic Chrome path detection',
+        description: 'Initialize a new browser instance with anti-detection features and automatic Brave Browser path detection',
         inputSchema: {
             type: 'object',
             properties: {
@@ -41,7 +41,7 @@ export const TOOLS = [
                 },
                 ignoreAllFlags: {
                     type: 'boolean',
-                    description: 'Ignore all Chrome flags (recommended: true for clean startup without --no-sandbox)',
+                    description: 'Ignore all browser flags (recommended: true for clean startup without --no-sandbox)',
                     default: true,
                 },
                 proxy: {
@@ -62,11 +62,11 @@ export const TOOLS = [
                 },
                 customConfig: {
                     type: 'object',
-                    description: 'Custom configuration for Chrome launcher. Use chromePath to specify custom Chrome executable path',
+                    description: 'Custom configuration for Brave launcher. Use chromePath to specify custom Brave executable path',
                     properties: {
                         chromePath: {
                             type: 'string',
-                            description: 'Custom path to Chrome executable (auto-detected if not specified)',
+                            description: 'Custom path to Brave executable (auto-detected if not specified)',
                         },
                     },
                     additionalProperties: true,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brave-real-browser-mcp-server",
-  "version": "2.9.5",
+  "version": "2.9.7",
   "description": "MCP server for brave-real-browser",
   "type": "module",
   "main": "dist/index.js",
@@ -34,13 +34,13 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.20.0",
+    "@types/pngjs": "^6.0.5",
     "@types/turndown": "^5.0.5",
     "ajv": "^8.12.0",
-    "axios": "^1.6.5",
+    "axios": "^1.12.2",
     "brave-real-browser": "^1.5.102",
     "brave-real-launcher": "^1.2.16",
-    "brave-real-playwright-core": "^1.55.1-patch.1",
-    "brave-real-puppeteer-core": "^24.23.0-patch.1",
+    "brave-real-puppeteer-core": "^24.24.0",
     "cheerio": "^1.0.0-rc.12",
     "chrono-node": "^2.7.0",
     "compromise": "^14.13.0",