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

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": {
+        "CHROME_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/`
@@ -122,7 +136,7 @@ assistants to control a real browser, extract content, and more.
 - **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
@@ -528,48 +542,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
 

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.6",
   "description": "MCP server for brave-real-browser",
   "type": "module",
   "main": "dist/index.js",
@@ -34,13 +34,14 @@
   },
   "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-playwright-core": "^1.56.0",
+    "brave-real-puppeteer-core": "^24.24.0",
     "cheerio": "^1.0.0-rc.12",
     "chrono-node": "^2.7.0",
     "compromise": "^14.13.0",