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

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 Brave detection and ECONNREFUSED error fixes
+- **Smart Brave detection**: Registry-based detection + 13+ 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,64 @@ 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
+- Brave Browser 13+ 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:**
+- Brave Browser installation (automatic detection includes):
+  - Standard installations: `C:\Program Files\BraveSoftware\Brave-Browser\Application\brave.exe`
+  - 32-bit installations: `C:\Program Files (x86)\BraveSoftware\Brave-Browser\Application\brave.exe`
+  - User installations: `%LOCALAPPDATA%\BraveSoftware\Brave-Browser\Application\brave.exe`
+  - Portable installations and Registry-detected paths
+  - Manual path specification: Use `BRAVE_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`
+- Brave Browser must be installed in `/Applications/Brave Browser.app`
 
 **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 Brave: `sudo apt install brave-browser` or via snap: `sudo snap install brave`
 - 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
 
@@ -453,7 +397,7 @@ Alternative Windows paths:
   "BRAVE_PATH": "/usr/bin/brave-browser"
 }
 ```
-Alternative Linux paths: `/snap/bin/brave`, `/usr/bin/brave`, `/opt/brave.com/brave/brave-browser`
+Alternative Linux paths: `/usr/bin/brave`, `/snap/bin/brave`
 
 
 #### Testing Cursor IDE Setup
@@ -478,9 +422,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 Brave path in `executablePath`
    - Try running Cursor IDE as Administrator
-   - Check Windows Defender isn't blocking Brave Browser
+   - Check Windows Defender isn't blocking Brave
 
 3. **"Permission denied"**
    - Use `sudo npm install -g brave-real-browser-mcp-server` on Linux/Mac
@@ -553,106 +497,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 +547,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 browser 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 +585,27 @@ brave-real-browser implementation.
 
 ## Configuration
 
-### Automatic Brave Path Detection (Enhanced in v2.9.5)
+### Automatic Brave Path Detection
 
-The server automatically detects Brave Browser installation paths across different operating systems with advanced multi-layer detection:
+The server automatically detects Brave Browser installation paths across different operating systems:
 
-- **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 all Brave variants (Stable, Beta, Dev, Nightly)
-  - Environment variable detection (`BRAVE_PATH`, `CHROME_PATH` for fallback)
+- **Windows**: 
+  - Registry-based detection for installed Brave versions
+  - Searches 13+ common installation directories including Program Files, user-specific locations, and portable installations
+  - Support for Brave Nightly fallback
+  - Environment variable detection (`BRAVE_PATH`)
   - Detailed troubleshooting guidance when Brave is not found
   
-- **macOS**: Detects Brave in all Application bundle locations for all variants
+- **macOS**: Looks for Brave in `/Applications/Brave Browser.app/` and Brave Nightly locations
 
-- **Linux**: Checks multiple locations including package manager installations and manual installs
+- **Linux**: Checks multiple locations including `/usr/bin/brave-browser`, `/usr/bin/brave`, 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**:
+The server queries Windows Registry to find Brave 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)
+2. Browser init option: `customConfig.bravePath` 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 +632,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 browser flags)
 - `proxy`: "https://proxy:8080" (Proxy server URL)
 - `plugins`: ["plugin1", "plugin2"] (Array of plugins to load)
 - `connectOption`: Additional connection options like:
@@ -779,7 +665,7 @@ When initializing the browser with `browser_init`, you can configure:
 ```json
 {
   "customConfig": {
-    "chromePath": "C:\\Program Files\\BraveSoftware\\Brave-Browser\\Application\\brave.exe"
+    "bravePath": "C:\\Program Files\\BraveSoftware\\Brave-Browser\\Application\\brave.exe"
   }
 }
 ```
@@ -823,13 +709,13 @@ 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
-- 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 Windows Registry-based Brave detection
+- Expanded search to 13+ Windows installation locations including portable installations
+- Added support for Brave Nightly fallback
+- Environment variable support (`BRAVE_PATH`)
 
 **Windows-Specific Launch Optimizations:**
-- 20+ Windows-specific Brave browser flags for better compatibility
+- 20+ Windows-specific 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)
@@ -949,7 +835,7 @@ 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
+     - **Windows Defender**: Add Brave 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
      - **Brave Processes**: Kill any existing Brave processes in Task Manager
@@ -970,8 +856,8 @@ 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 Brave: `sudo apt install brave-browser`
+   - **macOS**: Ensure Brave is in `/Applications/Brave Browser.app`
    - Try with `headless: true` first
    - Check console output for Brave path detection messages
 
@@ -1030,7 +916,7 @@ Version 1.3.0 includes comprehensive fixes for the `connect ECONNREFUSED 127.0.0
    - **JSON Syntax Validation**:
      - Use [jsonlint.com](https://jsonlint.com/) to validate JSON syntax
      - Common issues: missing commas, incorrect quotes, trailing commas
-     - Ensure proper escaping of Windows paths: `"C:/Program Files/Google/Chrome/Application/chrome.exe"`
+     - Ensure proper escaping of Windows paths: `"C:/Program Files/BraveSoftware/Brave-Browser/Application/brave.exe"`
    
    - **Cursor IDE Restart Process**:
      - Close Cursor IDE completely (check Task Manager on Windows)
@@ -1122,11 +1008,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 browser 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 Brave installations on all platforms.
 
 **Q: What's the difference between Claude Desktop, Claude Code CLI, and Cursor IDE configurations?**
 A: Here's a comparison:
@@ -1148,29 +1034,29 @@ A: Here's a comparison:
 - **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:
+A: The server dramatically improves Brave detection by searching 13+ locations including portable installations and using Windows Registry detection. 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"}}`
+2. Use the `customConfig.bravePath` option: `{"customConfig": {"bravePath": "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:
+A: The server 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
+- Brave 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 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 browser 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. 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`
 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 Brave to Windows Defender exclusions
 6. If using a VPN/proxy, try disabling it temporarily
 
 ### Debug Mode
@@ -1269,7 +1155,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
+- Brave installation detection with specific paths
 - Quick server health check with startup timing
 - Network connectivity validation
 - Build status verification
@@ -1311,22 +1197,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)