brave-real-browser-mcp-server 2.37.1 → 2.37.2

package/README.md

@@ -153,43 +153,6 @@ npm run lsp
 | **Simulation** | Workflow simulation in IDE |
 | **Multi-language** | English & Hindi support |
 
-### VS Code Setup
-
-Create `.vscode/settings.json` in your project:
-
-```json
-{
-  "braveRealBrowser.language": "en",
-  "braveRealBrowser.maxDiagnostics": 100,
-  "braveRealBrowser.enableSnippets": true,
-  "braveRealBrowser.enableSimulation": true,
-  "braveRealBrowser.enableRefactoring": true
-}
-```
-
-### Diagnostic Features
-
-The LSP detects common issues:
-
-- Missing `browser_init()` before page operations
-- Missing `navigate()` before content extraction
-- Invalid selectors and URLs
-- Missing required parameters
-- Unclosed browser sessions
-- Security issues (eval usage, etc.)
-
-### Quick Fixes
-
-When diagnostics are detected, quick fixes are offered:
-
-- Add `browser_init()` at start
-- Add `navigate()` before page tools
-- Add `browser_close()` at end
-- Wrap in try-catch
-- Extract to function
-
----
-
 ## AI Core (Automatic Enhancement)
 
 All 28 tools are automatically enhanced with AI capabilities. No configuration needed - AI features work transparently.
@@ -252,17 +215,6 @@ When AI heals a broken selector:
   }
 }
 ```
-
-### AI Modules
-
-| Module | Description |
-|--------|-------------|
-| `AICore` | Central AI intelligence singleton |
-| `ElementFinder` | Smart element finding with multiple strategies |
-| `SelectorHealer` | Auto-fix broken CSS selectors |
-| `PageAnalyzer` | Page structure analysis |
-| `ActionParser` | Natural language command parsing |
-
 ### Programmatic Access
 
 For advanced usage, you can access AI features directly:
@@ -318,21 +270,6 @@ node src/index.js lsp
 # Show help
 node src/index.js --help
 ```
-
-### Tool Categories
-
-| Category | Tools | Description |
-|----------|-------|-------------|
-| **Browser** | 3 | Browser lifecycle (init, close, cookies) |
-| **Navigation** | 1 | Page navigation |
-| **Interaction** | 8 | User actions (click, type, scroll, etc.) |
-| **Extraction** | 10 | Content scraping (HTML, JSON, links, etc.) |
-| **Network** | 3 | Network operations (recorder, download, trace) |
-| **Analysis** | 1 | Page analysis (SEO, performance, etc.) |
-| **Utility** | 2 | Helpers (wait, progress tracker) |
-
----
-
 ## Monorepo Ecosystem
 
 ```
@@ -399,53 +336,6 @@ All packages published to NPM automatically
 ```bash
 npm install brave-real-browser-mcp-server
 ```
-
-For Linux (required for headless mode):
-```bash
-sudo apt-get install xvfb
-```
-
----
-
-## Quick Start
-
-### CommonJS
-
-```javascript
-const { connect } = require('brave-real-browser-mcp-server');
-
-(async () => {
-  const { browser, page, blocker } = await connect({
-    headless: false,
-    turnstile: true,  // Auto-solve Cloudflare
-  });
-
-  await page.goto('https://example.com');
-
-  // Human-like click with ghost-cursor
-  await page.realClick('#button');
-
-  await browser.close();
-})();
-```
-
-### ESM
-
-```javascript
-import { connect } from 'brave-real-browser-mcp-server';
-
-const { browser, page, blocker } = await connect({
-  headless: false,
-  turnstile: true,
-});
-
-await page.goto('https://example.com');
-await page.realClick('#button');
-await browser.close();
-```
-
----
-
 ## Connect Options
 
 | Option | Type | Default | Description |
@@ -500,104 +390,6 @@ const { browser, page } = await connect({
 });
 ```
 
-### Custom Brave Path
-
-```javascript
-const { browser, page } = await connect({
-  customConfig: {
-    bravePath: 'C:\\Program Files\\BraveSoftware\\Brave-Browser\\Application\\brave.exe',
-    userDataDir: './my-profile'
-  }
-});
-```
-
-### Disable Blocker
-
-```javascript
-const { browser, page } = await connect({
-  enableBlocker: false,  // Disable all blocking
-});
-```
-
-### Custom Blocker Options
-
-```javascript
-const { browser, page, blocker } = await connect({
-  blockerOptions: {
-    enableAdBlocking: true,
-    enableStealth: true,
-    enableCosmeticFiltering: true,
-    enableRedirectBlocking: true,
-    enableScriptlets: true,
-    customFiltersPath: './my-filters.txt',
-    enableFilterAutoUpdate: true,
-  }
-});
-```
-
-### Real Cursor (Ghost-Cursor)
-
-Built-in ghost-cursor for human-like mouse movements:
-
-```javascript
-const { browser, page } = await connect();
-
-// Human-like click
-await page.realClick('#submit-button');
-
-// Full cursor control
-await page.realCursor.move('#element');
-await page.realCursor.click('#button');
-```
-
-### Turnstile Auto-Solver
-
-Automatically solves Cloudflare Turnstile challenges:
-
-```javascript
-const { browser, page } = await connect({
-  turnstile: true
-});
-
-await page.goto('https://site-with-turnstile.com');
-// Turnstile is automatically solved!
-```
-
-### Puppeteer-Extra Plugins
-
-```javascript
-const clickAndWait = require('puppeteer-extra-plugin-click-and-wait')();
-
-const { browser, page } = await connect({
-  plugins: [clickAndWait]
-});
-```
-
-### Singleton Blocker Usage
-
-The blocker is a singleton - only one instance is created and shared:
-
-```javascript
-// From brave-real-blocker package
-import { 
-  getBraveBlockerSingleton, 
-  initBraveBlockerSingleton,
-  isBraveBlockerInitialized 
-} from 'brave-real-blocker/singleton';
-
-// Initialize once at startup
-const blocker = await initBraveBlockerSingleton({
-  enableAdBlocking: true,
-  enableStealth: true,
-});
-
-// Get the same instance anywhere else
-const sameBlocker = getBraveBlockerSingleton();
-console.log(blocker === sameBlocker); // true
-```
-
----
-
 ## Commands
 
 ### Root Level

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brave-real-browser-mcp-server",
-  "version": "2.37.1",
+  "version": "2.37.2",
   "description": "MCP Server for Brave Real Browser - Puppeteer with Brave Browser, Stealth Mode, Ad Blocker, and Turnstile Auto-Solver for undetectable web automation.",
   "main": "lib/cjs/index.js",
   "module": "lib/esm/index.mjs",
@@ -71,7 +71,7 @@
   "license": "ISC",
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.25.3",
-    "brave-real-puppeteer-core": "^24.52.1",
+    "brave-real-puppeteer-core": "^24.52.2",
     "ghost-cursor": "^1.4.2",
     "puppeteer-extra": "^3.3.6",
     "puppeteer-extra-plugin-stealth": "^2.11.2",

package/packages/brave-real-blocker/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brave-real-blocker",
-  "version": "1.13.1",
+  "version": "1.13.2",
   "description": "Advanced uBlock Origin management and stealth features for Brave Real Browser",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -53,17 +53,18 @@
   },
   "homepage": "https://github.com/codeiva4u/Brave-Real-Browser/tree/main/packages/brave-real-blocker",
   "dependencies": {
-    "@cliqz/adblocker-puppeteer": "^1.23.8",
+    "@cliqz/adblocker-puppeteer": "^1.34.0",
+    "@ghostery/adblocker-puppeteer": "^2.13.4",
     "adm-zip": "^0.5.10",
     "cross-fetch": "^4.1.0",
-    "fs-extra": "^11.2.0",
+    "fs-extra": "^11.3.3",
     "got": "^13.0.0"
   },
   "devDependencies": {
     "@types/adm-zip": "^0.5.5",
     "@types/fs-extra": "^11.0.4",
     "@types/node": "^20.0.0",
-    "brave-real-puppeteer-core": "^24.52.1",
+    "brave-real-puppeteer-core": "^24.52.2",
     "mocha": "^10.4.0",
     "puppeteer-core": "^24.35.0",
     "sinon": "^17.0.1",

package/packages/brave-real-launcher/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brave-real-launcher",
-  "version": "1.19.1",
+  "version": "1.19.2",
   "description": "Launch Brave Browser with ease from node. Based on chrome-launcher with Brave-specific support.",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -54,10 +54,10 @@
     "typescript": "^5.0.0"
   },
   "dependencies": {
-    "brave-real-blocker": "^1.13.1",
-    "escape-string-regexp": "^4.0.0",
-    "is-wsl": "^2.2.0",
-    "which": "^4.0.0"
+    "brave-real-blocker": "^1.13.2",
+    "escape-string-regexp": "^5.0.0",
+    "is-wsl": "^3.1.0",
+    "which": "^6.0.0"
   },
   "types": "./dist/index.d.ts",
   "repository": {

package/packages/brave-real-puppeteer-core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brave-real-puppeteer-core",
-  "version": "24.52.1",
+  "version": "24.52.2",
   "description": "🦁 Brave Real-World Optimized Puppeteer & Playwright Core with 1-5ms ultra-fast timing, 50+ professional stealth features, intelligent browser auto-detection, and 100% bot detection bypass. Features cross-platform Brave browser integration, comprehensive anti-detection, and breakthrough performance improvements.",
   "keywords": [
     "automation",
@@ -132,13 +132,13 @@
     "test-version": "node ./scripts/test-version-management.js"
   },
   "dependencies": {
-    "brave-real-launcher": "^1.19.1",
+    "brave-real-launcher": "^1.19.2",
     "get-east-asian-width": "^1.4.0",
     "yargs": "^18.0.0"
   },
   "optionalDependencies": {
-    "playwright-core": "^1.57.0",
-    "puppeteer-core": "^24.34.0"
+    "playwright-core": "^1.58.1",
+    "puppeteer-core": "^24.36.1"
   },
   "devDependencies": {
     "test": "^3.3.0"