brave-real-browser-mcp-server 2.9.12 → 2.9.13

package/README.md

@@ -43,46 +43,6 @@ If you're just using this MCP server (not developing it), you don't need to run
 - Download and install Node.js (version 18 or higher)
 - Verify installation by opening terminal/command prompt and typing: `node --version`
 
-## Installation for Developers
-
-> **Note for Claude Desktop Users:** You don't need to install anything! The npx command in your configuration automatically handles everything. Skip to the [Usage](#usage) section.
-
-This section is for developers who want to:
-- Contribute to the project
-- Run the server locally for development
-- Create custom modifications
-
-### Global Installation (For Command Line Usage)
-
-If you want to run the server directly from the command line without using npx:
-
-```bash
-npm install -g brave-real-browser-mcp-server@latest
-```
-
-After global installation, you can run:
-```bash
-brave-real-browser-mcp-server
-```
-
-### Development Setup (For Contributors)
-
-```bash
-# Clone the repository
-git clone https://github.com/withLinda/brave-real-browser-mcp-server.git
-cd brave-real-browser-mcp-server
-
-# Install dependencies
-npm install
-
-# Build the project
-npm run build
-
-# Run in development mode
-npm run dev
-```
-
-
 #### 2. Configure Claude Desktop
 
 **For Windows:**
@@ -101,20 +61,6 @@ npm run dev
 }
 ```
 
-```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/`
@@ -167,23 +113,15 @@ 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 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
+- **Stealth by default**: All browser instances use anti-detection features
+- **Enhanced Windows support**: Comprehensive Chrome detection and ECONNREFUSED error fixes (v1.3.0)
+- **Smart Chrome detection**: Registry-based detection + 15+ installation paths (Windows)
 - **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**: 62+ professional tools covering all browser automation needs
+- **Comprehensive toolset**: 11 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
@@ -195,58 +133,65 @@ assistants to control a real browser, extract content, and more.
 
 - Node.js >= 18.0.0
 - npm or yarn
-- **Brave Browser (REQUIRED)** - This project exclusively uses Brave Browser
+- Google Chrome or Chromium browser installed
 - Basic understanding of TypeScript/JavaScript (for development)
 
-### Browser Requirements
-
-#### 🦁 Brave Browser (Required)
-
-This project **exclusively uses Brave Browser** and is specifically optimized for the `brave-real-browser` package with advanced integration features.
-
-**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
-
-**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
+### Platform-Specific Requirements
+
+**Windows:**
+- Google Chrome installation (automatic detection in v1.3.0+ includes):
+  - Standard installations: `C:\Program Files\Google\Chrome\Application\chrome.exe`
+  - 32-bit installations: `C:\Program Files (x86)\Google\Chrome\Application\chrome.exe`
+  - User installations: `%LOCALAPPDATA%\Google\Chrome\Application\chrome.exe`
+  - Chrome Canary: `%LOCALAPPDATA%\Google\Chrome SxS\Application\chrome.exe`
+  - Portable installations and Registry-detected paths
+  - Manual path specification: Use `CHROME_PATH` environment variable
 
 **macOS:**
-- **Brave Browser** paths:
-  - `/Applications/Brave Browser.app/Contents/MacOS/Brave Browser`
-  - `/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`
+- Google Chrome or Chromium must be installed in `/Applications/`
 
 **Linux:**
-- **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`, `/usr/bin/brave`, `/opt/brave.com/brave/brave-browser`
+- Install Chrome/Chromium: `sudo apt-get install -y google-chrome-stable` or `sudo apt-get install -y chromium-browser`
 - Install xvfb for headless operation: `sudo apt-get install -y xvfb`
 
+## Installation for Developers
+
+> **Note for Claude Desktop Users:** You don't need to install anything! The npx command in your configuration automatically handles everything. Skip to the [Usage](#usage) section.
+
+This section is for developers who want to:
+- Contribute to the project
+- Run the server locally for development
+- Create custom modifications
+
+### Global Installation (For Command Line Usage)
+
+If you want to run the server directly from the command line without using npx:
+
+```bash
+npm install -g brave-real-browser-mcp-server@latest
+```
+
+After global installation, you can run:
+```bash
+brave-real-browser-mcp-server
+```
+
+### Development Setup (For Contributors)
+
+```bash
+# Clone the repository
+git clone https://github.com/withLinda/brave-real-browser-mcp-server.git
+cd brave-real-browser-mcp-server
+
+# Install dependencies
+npm install
+
+# Build the project
+npm run build
+
+# Run in development mode
+npm run dev
+```
 
 ## Usage
 
@@ -286,11 +231,11 @@ This command:
 
 #### Method 2: Add with Environment Variables
 
-If you need to configure proxy settings or custom Brave paths:
+If you need to configure proxy settings or custom Chrome paths:
 
 ```bash
 claude mcp add brave-real-browser \
-  -e BRAVE_PATH="/path/to/brave" \
+  -e CHROME_PATH="/path/to/chrome" \
   -e PROXY_URL="http://proxy:8080" \
   -- npx brave-real-browser-mcp-server@latest
 ```
@@ -317,7 +262,7 @@ claude mcp add-json brave-real-browser '{
   "command": "npx",
   "args": ["brave-real-browser-mcp-server@latest"],
   "env": {
-    "BRAVE_PATH": "/path/to/brave",
+    "CHROME_PATH": "/path/to/chrome",
     "PROXY_URL": "http://proxy:8080"
   }
 }'
@@ -354,7 +299,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, Brave paths, etc.
+- **Environment Variables**: Easy configuration of proxies, Chrome 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
@@ -392,7 +337,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 Brave path issues):**
+**Windows-Specific Configuration (if experiencing Chrome path issues):**
 ```json
 {
   "mcpServers": {
@@ -400,7 +345,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": {
-        "BRAVE_PATH": "C:/Program Files/BraveSoftware/Brave-Browser/Application/brave.exe"
+        "CHROME_PATH": "C:/Program Files/Google/Chrome/Application/chrome.exe"
       }
     }
   }
@@ -409,7 +354,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 Brave Path:**
+**Advanced Configuration with Custom Chrome Path:**
 ```json
 {
   "mcpServers": {
@@ -417,7 +362,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": {
-        "BRAVE_PATH": "C:/Program Files/BraveSoftware/Brave-Browser/Application/brave.exe"
+        "CHROME_PATH": "C:/Program Files/Google/Chrome/Application/chrome.exe"
       }
     }
   }
@@ -426,34 +371,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 Brave Paths for Cursor IDE
+#### Platform-Specific Chrome Paths for Cursor IDE
 
-If Brave auto-detection fails, you can specify the Brave path using the `BRAVE_PATH` environment variable:
+If Chrome auto-detection fails, you can specify the Chrome path using the `CHROME_PATH` environment variable:
 
 **Windows:**
 ```json
 "env": {
-  "BRAVE_PATH": "C:/Program Files/BraveSoftware/Brave-Browser/Application/brave.exe"
+  "CHROME_PATH": "C:/Program Files/Google/Chrome/Application/chrome.exe"
 }
 ```
 Alternative Windows paths:
-- `"C:/Program Files (x86)/BraveSoftware/Brave-Browser/Application/brave.exe"`
-- `"%LOCALAPPDATA%/BraveSoftware/Brave-Browser/Application/brave.exe"`
+- `"C:/Program Files (x86)/Google/Chrome/Application/chrome.exe"`
+- `"%LOCALAPPDATA%/Google/Chrome/Application/chrome.exe"`
 
 **macOS:**
 ```json
 "env": {
-  "BRAVE_PATH": "/Applications/Brave Browser.app/Contents/MacOS/Brave Browser"
+  "CHROME_PATH": "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome"
 }
 ```
 
 **Linux:**
 ```json
 "env": {
-  "BRAVE_PATH": "/usr/bin/brave-browser"
+  "CHROME_PATH": "/usr/bin/google-chrome"
 }
 ```
-Alternative Linux paths: `/snap/bin/brave`, `/usr/bin/brave`, `/opt/brave.com/brave/brave-browser`
+Alternative Linux paths: `/usr/bin/chromium-browser`, `/snap/bin/chromium`
 
 
 #### Testing Cursor IDE Setup
@@ -478,9 +423,9 @@ If successful, you should see:
    - Ensure Node.js 18+ is installed
 
 2. **"Browser failed to launch" on Windows**
-   - Add explicit Brave path in `BRAVE_PATH` environment variable
+   - Add explicit Chrome path in `executablePath`
    - Try running Cursor IDE as Administrator
-   - Check Windows Defender isn't blocking Brave Browser
+   - Check Windows Defender isn't blocking Chrome
 
 3. **"Permission denied"**
    - Use `sudo npm install -g brave-real-browser-mcp-server` on Linux/Mac
@@ -553,106 +498,48 @@ AI: I'll set up the browser with your proxy configuration.
 
 ## Available Tools
 
-### 🎯 **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` |
+### 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 |
 
 ## Advanced Features
 
@@ -661,7 +548,7 @@ This MCP server provides **62 professional-grade tools** organized into 11 major
 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 Brave DevTools
+- **Smart CSS selector generation**: Creates unique, robust CSS selectors similar to Chrome 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
@@ -699,27 +586,27 @@ brave-real-browser implementation.
 
 ## Configuration
 
-### Automatic Brave Path Detection (Enhanced in v2.9.5)
+### Automatic Chrome Path Detection (Enhanced in v1.3.0)
 
-The server automatically detects Brave Browser installation paths across different operating systems with advanced multi-layer detection:
+The server automatically detects Chrome installation paths across different operating systems with significantly improved Windows support:
 
-- **Windows (v2.9.5+)**: 
-  - Registry-based detection for all installed Brave versions
+- **Windows (v1.3.0+)**: 
+  - Registry-based detection for installed Chrome versions
   - Searches 15+ common installation directories including Program Files, user-specific locations, and portable installations
-  - 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
+  - Support for Chrome Canary fallback
+  - Environment variable detection (`CHROME_PATH`, `PUPPETEER_EXECUTABLE_PATH`)
+  - Detailed troubleshooting guidance when Chrome is not found
   
-- **macOS**: Detects Brave in all Application bundle locations for all variants
+- **macOS**: Looks for Chrome in `/Applications/Google Chrome.app/` and Chrome Canary locations
 
-- **Linux**: Checks multiple locations including package manager installations and manual installs
+- **Linux**: Checks multiple locations including `/usr/bin/google-chrome`, `/usr/bin/chromium-browser`, and snap installations
 
-**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.
+**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.
 
-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)
+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
 
 ### 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:
@@ -746,7 +633,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 Brave browser flags)
+- `ignoreAllFlags`: true/false (Ignore all Chrome flags)
 - `proxy`: "https://proxy:8080" (Proxy server URL)
 - `plugins`: ["plugin1", "plugin2"] (Array of plugins to load)
 - `connectOption`: Additional connection options like:
@@ -775,11 +662,11 @@ When initializing the browser with `browser_init`, you can configure:
 
 ### Advanced Configuration Examples
 
-#### Specifying Custom Brave Path
+#### Specifying Custom Chrome Path
 ```json
 {
   "customConfig": {
-    "chromePath": "C:\\Program Files\\BraveSoftware\\Brave-Browser\\Application\\brave.exe"
+    "chromePath": "C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe"
   }
 }
 ```
@@ -822,14 +709,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 Brave Path Detection:**
-- Added Windows Registry-based Brave detection for all variants
+**Enhanced Chrome Path Detection:**
+- Added Windows Registry-based Chrome detection
 - Expanded search to 15+ Windows installation locations including portable installations
-- Added support for all Brave versions (Stable, Beta, Dev, Nightly)
-- Environment variable support (`BRAVE_PATH`, `CHROME_PATH` for legacy fallback)
+- Added support for Chrome Canary fallback
+- Environment variable support (`CHROME_PATH`, `PUPPETEER_EXECUTABLE_PATH`)
 
 **Windows-Specific Launch Optimizations:**
-- 20+ Windows-specific Brave browser flags for better compatibility
+- 20+ Windows-specific Chrome 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)
@@ -844,12 +731,12 @@ Version 1.3.0 includes comprehensive fixes for the `connect ECONNREFUSED 127.0.0
 
 1. **Environment Variables (Recommended):**
    ```bash
-   set BRAVE_PATH="C:\Program Files\BraveSoftware\Brave-Browser\Application\brave.exe"
+   set CHROME_PATH="C:\Program Files\Google\Chrome\Application\chrome.exe"
    ```
 
-2. **Manual Brave Path Configuration:**
+2. **Manual Chrome Path Configuration:**
    ```text
-   Ask Claude: "Initialize browser with custom Brave path at C:\\Program Files\\BraveSoftware\\Brave-Browser\\Application\\brave.exe"
+   Ask Claude: "Initialize browser with custom Chrome path at C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe"
    ```
 
 3. **Network Troubleshooting:**
@@ -863,10 +750,10 @@ Version 1.3.0 includes comprehensive fixes for the `connect ECONNREFUSED 127.0.0
    # Ensure: 127.0.0.1 localhost
    ```
 
-4. **Brave Process Management:**
+4. **Chrome Process Management:**
    ```bash
-   # Kill existing Brave processes
-   taskkill /f /im brave.exe
+   # Kill existing Chrome processes
+   taskkill /f /im chrome.exe
    ```
 
 ### Common Issues
@@ -925,20 +812,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 Brave Browser is installed in standard locations
+   - Check if Chrome/Chromium is installed in standard locations
    - **Windows specific troubleshooting**:
      
-     **Step 1: Verify Brave Installation Paths**
+     **Step 1: Verify Chrome Installation Paths**
      Check these locations in order:
-     - `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`
+     - `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`
      
      **Step 2: Manual Path Configuration**
-     If Brave is in a different location, specify it manually:
+     If Chrome is in a different location, specify it manually:
      ```
-     Ask Claude: "Initialize browser with custom Brave path at C:\Your\Brave\Path\brave.exe"
+     Ask Claude: "Initialize browser with custom Chrome path at C:\Your\Chrome\Path\chrome.exe"
      ```
      
      **Step 3: Windows Launch Arguments**
@@ -949,15 +836,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 Brave Browser and Node.js to Windows Defender exclusions
-     - **Antivirus Software**: Temporarily disable antivirus to test if it's blocking Brave
+     - **Windows Defender**: Add Chrome and Node.js to Windows Defender exclusions
+     - **Antivirus Software**: Temporarily disable antivirus to test if it's blocking Chrome
      - **User Account Control**: Lower UAC settings temporarily for testing
-     - **Brave Processes**: Kill any existing Brave processes in Task Manager
+     - **Chrome Processes**: Kill any existing Chrome processes in Task Manager
      
-     **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\`)
+     **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\`)
      - Restart your IDE after installation
      
      **Step 6: PowerShell vs Command Prompt**
@@ -970,10 +857,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 Brave: `sudo apt install brave-browser` or from [brave.com](https://brave.com/)
-   - **macOS**: Ensure Brave is in `/Applications/Brave Browser.app/`
+   - **Linux**: Install dependencies: `sudo apt-get install -y google-chrome-stable`
+   - **macOS**: Ensure Chrome is in `/Applications/`
    - Try with `headless: true` first
-   - Check console output for Brave path detection messages
+   - Check console output for Chrome path detection messages
 
 4. **Claude doesn't see the MCP server**
    - Verify `claude_desktop_config.json` is in the correct location
@@ -999,7 +886,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 (Brave path, proxy), verify they're correctly set
+     - If using custom environment variables (Chrome 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**:
@@ -1122,11 +1009,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 Brave extensions?**
-A: Yes, through the `plugins` option in browser_init. Brave extensions and Chrome extensions are compatible.
+**Q: Can I use custom Chrome extensions?**
+A: Yes, through the `plugins` option in browser_init.
 
 **Q: Does it work on all operating systems?**
-A: Yes, tested on Windows, macOS, and Linux. The server automatically detects Brave Browser installations on all platforms with advanced multi-layer detection.
+A: Yes, tested on Windows, macOS, and Linux. The server automatically detects Chrome installations on all platforms.
 
 **Q: What's the difference between Claude Desktop, Claude Code CLI, and Cursor IDE configurations?**
 A: Here's a comparison:
@@ -1147,30 +1034,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 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
+**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
 - Registry-detected installations
 
-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.
+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.
 
-**Q: I'm still getting ECONNREFUSED errors after upgrading to v2.9.5. What should I do?**
+**Q: I'm still getting ECONNREFUSED errors after upgrading to v1.3.0. What should I do?**
 A: Try these steps in order:
-1. Set the `BRAVE_PATH` environment variable to your Brave location
-2. Kill all existing Brave processes: `taskkill /f /im brave.exe`
+1. Set the `CHROME_PATH` environment variable to your Chrome location
+2. Kill all existing Chrome processes: `taskkill /f /im chrome.exe`
 3. Check your Windows hosts file contains: `127.0.0.1 localhost`
 4. Try running your IDE as Administrator
-5. Add Brave Browser to Windows Defender exclusions
+5. Add Chrome to Windows Defender exclusions
 6. If using a VPN/proxy, try disabling it temporarily
 
 ### Debug Mode
@@ -1269,7 +1156,7 @@ npm run test:debug    # Environment diagnostics and troubleshooting
 
 Debug tools provide:
 - Environment validation (Node.js version, platform, memory)
-- Brave Browser installation detection with specific paths
+- Chrome installation detection with specific paths
 - Quick server health check with startup timing
 - Network connectivity validation
 - Build status verification
@@ -1311,22 +1198,9 @@ This project is licensed under the MIT License - see the LICENSE file for detail
 
 ## Acknowledgments
 
-### 🦁 **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
+This MCP server is based on the excellent [brave-real-browser](https://github.com/ZFC-Digital/brave-real-browser) library by ZFC-Digital.
 
 **Thank you** to the brave-real-browser team for creating such a powerful and detection-resistant browser automation solution!
 
-**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
+- 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)