brave-real-browser-mcp-server 2.15.4 → 2.15.6

package/README.md

@@ -4,15 +4,15 @@
 
 <div align="center">
 
-![Version](https://img.shields.io/badge/version-2.14.0-blue.svg)
+![Version](https://img.shields.io/badge/version-2.15.4-blue.svg)
 ![Node](https://img.shields.io/badge/node-%3E%3D18.0.0-green.svg)
-![Tools](https://img.shields.io/badge/tools-78-purple.svg)
+![Tools](https://img.shields.io/badge/tools-66-purple.svg)
 ![IDEs](https://img.shields.io/badge/AI_IDEs-15+-orange.svg)
 ![License](https://img.shields.io/badge/license-MIT-red.svg)
 
-**सभी AI IDEs के लिए Universal MCP Server | 78+ Tools | Browser Automation | Web Scraping | CAPTCHA Solving**
+**सभी AI IDEs के लिए Universal MCP Server | 66+ Tools | Browser Automation | Web Scraping | CAPTCHA Solving**
 
-[Installation](#-installation) | [Quick Start](#-quick-start) | [Qoder AI Setup](#-qoder-ai---complete-integration-guide) | [Tools](#-available-tools-78) | [IDE Configurations](#-ide-configurations)
+[Installation](#-installation) | [Quick Start](#-quick-start) | [Qoder AI Setup](#-qoder-ai---complete-integration-guide) | [Tools](#-available-tools-66) | [IDE Configurations](#-ide-configurations)
 
 </div>
 
@@ -23,7 +23,7 @@
 **Brave Real Browser MCP Server** एक powerful automation tool है जो:
 
 - ✅ **20+ AI IDEs में काम करता है** (Antigravity, Warp AI, Zed, Cursor, Claude, Windsurf, Cline, Qoder AI, etc.)
-- ✅ **78+ Automation Tools** - Browser control, scraping, CAPTCHA solving, video extraction
+- ✅ **66+ Automation Tools** - Browser control, scraping, CAPTCHA solving, video extraction
 - ✅ **MCP Protocol (STDIO)** - Fast and secure local communication
 - ✅ **Auto-Detection** - Automatically detects your IDE
 - ✅ **Real Brave Browser** - Anti-detection features, bypass Cloudflare
@@ -146,10 +146,11 @@ npm install -g brave-real-browser-mcp-server@latest
 
 ```json
 {
-  "mcp_servers": {
+  "context_servers": {
     "brave-real-browser": {
-      "command": "npx",
-      "args": ["-y", "brave-real-browser-mcp-server@latest"]
+      "command": "npx.cmd",
+      "args": ["-y", "brave-real-browser-mcp-server@latest"],
+      "env": {}
     }
   }
 }
@@ -189,7 +190,7 @@ npm install -g brave-real-browser-mcp-server@latest
 
 ---
 
-## 🛠️ Available Tools (78)
+## 🛠️ Available Tools (66)
 
 ### 🌐 Browser Management (2 tools)
 
@@ -214,14 +215,13 @@ npm install -g brave-real-browser-mcp-server@latest
 | `random_scroll` | Human-like scrolling                                 |
 | `solve_captcha` | Solve CAPTCHA (reCAPTCHA, hCaptcha, Turnstile, etc.) |
 
-### 📄 Content Extraction (10 tools)
+### 📄 Content Extraction (9 tools)
 
 | Tool                       | Description                               |
 | -------------------------- | ----------------------------------------- |
 | `get_content`              | Extract page content (HTML/Text/Markdown) |
 | `find_selector`            | Find CSS selectors for elements           |
 | `scrape_table`             | Extract table data with headers           |
-| `extract_list`             | Extract list items                        |
 | `extract_json`             | Extract JSON data from page               |
 | `scrape_meta_tags`         | Extract meta tags and SEO info            |
 | `extract_schema`           | Extract schema.org structured data        |
@@ -284,7 +284,7 @@ npm install -g brave-real-browser-mcp-server@latest
 | `audio_captcha_solver`   | Solve audio CAPTCHAs                                                |
 | `puzzle_captcha_handler` | Handle puzzle CAPTCHAs                                              |
 
-### 🔧 Data Processing (9 tools)
+### 🔧 Data Processing (5 tools)
 
 | Tool                      | Description                        |
 | ------------------------- | ---------------------------------- |
@@ -293,28 +293,17 @@ npm install -g brave-real-browser-mcp-server@latest
 | `contact_extractor`       | Extract contact information        |
 | `schema_validator`        | Validate data against schema       |
 | `required_fields_checker` | Check for required fields          |
-| `duplicate_remover`       | Remove duplicate entries           |
-| `data_deduplication`      | Advanced deduplication             |
-| `missing_data_handler`    | Handle missing data                |
-| `data_type_validator`     | Validate data types                |
 
-### 📊 Data Quality (3 tools)
+### 📊 Data Quality (0 tools)
 
-| Tool                   | Description              |
-| ---------------------- | ------------------------ |
-| `outlier_detection`    | Detect data outliers     |
-| `consistency_checker`  | Check data consistency   |
-| `data_quality_metrics` | Generate quality metrics |
+*Advanced data quality tools removed for optimization.*
 
-### 🤖 AI-Powered Tools (5 tools)
+### 🤖 AI-Powered Tools (2 tools)
 
 | Tool                       | Description                 |
 | -------------------------- | --------------------------- |
 | `smart_selector_generator` | Auto-generate CSS selectors |
 | `content_classification`   | Classify content type       |
-| `sentiment_analysis`       | Analyze text sentiment      |
-| `summary_generator`        | Generate content summaries  |
-| `translation_support`      | Translate content           |
 
 ### 🔎 Search & Filter (5 tools)
 
@@ -336,11 +325,10 @@ npm install -g brave-real-browser-mcp-server@latest
 | `sitemap_parser`       | Parse and navigate sitemaps |
 | `breadcrumb_navigator` | Navigate using breadcrumbs  |
 
-### 🔒 Session Management (7 tools)
+### 🔒 Session Management (6 tools)
 
 | Tool                    | Description                |
 | ----------------------- | -------------------------- |
-| `cookie_manager`        | Manage cookies             |
 | `session_persistence`   | Persist sessions           |
 | `form_auto_fill`        | Auto-fill forms            |
 | `ajax_content_waiter`   | Wait for AJAX content      |
@@ -348,25 +336,21 @@ npm install -g brave-real-browser-mcp-server@latest
 | `login_session_manager` | Manage login sessions      |
 | `shadow_dom_extractor`  | Extract Shadow DOM content |
 
-### 📸 Visual Tools (5 tools)
+### 📸 Visual Tools (4 tools)
 
 | Tool                   | Description                 |
 | ---------------------- | --------------------------- |
-| `full_page_screenshot` | Full page screenshot        |
 | `element_screenshot`   | Screenshot specific element |
 | `pdf_generation`       | Generate PDF from page      |
 | `video_recording`      | Record page as video        |
-| `visual_comparison`    | Compare screenshots         |
 
-### 📈 Monitoring & Reporting (6 tools)
+### 📈 Monitoring & Reporting (3 tools)
 
 | Tool                    | Description               |
 | ----------------------- | ------------------------- |
 | `progress_tracker`      | Track automation progress |
 | `success_rate_reporter` | Report success rates      |
-| `data_quality_metrics`  | Data quality metrics      |
 | `performance_monitor`   | Monitor performance       |
-| `monitoring_summary`    | Get monitoring summary    |
 
 ### 🛡️ Advanced Extraction & Obfuscation (4 tools)
 
@@ -376,11 +360,8 @@ npm install -g brave-real-browser-mcp-server@latest
 | `multi_layer_redirect_trace` | Trace multi-layer redirects |
 | `ad_protection_detector`     | Detect ad protection        |
 
-
 ## 🔧 Environment Variables
 
-
-
 You can configure the server using the local `.env` file directly.
 
 Edit `.env` to set your preferences:
@@ -401,9 +382,9 @@ PROXY_URL=http://localhost:8080
 
 ## 📊 Supported Protocols
 
-|| Protocol        | Used By                                       | Auto-Config | Status     |
-|| --------------- | --------------------------------------------- | ----------- | ---------- |
-|| **MCP (STDIO)** | Claude Desktop, Cursor, Windsurf, Cline, Warp | ✅          | 🟢 Working |
+| Protocol        | Used By                                       | Auto-Config | Status     |
+| --------------- | --------------------------------------------- | ----------- | ---------- |
+| **MCP (STDIO)** | Claude Desktop, Cursor, Windsurf, Cline, Warp | ✅          | 🟢 Working |
 
 ## 📄 License
 

package/dist/handlers/data-extraction-handlers.js

@@ -5,82 +5,6 @@
 import { getCurrentPage } from '../browser-manager.js';
 import { validateWorkflow } from '../workflow-validation.js';
 import { withErrorHandling } from '../system-utils.js';
-/**
- * Bullet lists और numbered lists से data extract करता है
- */
-export async function handleExtractList(args) {
-    return await withErrorHandling(async () => {
-        validateWorkflow('extract_list', {
-            requireBrowser: true,
-            requirePage: true,
-        });
-        const page = getCurrentPage();
-        const selector = args.selector || 'ul, ol';
-        const includeNested = args.includeNested !== false;
-        const maxItems = args.maxItems || 500;
-        const listData = await page.evaluate(({ selector, includeNested, maxItems }) => {
-            const lists = document.querySelectorAll(selector);
-            const results = [];
-            lists.forEach((list) => {
-                const items = [];
-                const listType = list.tagName.toLowerCase();
-                let hasNested = false;
-                const extractItems = (element, depth = 0) => {
-                    if (items.length >= maxItems)
-                        return;
-                    const children = Array.from(element.children);
-                    children.forEach((child) => {
-                        if (child.tagName.toLowerCase() === 'li') {
-                            const text = Array.from(child.childNodes)
-                                .filter((node) => node.nodeType === Node.TEXT_NODE)
-                                .map((node) => node.textContent?.trim())
-                                .filter((text) => text)
-                                .join(' ');
-                            if (text) {
-                                const indent = '  '.repeat(depth);
-                                items.push(`${indent}${text}`);
-                            }
-                            // Check for nested lists
-                            const nestedList = child.querySelector('ul, ol');
-                            if (nestedList && includeNested) {
-                                hasNested = true;
-                                extractItems(nestedList, depth + 1);
-                            }
-                        }
-                    });
-                };
-                extractItems(list);
-                if (items.length > 0) {
-                    results.push({
-                        items,
-                        type: listType,
-                        nested: hasNested,
-                        count: items.length,
-                    });
-                }
-            });
-            return results;
-        }, { selector, includeNested, maxItems });
-        if (listData.length === 0) {
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: `❌ No lists found with selector "${selector}"`,
-                    },
-                ],
-            };
-        }
-        return {
-            content: [
-                {
-                    type: 'text',
-                    text: `✅ Extracted ${listData.length} list(s)\n\n${JSON.stringify(listData, null, 2)}`,
-                },
-            ],
-        };
-    }, 'Failed to extract list');
-}
 /**
  * Page में embedded JSON/API data खोजता और extract करता है
  */

package/dist/handlers/data-quality-handlers.js

@@ -1,76 +1,9 @@
 // @ts-nocheck
 import Ajv from 'ajv/dist/2020.js';
-import * as crypto from 'crypto';
 const ajv = new Ajv();
 /**
  * Data Deduplication - Remove duplicate entries from scraped data
  */
-export async function handleDataDeduplication(args) {
-    const { data, uniqueKeys, fuzzyMatch = false, threshold = 0.9 } = args;
-    try {
-        if (!Array.isArray(data)) {
-            throw new Error('Data must be an array');
-        }
-        const unique = [];
-        const duplicates = [];
-        const seen = new Set();
-        data.forEach((item, index) => {
-            let key;
-            if (uniqueKeys && Array.isArray(uniqueKeys)) {
-                // Create composite key from specified fields
-                const keyParts = uniqueKeys.map(k => {
-                    const value = typeof item === 'object' ? item[k] : item;
-                    return String(value || '');
-                });
-                key = keyParts.join('|');
-            }
-            else {
-                // Use entire object as key
-                key = JSON.stringify(item);
-            }
-            if (fuzzyMatch) {
-                // Normalize key for fuzzy matching
-                key = key.toLowerCase().replace(/\s+/g, ' ').trim();
-            }
-            const hash = crypto.createHash('md5').update(key).digest('hex');
-            if (seen.has(hash)) {
-                duplicates.push({ item, index, hash });
-            }
-            else {
-                seen.add(hash);
-                unique.push(item);
-            }
-        });
-        const dedupRate = ((duplicates.length / data.length) * 100).toFixed(2);
-        let summary = `Data Deduplication Results:\n\nStatistics:\n- Original Items: ${data.length}\n- Unique Items: ${unique.length}\n- Duplicates Found: ${duplicates.length}\n- Deduplication Rate: ${dedupRate}%`;
-        if (uniqueKeys) {
-            summary += `\n- Unique Keys Used: ${uniqueKeys.join(', ')}`;
-        }
-        summary += `\n- Fuzzy Matching: ${fuzzyMatch ? 'Enabled' : 'Disabled'}`;
-        if (duplicates.length > 0) {
-            summary += `\n\nSample Duplicates (Top 5):\n${duplicates.slice(0, 5).map((d, i) => `${i + 1}. Index ${d.index}: ${JSON.stringify(d.item).substring(0, 100)}...`).join('\n')}`;
-        }
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: summary
-                }
-            ]
-        };
-    }
-    catch (error) {
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: `Data Deduplication Error: ${error.message}`
-                }
-            ],
-            isError: true
-        };
-    }
-}
 /**
  * Missing Data Handler - Detect and handle missing data
  */
@@ -147,77 +80,3 @@ export async function handleDataTypeValidator(args) {
 /**
  * Consistency Checker - Check data consistency across fields
  */
-export async function handleConsistencyChecker(args) {
-    const { data, rules } = args;
-    try {
-        if (!Array.isArray(data)) {
-            throw new Error('Data must be an array');
-        }
-        if (!rules || !Array.isArray(rules)) {
-            if (!rules)
-                return { content: [{ type: "text", text: "No rules provided. Pass." }] };
-            throw new Error('Rules must be an array');
-        }
-        const report = {
-            totalItems: data.length,
-            passedItems: 0,
-            failedItems: 0,
-            failures: []
-        };
-        data.forEach((item, index) => {
-            let itemPassed = true;
-            const itemFailures = [];
-            rules.forEach((rule) => {
-                try {
-                    if (rule.type === 'dependency') {
-                        if (item[rule.field] && !item[rule.dependentField]) {
-                            itemPassed = false;
-                            itemFailures.push(`Field '${rule.field}' requires '${rule.dependentField}'`);
-                        }
-                    }
-                    else if (rule.type === 'value_match') {
-                        if (item[rule.field] === rule.value && item[rule.targetField] !== rule.targetValue) {
-                            itemPassed = false;
-                            itemFailures.push(`When '${rule.field}' is '${rule.value}', '${rule.targetField}' must be '${rule.targetValue}'`);
-                        }
-                    }
-                }
-                catch (e) {
-                    itemPassed = false;
-                    // @ts-ignore
-                    itemFailures.push(`Rule execution error: ${e.message}`);
-                }
-            });
-            if (itemPassed) {
-                report.passedItems++;
-            }
-            else {
-                report.failedItems++;
-                report.failures.push({
-                    index,
-                    item,
-                    errors: itemFailures
-                });
-            }
-        });
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: `Consistency Check Results:\nTotal: ${report.totalItems}\nPassed: ${report.passedItems}\nFailed: ${report.failedItems}\n\nFailures:\n${JSON.stringify(report.failures, null, 2)}`
-                }
-            ]
-        };
-    }
-    catch (error) {
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: `Consistency Checker Error: ${error.message}`
-                }
-            ],
-            isError: true
-        };
-    }
-}

package/dist/handlers/dynamic-session-handlers.js

@@ -49,81 +49,6 @@ export async function handleShadowDOMExtractor(args) {
 /**
  * Cookie Manager - Manage cookies
  */
-export async function handleCookieManager(args) {
-    return await withErrorHandling(async () => {
-        validateWorkflow('cookie_manager', {
-            requireBrowser: true,
-            requirePage: true,
-        });
-        const page = getCurrentPage();
-        const action = args.action || 'get'; // get, set, delete, clear
-        if (action === 'get') {
-            const cookies = await page.cookies();
-            return {
-                content: [{
-                        type: 'text',
-                        text: `✅ Retrieved ${cookies.length} cookies\n\n${JSON.stringify(cookies, null, 2)}`,
-                    }],
-            };
-        }
-        if (action === 'set') {
-            const cookie = args.cookie;
-            if (!cookie || !cookie.name || !cookie.value) {
-                throw new Error('Cookie name and value are required');
-            }
-            await page.setCookie({
-                name: cookie.name,
-                value: cookie.value,
-                domain: cookie.domain || new URL(page.url()).hostname,
-                path: cookie.path || '/',
-                expires: cookie.expires,
-                httpOnly: cookie.httpOnly || false,
-                secure: cookie.secure || false,
-                sameSite: cookie.sameSite || 'Lax',
-            });
-            return {
-                content: [{
-                        type: 'text',
-                        text: `✅ Cookie set: ${cookie.name} = ${cookie.value}`,
-                    }],
-            };
-        }
-        if (action === 'delete') {
-            const cookieName = args.cookieName;
-            if (!cookieName) {
-                throw new Error('Cookie name is required');
-            }
-            const cookies = await page.cookies();
-            const cookieToDelete = cookies.find(c => c.name === cookieName);
-            if (cookieToDelete) {
-                await page.deleteCookie(cookieToDelete);
-                return {
-                    content: [{
-                            type: 'text',
-                            text: `✅ Cookie deleted: ${cookieName}`,
-                        }],
-                };
-            }
-            return {
-                content: [{
-                        type: 'text',
-                        text: `⚠️ Cookie not found: ${cookieName}`,
-                    }],
-            };
-        }
-        if (action === 'clear') {
-            const cookies = await page.cookies();
-            await Promise.all(cookies.map(cookie => page.deleteCookie(cookie)));
-            return {
-                content: [{
-                        type: 'text',
-                        text: `✅ Cleared all ${cookies.length} cookies`,
-                    }],
-            };
-        }
-        throw new Error(`Unknown action: ${action}`);
-    }, 'Failed to manage cookies');
-}
 /**
  * Session Persistence - Save and restore browser session
  */

package/dist/handlers/monitoring-reporting-handlers.js

@@ -1,8 +1,6 @@
 // Monitoring & Reporting Module
 // Progress tracking, error logging, success rate reporting, metrics
 // @ts-nocheck
-import { getCurrentPage } from '../browser-manager.js';
-import { validateWorkflow } from '../workflow-validation.js';
 import { withErrorHandling } from '../system-utils.js';
 // Global monitoring state
 const monitoringState = {
@@ -116,87 +114,6 @@ export async function handleProgressTracker(args) {
 /**
  * Data Quality Metrics - Report data quality metrics
  */
-export async function handleDataQualityMetrics(args) {
-    return await withErrorHandling(async () => {
-        validateWorkflow('data_quality_metrics', {
-            requireBrowser: true,
-            requirePage: true,
-        });
-        const page = getCurrentPage();
-        const data = args.data || [];
-        // Calculate metrics
-        const metrics = {
-            totalRecords: data.length,
-            completeRecords: 0,
-            incompleteRecords: 0,
-            emptyFields: 0,
-            duplicates: 0,
-            dataTypes: {},
-            fieldCompleteness: {},
-        };
-        if (data.length === 0) {
-            return {
-                content: [{
-                        type: 'text',
-                        text: `ℹ️ No data provided for quality metrics`,
-                    }],
-            };
-        }
-        // Analyze data quality
-        const seenRecords = new Set();
-        const allFields = new Set();
-        data.forEach((record) => {
-            const recordStr = JSON.stringify(record);
-            // Check for duplicates
-            if (seenRecords.has(recordStr)) {
-                metrics.duplicates++;
-            }
-            else {
-                seenRecords.add(recordStr);
-            }
-            // Collect all fields
-            Object.keys(record).forEach(key => allFields.add(key));
-            // Check completeness
-            let hasAllFields = true;
-            Object.values(record).forEach(value => {
-                if (value === null || value === undefined || value === '') {
-                    metrics.emptyFields++;
-                    hasAllFields = false;
-                }
-            });
-            if (hasAllFields) {
-                metrics.completeRecords++;
-            }
-            else {
-                metrics.incompleteRecords++;
-            }
-        });
-        // Field completeness
-        allFields.forEach(field => {
-            const nonEmptyCount = data.filter((record) => {
-                const value = record[field];
-                return value !== null && value !== undefined && value !== '';
-            }).length;
-            metrics.fieldCompleteness[field] = ((nonEmptyCount / data.length) * 100).toFixed(2) + '%';
-        });
-        // Data type analysis
-        allFields.forEach(field => {
-            const types = new Set();
-            data.forEach((record) => {
-                const value = record[field];
-                types.add(typeof value);
-            });
-            metrics.dataTypes[field] = Array.from(types).join(', ');
-        });
-        const qualityScore = ((metrics.completeRecords / metrics.totalRecords) * 100).toFixed(2);
-        return {
-            content: [{
-                    type: 'text',
-                    text: `✅ Data Quality Metrics\n\nTotal Records: ${metrics.totalRecords}\nComplete Records: ${metrics.completeRecords}\nIncomplete Records: ${metrics.incompleteRecords}\nDuplicates: ${metrics.duplicates}\nEmpty Fields: ${metrics.emptyFields}\n\nQuality Score: ${qualityScore}%\n\nField Completeness:\n${JSON.stringify(metrics.fieldCompleteness, null, 2)}\n\nData Types:\n${JSON.stringify(metrics.dataTypes, null, 2)}`,
-                }],
-        };
-    }, 'Failed data quality metrics');
-}
 /**
  * Performance Monitor - Monitor browser and page performance
  */

package/dist/handlers/multi-element-handlers.js

@@ -67,73 +67,6 @@ export async function handleBatchElementScraper(args) {
         };
     }, 'Failed to batch scrape elements');
 }
-/**
- * Parent-child relationships maintain करते हुए data निकालता है
- */
-export async function handleNestedDataExtraction(args) {
-    return await withErrorHandling(async () => {
-        validateWorkflow('nested_data_extraction', {
-            requireBrowser: true,
-            requirePage: true,
-        });
-        const page = getCurrentPage();
-        const parentSelector = args.parentSelector;
-        const childSelector = args.childSelector;
-        const maxParents = args.maxParents || 50;
-        const nestedData = await page.evaluate(({ parentSelector, childSelector, maxParents }) => {
-            const parents = document.querySelectorAll(parentSelector);
-            const results = [];
-            let count = 0;
-            parents.forEach((parent) => {
-                if (count >= maxParents)
-                    return;
-                const parentData = {
-                    selector: parentSelector,
-                    text: Array.from(parent.childNodes)
-                        .filter((node) => node.nodeType === Node.TEXT_NODE)
-                        .map((node) => node.textContent?.trim())
-                        .filter((text) => text)
-                        .join(' '),
-                    attributes: {},
-                };
-                // Get parent attributes
-                Array.from(parent.attributes).forEach((attr) => {
-                    parentData.attributes[attr.name] = attr.value;
-                });
-                // Get children
-                const children = parent.querySelectorAll(childSelector);
-                const childrenData = [];
-                children.forEach((child) => {
-                    const childData = {
-                        selector: childSelector,
-                        text: child.textContent?.trim() || '',
-                        attributes: {},
-                    };
-                    Array.from(child.attributes).forEach((attr) => {
-                        childData.attributes[attr.name] = attr.value;
-                    });
-                    childrenData.push(childData);
-                });
-                if (childrenData.length > 0) {
-                    results.push({
-                        parent: parentData,
-                        children: childrenData,
-                    });
-                    count++;
-                }
-            });
-            return results;
-        }, { parentSelector, childSelector, maxParents });
-        return {
-            content: [
-                {
-                    type: 'text',
-                    text: `✅ Extracted ${nestedData.length} parent-child relationships\n\n${JSON.stringify(nestedData, null, 2)}`,
-                },
-            ],
-        };
-    }, 'Failed to extract nested data');
-}
 /**
  * सभी elements के attributes (href, src, data-*) collect करता है
  */