brave-real-browser-mcp-server 2.12.0 → 2.12.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +457 -445
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -1,68 +1,32 @@
1
- # 🌐 Brave Real Browser MCP Server - Universal AI IDE Support
1
+ # 🌐 Brave Real Browser MCP Server
2
+ ## Universal AI IDE Support with Advanced Browser Automation
2
3
 
3
4
  <div align="center">
4
5
 
5
- ![Version](https://img.shields.io/badge/version-2.11.8-blue.svg)
6
+ ![Version](https://img.shields.io/badge/version-2.12.1-blue.svg)
6
7
  ![Node](https://img.shields.io/badge/node-%3E%3D18.0.0-green.svg)
7
- ![License](https://img.shields.io/badge/license-MIT-orange.svg)
8
- ![AI IDEs](https://img.shields.io/badge/AI_IDEs-15+-purple.svg)
9
- ![Protocols](https://img.shields.io/badge/protocols-4-red.svg)
8
+ ![Tools](https://img.shields.io/badge/tools-111-purple.svg)
9
+ ![IDEs](https://img.shields.io/badge/AI_IDEs-15+-orange.svg)
10
+ ![License](https://img.shields.io/badge/license-MIT-red.svg)
10
11
 
11
- **सभी AI IDEs के लिए Universal MCP Server | Browser Automation | Web Scraping | CAPTCHA Solving**
12
+ **सभी AI IDEs के लिए Universal MCP Server | 111+ Tools | Browser Automation | Web Scraping | CAPTCHA Solving**
12
13
 
13
- [English](#english) | [हिन्दी](#hindi)
14
+ [Installation](#-installation) | [Quick Start](#-quick-start) | [Tools](#-available-tools-111) | [HTTP/WebSocket](#-httpwebsocket-setup) | [Configuration](#-ide-configurations)
14
15
 
15
16
  </div>
16
17
 
17
18
  ---
18
19
 
19
- ## 🎯 What Makes This Universal?
20
+ ## 🎯 What is This?
20
21
 
21
- **यह प्रोजेक्ट सभी AI IDEs में स्वचालित रूप से काम करता है!**
22
+ **Brave Real Browser MCP Server** एक powerful automation tool है जो:
22
23
 
23
- ✅ **Auto-Detection** - आपका IDE automatically detect होता है
24
- ✅ **Multi-Protocol** - MCP, LSP, HTTP, WebSocket सभी supported
25
- ✅ **Zero Configuration** - कोई manual setup की जरूरत नहीं
26
- ✅ **15+ AI IDEs** - सभी popular AI tools supported
27
- ✅ **Real Brave Browser** - असली Brave browser के साथ काम करता है
28
- ✅ **Anti-Detection** - Cloudflare, reCAPTCHA bypass करता है
29
-
30
- ---
31
-
32
- <a name="english"></a>
33
- # 📖 English Documentation
34
-
35
- ## 🤖 Supported AI IDEs (Universal Compatibility)
36
-
37
- This server **automatically detects and adapts** to your AI IDE!
38
-
39
- ### ✅ Fully Supported & Auto-Detected
40
-
41
- | IDE | Protocol | Auto-Config | Status |
42
- |-----|----------|-------------|--------|
43
- | **Claude Desktop** | MCP/STDIO | ✅ | 🟢 Working |
44
- | **Cursor AI** | MCP/STDIO | ✅ | 🟢 Working |
45
- | **Windsurf** | MCP/STDIO | ✅ | 🟢 Working |
46
- | **Cline** (VSCode) | MCP/STDIO | ✅ | 🟢 Working |
47
- | **Warp Terminal** | MCP/STDIO | ✅ | 🟢 Working |
48
- | **Roo Coder** | MCP/STDIO | ✅ | 🟢 Working |
49
- | **Zed Editor** | LSP/MCP | ✅ | 🟢 Working |
50
- | **VSCode** | LSP/HTTP | ✅ | 🟢 Working |
51
- | **Qoder AI** | HTTP/WS | ✅ | 🟢 Working |
52
- | **Continue.dev** | MCP/HTTP | ✅ | 🟢 Working |
53
- | **GitHub Copilot** | HTTP/LSP | ✅ | 🟢 Working |
54
- | **Amazon CodeWhisperer** | HTTP/LSP | ✅ | 🟢 Working |
55
- | **Tabnine** | HTTP/WS | ✅ | 🟢 Working |
56
- | **Cody** (Sourcegraph) | HTTP/LSP | ✅ | 🟢 Working |
57
- | **Aider** | STDIO/HTTP | ✅ | 🟢 Working |
58
- | **Pieces for Developers** | HTTP/WS | ✅ | 🟢 Working |
59
-
60
- ### 📡 Supported Protocols
61
-
62
- - **MCP** (Model Context Protocol) - Claude Desktop, Cursor, Windsurf, Cline, Warp, Roo Coder
63
- - **LSP** (Language Server Protocol) - Zed, VSCode, Neovim, Emacs, Sublime Text
64
- - **HTTP/REST** - Universal API for all IDEs
65
- - **WebSocket** - Real-time communication for modern IDEs
24
+ - ✅ **15+ AI IDEs में काम करता है** (Claude, Cursor, Windsurf, Cline, Zed, VSCode, Qoder AI, etc.)
25
+ - ✅ **111+ Automation Tools** - Browser control, scraping, CAPTCHA solving, video extraction
26
+ - ✅ **3 Protocol Modes** - MCP (STDIO), LSP, HTTP/WebSocket
27
+ - ✅ **Auto-Detection** - Automatically detects your IDE
28
+ - ✅ **Real Brave Browser** - Anti-detection features, bypass Cloudflare
29
+ - ✅ **Universal API** - Works with any programming language (JS, Python, PHP, Go, etc.)
66
30
 
67
31
  ---
68
32
 
@@ -72,69 +36,142 @@ This server **automatically detects and adapts** to your AI IDE!
72
36
 
73
37
  ```bash
74
38
  # Install globally
75
- npm install -g brave-real-browser-mcp-server
39
+ npm install -g brave-real-browser-mcp-server@latest
40
+
41
+ # Or use with npx (no installation)
42
+ npx brave-real-browser-mcp-server@latest
43
+ ```
44
+
45
+ ### For MCP IDEs (Claude, Cursor, Windsurf)
46
+
47
+ **Add to your IDE config file:**
76
48
 
77
- # Or use with npx (no installation needed)
78
- npx brave-real-browser-mcp-server
49
+ ```json
50
+ {
51
+ "mcpServers": {
52
+ "brave-real-browser": {
53
+ "command": "npx",
54
+ "args": ["-y", "brave-real-browser-mcp-server@latest"]
55
+ }
56
+ }
57
+ }
79
58
  ```
80
59
 
81
- ### Usage
60
+ **Config file locations:**
61
+ - **Claude Desktop:** `%APPDATA%\Claude\claude_desktop_config.json` (Windows) or `~/Library/Application Support/Claude/claude_desktop_config.json` (Mac)
62
+ - **Cursor:** `%APPDATA%\Cursor\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json`
63
+ - **Windsurf:** `%APPDATA%\Windsurf\mcp.json`
64
+
65
+ ### For Other IDEs (Qoder AI, Custom Tools)
66
+
67
+ Use HTTP/WebSocket mode - [See HTTP/WebSocket Setup](#-httpwebsocket-setup)
68
+
69
+ ---
70
+
71
+ ## 🌐 HTTP/WebSocket Setup
72
+
73
+ ### HTTP Protocol - 5 Steps
74
+
75
+ HTTP mode works with **ANY IDE or programming language**. No special configuration needed!
76
+
77
+ #### Step 1: Start HTTP Server
82
78
 
83
79
  ```bash
84
- # Auto mode (automatically detects your IDE) - DEFAULT
85
- brave-real-browser-mcp-server
80
+ # Start server on port 3000
81
+ npx brave-real-browser-mcp-server@latest --mode http --port 3000
82
+
83
+ # Custom host and port
84
+ npx brave-real-browser-mcp-server@latest --mode http --host 0.0.0.0 --port 8080
85
+
86
+ # HTTP only (without WebSocket)
87
+ npx brave-real-browser-mcp-server@latest --mode http --port 3000 --no-websocket
88
+ ```
89
+
90
+ **Server will start and show:**
91
+ ```
92
+ 🟢 [HTTP] Starting HTTP/WebSocket server...
93
+ ✅ [HTTP] Server ready at http://localhost:3000
94
+ 💡 [HTTP] Universal mode - works with ALL AI IDEs
95
+ ```
86
96
 
87
- # Or explicitly specify protocol
88
- brave-real-browser-mcp-server --mode auto
97
+ #### Step 2: Test Server
89
98
 
90
- # MCP mode (for Claude, Cursor, Windsurf, etc.)
91
- brave-real-browser-mcp-server --mode mcp
99
+ ```bash
100
+ # Health check
101
+ curl http://localhost:3000/health
92
102
 
93
- # HTTP mode (universal - works with ALL IDEs)
94
- brave-real-browser-mcp-server --mode http --port 3000
103
+ # List all available tools
104
+ curl http://localhost:3000/tools
105
+ ```
95
106
 
96
- # LSP mode (for Zed, VSCode, etc.)
97
- brave-real-browser-mcp-server --mode lsp
107
+ #### Step 5: Configure in Your IDE
108
+
109
+ **For Qoder AI:**
110
+ ```json
111
+ {
112
+ "extensions": {
113
+ "brave-real-browser": {
114
+ "type": "http",
115
+ "enabled": true,
116
+ "endpoint": "http://localhost:3000"
117
+ }
118
+ }
119
+ }
98
120
  ```
99
121
 
122
+ **For any custom tool:** Just make HTTP POST requests to `http://localhost:3000/tools/{tool_name}`
123
+
100
124
  ---
101
125
 
102
- ## ⚙️ Configuration for Specific IDEs
126
+ ### WebSocket Protocol - 5 Steps
127
+
128
+ WebSocket provides **real-time, bidirectional communication** for modern applications.
129
+
130
+ #### Step 1: Start WebSocket Server
103
131
 
104
- ### 1. Claude Desktop
132
+ ```bash
133
+ # WebSocket is automatically enabled with HTTP mode
134
+ npx brave-real-browser-mcp-server@latest --mode http --port 3000
135
+
136
+ # WebSocket will be available at: ws://localhost:3000
137
+ ```
138
+
139
+ ## 🎨 IDE Configurations
140
+
141
+ ### Claude Desktop
105
142
 
106
143
  **File:** `claude_desktop_config.json`
107
144
 
108
145
  **Location:**
109
- - **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
110
- - **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
111
- - **Linux:** `~/.config/Claude/claude_desktop_config.json`
146
+ - Windows: `%APPDATA%\Claude\claude_desktop_config.json`
147
+ - Mac: `~/Library/Application Support/Claude/claude_desktop_config.json`
148
+ - Linux: `~/.config/Claude/claude_desktop_config.json`
112
149
 
113
150
  ```json
114
151
  {
115
152
  "mcpServers": {
116
- "brave-browser": {
153
+ "brave-real-browser": {
117
154
  "command": "npx",
118
- "args": ["-y", "brave-real-browser-mcp-server"]
155
+ "args": ["-y", "brave-real-browser-mcp-server@latest"]
119
156
  }
120
157
  }
121
158
  }
122
159
  ```
123
160
 
124
- ### 2. Cursor AI
161
+ ### Cursor AI
125
162
 
126
163
  **File:** `cline_mcp_settings.json`
127
164
 
128
165
  **Location:**
129
- - **Windows:** `%APPDATA%\Cursor\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json`
130
- - **macOS:** `~/Library/Application Support/Cursor/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json`
166
+ - Windows: `%APPDATA%\Cursor\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json`
167
+ - Mac: `~/Library/Application Support/Cursor/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json`
131
168
 
132
169
  ```json
133
170
  {
134
171
  "mcpServers": {
135
- "brave-browser": {
172
+ "brave-real-browser": {
136
173
  "command": "npx",
137
- "args": ["-y", "brave-real-browser-mcp-server"],
174
+ "args": ["-y", "brave-real-browser-mcp-server@latest"],
138
175
  "env": {
139
176
  "BRAVE_PATH": "C:\\Program Files\\BraveSoftware\\Brave-Browser\\Application\\brave.exe"
140
177
  }
@@ -143,236 +180,409 @@ brave-real-browser-mcp-server --mode lsp
143
180
  }
144
181
  ```
145
182
 
146
- ### 3. Windsurf
183
+ ### Windsurf
147
184
 
148
185
  **File:** `mcp.json`
149
186
 
150
187
  **Location:**
151
- - **Windows:** `%APPDATA%\Windsurf\mcp.json`
152
- - **macOS:** `~/.windsurf/mcp.json`
188
+ - Windows: `%APPDATA%\Windsurf\mcp.json`
189
+ - Mac: `~/.windsurf/mcp.json`
153
190
 
154
191
  ```json
155
192
  {
156
193
  "mcpServers": {
157
- "brave-browser": {
194
+ "brave-real-browser": {
158
195
  "command": "npx",
159
- "args": ["-y", "brave-real-browser-mcp-server"]
196
+ "args": ["-y", "brave-real-browser-mcp-server@latest"]
160
197
  }
161
198
  }
162
199
  }
163
200
  ```
164
201
 
165
- ### 4. Cline (VSCode Extension)
202
+ ### Cline (VSCode Extension)
166
203
 
167
204
  **File:** `cline_mcp_settings.json`
168
205
 
169
206
  **Location:**
170
- - **Windows:** `%APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json`
171
- - **macOS:** `~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json`
207
+ - Windows: `%APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json`
208
+ - Mac: `~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json`
172
209
 
173
210
  ```json
174
211
  {
175
212
  "mcpServers": {
176
- "brave-browser": {
213
+ "brave-real-browser": {
177
214
  "command": "npx",
178
- "args": ["-y", "brave-real-browser-mcp-server"]
215
+ "args": ["-y", "brave-real-browser-mcp-server@latest"]
179
216
  }
180
217
  }
181
218
  }
182
219
  ```
183
220
 
184
- ### 5. Zed Editor
221
+ ### Zed Editor
185
222
 
186
223
  **File:** `settings.json`
187
224
 
188
225
  **Location:**
189
- - **Windows:** `%APPDATA%\Zed\settings.json`
190
- - **macOS:** `~/.config/zed/settings.json`
226
+ - Windows: `%APPDATA%\Zed\settings.json`
227
+ - Mac: `~/.config/zed/settings.json`
191
228
 
192
229
  ```json
193
230
  {
194
231
  "lsp": {
195
- "brave-browser": {
196
- "command": "brave-real-browser-mcp-server",
232
+ "brave-real-browser": {
233
+ "command": "brave-real-browser-mcp-server@latest",
197
234
  "args": ["--mode", "lsp"]
198
235
  }
199
236
  }
200
237
  }
201
238
  ```
202
239
 
203
- ### 6. Qoder AI & Other HTTP-based IDEs
240
+ ### Qoder AI / HTTP-based IDEs
204
241
 
205
- Start the server in HTTP mode:
242
+ Start server in HTTP mode and configure:
206
243
 
207
- ```bash
208
- brave-real-browser-mcp-server --mode http --port 3000
244
+ ```json
245
+ {
246
+ "extensions": {
247
+ "brave-real-browser": {
248
+ "type": "http",
249
+ "enabled": true,
250
+ "endpoint": "http://localhost:3000",
251
+ "timeout": 30000
252
+ }
253
+ }
254
+ }
209
255
  ```
210
256
 
211
- Then use the REST API endpoint: `http://localhost:3000`
212
-
213
257
  ---
214
258
 
215
- ## 🛠️ Features & Tools
216
-
217
- ### 🌐 Browser Management
218
- - `browser_init` - Initialize Brave browser with anti-detection
219
- - `browser_close` - Close browser instance
220
- - `navigate` - Navigate to URL
221
- - `wait` - Wait for elements/timeout
222
-
223
- ### 🖱️ Interaction Tools
224
- - `click` - Click on elements
225
- - `type` - Type text into inputs
226
- - `solve_captcha` - Solve CAPTCHA (reCAPTCHA, hCaptcha, Turnstile, etc.)
227
- - `random_scroll` - Human-like scrolling
228
-
229
- ### 📄 Content Extraction
230
- - `get_content` - Extract page content (HTML/Text/Markdown)
231
- - `find_selector` - Find CSS selectors
232
- - `scrape_table` - Extract table data
233
- - `extract_list` - Extract lists
234
- - `extract_json` - Extract JSON data
235
- - `scrape_meta_tags` - Extract meta information
236
- - `extract_schema` - Extract schema.org data
237
-
238
- ### 🔍 Advanced Extraction
239
- - `batch_element_scraper` - Scrape multiple elements
240
- - `nested_data_extraction` - Extract nested data structures
241
- - `attribute_harvester` - Extract element attributes
242
- - `image_scraper` - Extract all images
243
- - `link_harvester` - Extract all links
244
- - `media_extractor` - Extract media files
245
- - `video_link_finder` - Find video URLs
246
-
247
- ### 🤖 AI-Powered Tools
248
- - `smart_selector_generator` - Auto-generate selectors
249
- - `content_classification` - Classify content type
250
- - `sentiment_analysis` - Analyze sentiment
251
- - `summary_generator` - Generate summaries
252
- - `translation_support` - Translate content
253
-
254
- ### 📊 Data Processing
255
- - `smart_text_cleaner` - Clean extracted text
256
- - `html_to_text` - Convert HTML to text
257
- - `price_parser` - Extract & parse prices
258
- - `date_normalizer` - Normalize dates
259
- - `contact_extractor` - Extract contact info
260
- - `data_deduplication` - Remove duplicates
261
- - `data_type_validator` - Validate data types
262
-
263
- ### 🔐 CAPTCHA & Security
264
- - `solve_captcha` - Multi-CAPTCHA solver
265
- - `ocr_engine` - OCR for text CAPTCHAs
266
- - `audio_captcha_solver` - Audio CAPTCHA solver
267
- - `puzzle_captcha_handler` - Puzzle CAPTCHA handler
268
-
269
- ### 📸 Visual Tools
270
- - `full_page_screenshot` - Full page screenshot
271
- - `element_screenshot` - Element screenshot
272
- - `pdf_generation` - Generate PDF
273
- - `video_recording` - Record page video
274
- - `visual_comparison` - Compare screenshots
275
-
276
- ### 🔄 Pagination & Navigation
277
- - `auto_pagination` - Auto-paginate through pages
278
- - `infinite_scroll` - Handle infinite scroll
279
- - `multi_page_scraper` - Scrape multiple pages
280
- - `sitemap_parser` - Parse sitemaps
281
- - `breadcrumb_navigator` - Navigate breadcrumbs
282
-
283
- ### 🌐 Session Management
284
- - `cookie_manager` - Manage cookies
285
- - `session_persistence` - Persist sessions
286
- - `form_auto_fill` - Auto-fill forms
287
- - `login_session_manager` - Manage login sessions
288
- - `modal_popup_handler` - Handle popups
289
-
290
- ### 📈 Monitoring & Reporting
291
- - `progress_tracker` - Track progress
292
- - `error_logger` - Log errors
293
- - `success_rate_reporter` - Report success rates
294
- - `performance_monitor` - Monitor performance
295
- - `monitoring_summary` - Get monitoring summary
259
+
260
+ ## 🛠️ Available Tools (111)
261
+
262
+ ### 🌐 Browser Management (2 tools)
263
+
264
+ | Tool | Description |
265
+ |------|-------------|
266
+ | `browser_init` | Initialize browser with anti-detection features |
267
+ | `browser_close` | Close browser instance |
268
+
269
+ ### 🧭 Navigation (2 tools)
270
+
271
+ | Tool | Description |
272
+ |------|-------------|
273
+ | `navigate` | Navigate to URL with wait conditions |
274
+ | `wait` | Wait for selector, navigation, or timeout |
275
+
276
+ ### 🖱️ Interactions (4 tools)
277
+
278
+ | Tool | Description |
279
+ |------|-------------|
280
+ | `click` | Click on elements |
281
+ | `type` | Type text into inputs |
282
+ | `random_scroll` | Human-like scrolling |
283
+ | `solve_captcha` | Solve CAPTCHA (reCAPTCHA, hCaptcha, Turnstile, etc.) |
284
+
285
+ ### 📄 Content Extraction (10 tools)
286
+
287
+ | Tool | Description |
288
+ |------|-------------|
289
+ | `get_content` | Extract page content (HTML/Text/Markdown) |
290
+ | `find_selector` | Find CSS selectors for elements |
291
+ | `scrape_table` | Extract table data with headers |
292
+ | `extract_list` | Extract list items |
293
+ | `extract_json` | Extract JSON data from page |
294
+ | `scrape_meta_tags` | Extract meta tags and SEO info |
295
+ | `extract_schema` | Extract schema.org structured data |
296
+ | `save_content_as_markdown` | Save page as markdown file |
297
+ | `html_to_text` | Convert HTML to clean text |
298
+ | `smart_text_cleaner` | Clean and normalize text |
299
+
300
+ ### 🔍 Multi-Element Extraction (8 tools)
301
+
302
+ | Tool | Description |
303
+ |------|-------------|
304
+ | `batch_element_scraper` | Scrape multiple elements at once |
305
+ | `nested_data_extraction` | Extract nested data structures |
306
+ | `attribute_harvester` | Extract element attributes |
307
+ | `image_scraper` | Extract all images with metadata |
308
+ | `link_harvester` | Extract all links from page |
309
+ | `media_extractor` | Extract media files (audio/video) |
310
+ | `pdf_link_finder` | Find PDF download links |
311
+ | `html_elements_extractor` | Extract specific HTML elements |
312
+
313
+ ### 🎯 Advanced Extraction (10 tools)
314
+
315
+ | Tool | Description |
316
+ |------|-------------|
317
+ | `tags_finder` | Find elements by tag name |
318
+ | `links_finder` | Advanced link extraction |
319
+ | `xpath_links` | Extract links using XPath |
320
+ | `ajax_extractor` | Extract AJAX/dynamic content |
321
+ | `fetch_xhr` | Capture XHR/Fetch requests |
322
+ | `network_recorder` | Record all network traffic |
323
+ | `api_finder` | Discover API endpoints |
324
+ | `regex_pattern_finder` | Find patterns using regex |
325
+ | `iframe_extractor` | Extract iframe content |
326
+ | `embed_page_extractor` | Extract embedded pages |
327
+
328
+ ### 🎬 Video & Media Tools (19 tools)
329
+
330
+ | Tool | Description |
331
+ |------|-------------|
332
+ | `video_link_finder` | Find video URLs |
333
+ | `video_download_page` | Navigate to video download page |
334
+ | `video_download_button` | Find video download buttons |
335
+ | `video_play_push_source` | Get video play sources |
336
+ | `video_play_button_click` | Click video play button |
337
+ | `url_redirect_trace_endpoints` | Trace URL redirects |
338
+ | `network_recording_finder` | Find network recordings |
339
+ | `network_recording_extractors` | Extract network data |
340
+ | `video_links_finders` | Multiple video link finders |
341
+ | `videos_selectors` | Video element selectors |
342
+ | `link_process_extracts` | Process and extract links |
343
+ | `video_link_finders_extracts` | Advanced video link extraction |
344
+ | `video_download_button_finders` | Find all download buttons |
345
+ | `advanced_video_extraction` | Advanced video extraction with ad-bypass |
346
+ | `image_extractor_advanced` | Advanced image extraction |
347
+ | `video_source_extractor` | Extract video source URLs |
348
+ | `video_player_extractor` | Extract video player info |
349
+ | `video_player_hoster_finder` | Find video hosting platform |
350
+ | `original_video_hoster_finder` | Find original video source |
351
+
352
+ ### 🔐 CAPTCHA & Security (4 tools)
353
+
354
+ | Tool | Description |
355
+ |------|-------------|
356
+ | `solve_captcha` | Multi-CAPTCHA solver (reCAPTCHA, hCaptcha, Turnstile, Arkose, etc.) |
357
+ | `ocr_engine` | OCR for text-based CAPTCHAs |
358
+ | `audio_captcha_solver` | Solve audio CAPTCHAs |
359
+ | `puzzle_captcha_handler` | Handle puzzle CAPTCHAs |
360
+
361
+ ### 🔧 Data Processing (9 tools)
362
+
363
+ | Tool | Description |
364
+ |------|-------------|
365
+ | `price_parser` | Extract and parse prices |
366
+ | `date_normalizer` | Normalize dates to standard format |
367
+ | `contact_extractor` | Extract contact information |
368
+ | `schema_validator` | Validate data against schema |
369
+ | `required_fields_checker` | Check for required fields |
370
+ | `duplicate_remover` | Remove duplicate entries |
371
+ | `data_deduplication` | Advanced deduplication |
372
+ | `missing_data_handler` | Handle missing data |
373
+ | `data_type_validator` | Validate data types |
374
+
375
+ ### 📊 Data Quality (3 tools)
376
+
377
+ | Tool | Description |
378
+ |------|-------------|
379
+ | `outlier_detection` | Detect data outliers |
380
+ | `consistency_checker` | Check data consistency |
381
+ | `data_quality_metrics` | Generate quality metrics |
382
+
383
+ ### 🤖 AI-Powered Tools (5 tools)
384
+
385
+ | Tool | Description |
386
+ |------|-------------|
387
+ | `smart_selector_generator` | Auto-generate CSS selectors |
388
+ | `content_classification` | Classify content type |
389
+ | `sentiment_analysis` | Analyze text sentiment |
390
+ | `summary_generator` | Generate content summaries |
391
+ | `translation_support` | Translate content |
392
+
393
+ ### 🔎 Search & Filter (5 tools)
394
+
395
+ | Tool | Description |
396
+ |------|-------------|
397
+ | `keyword_search` | Search for keywords in page |
398
+ | `regex_pattern_matcher` | Match regex patterns |
399
+ | `xpath_support` | XPath query support |
400
+ | `advanced_css_selectors` | Advanced CSS selector queries |
401
+ | `visual_element_finder` | Find elements visually |
402
+
403
+ ### 📑 Pagination & Navigation (5 tools)
404
+
405
+ | Tool | Description |
406
+ |------|-------------|
407
+ | `auto_pagination` | Auto-paginate through pages |
408
+ | `infinite_scroll` | Handle infinite scroll |
409
+ | `multi_page_scraper` | Scrape multiple pages |
410
+ | `sitemap_parser` | Parse and navigate sitemaps |
411
+ | `breadcrumb_navigator` | Navigate using breadcrumbs |
412
+
413
+ ### 🔒 Session Management (7 tools)
414
+
415
+ | Tool | Description |
416
+ |------|-------------|
417
+ | `cookie_manager` | Manage cookies |
418
+ | `session_persistence` | Persist sessions |
419
+ | `form_auto_fill` | Auto-fill forms |
420
+ | `ajax_content_waiter` | Wait for AJAX content |
421
+ | `modal_popup_handler` | Handle modal popups |
422
+ | `login_session_manager` | Manage login sessions |
423
+ | `shadow_dom_extractor` | Extract Shadow DOM content |
424
+
425
+ ### 📸 Visual Tools (5 tools)
426
+
427
+ | Tool | Description |
428
+ |------|-------------|
429
+ | `full_page_screenshot` | Full page screenshot |
430
+ | `element_screenshot` | Screenshot specific element |
431
+ | `pdf_generation` | Generate PDF from page |
432
+ | `video_recording` | Record page as video |
433
+ | `visual_comparison` | Compare screenshots |
434
+
435
+ ### 📈 Monitoring & Reporting (6 tools)
436
+
437
+ | Tool | Description |
438
+ |------|-------------|
439
+ | `progress_tracker` | Track automation progress |
440
+ | `error_logger` | Log errors |
441
+ | `success_rate_reporter` | Report success rates |
442
+ | `data_quality_metrics` | Data quality metrics |
443
+ | `performance_monitor` | Monitor performance |
444
+ | `monitoring_summary` | Get monitoring summary |
445
+
446
+ ### 🌐 API Integration (3 tools)
447
+
448
+ | Tool | Description |
449
+ |------|-------------|
450
+ | `rest_api_endpoint_finder` | Find REST API endpoints |
451
+ | `webhook_support` | Webhook integration |
452
+ | `all_website_api_finder` | Find all APIs on website |
453
+
454
+ ### 🛡️ Advanced Extraction & Obfuscation (5 tools)
455
+
456
+ | Tool | Description |
457
+ |------|-------------|
458
+ | `deobfuscate_js` | Deobfuscate JavaScript |
459
+ | `multi_layer_redirect_trace` | Trace multi-layer redirects |
460
+ | `ad_protection_detector` | Detect ad protection |
461
+ | `url_redirect_tracer` | Trace URL redirects |
462
+ | `user_agent_extractor` | Extract user agent info |
296
463
 
297
464
  ---
298
465
 
299
466
  ## 💡 Usage Examples
300
467
 
301
- ### Example 1: Simple Web Scraping
468
+ ### Example 1: Simple Web Scraping (MCP Mode)
302
469
 
303
470
  ```javascript
304
- // Initialize browser
471
+ // Using MCP tool in Claude/Cursor
305
472
  await use_mcp_tool({
306
- server_name: "brave-browser",
473
+ server_name: "brave-real-browser",
307
474
  tool_name: "browser_init",
308
475
  arguments: {}
309
476
  });
310
477
 
311
- // Navigate to website
312
478
  await use_mcp_tool({
313
- server_name: "brave-browser",
479
+ server_name: "brave-real-browser",
314
480
  tool_name: "navigate",
315
481
  arguments: { url: "https://example.com" }
316
482
  });
317
483
 
318
- // Get content
319
484
  await use_mcp_tool({
320
- server_name: "brave-browser",
485
+ server_name: "brave-real-browser",
321
486
  tool_name: "get_content",
322
487
  arguments: { type: "text" }
323
488
  });
324
489
  ```
325
490
 
326
- ### Example 2: Solve CAPTCHA & Extract Data
491
+ ### Example 2: CAPTCHA Solving
327
492
 
328
493
  ```javascript
329
- // Navigate to page with CAPTCHA
494
+ // Navigate to CAPTCHA page
330
495
  await use_mcp_tool({
331
- server_name: "brave-browser",
496
+ server_name: "brave-real-browser",
332
497
  tool_name: "navigate",
333
- arguments: { url: "https://example.com/protected-page" }
498
+ arguments: { url: "https://site-with-captcha.com" }
334
499
  });
335
500
 
336
501
  // Solve CAPTCHA
337
502
  await use_mcp_tool({
338
- server_name: "brave-browser",
503
+ server_name: "brave-real-browser",
339
504
  tool_name: "solve_captcha",
340
505
  arguments: { type: "recaptcha" }
341
506
  });
342
507
 
343
- // Extract table data
508
+ // Continue automation
344
509
  await use_mcp_tool({
345
- server_name: "brave-browser",
346
- tool_name: "scrape_table",
347
- arguments: { selector: "table.data" }
510
+ server_name: "brave-real-browser",
511
+ tool_name: "click",
512
+ arguments: { selector: "button.submit" }
348
513
  });
349
514
  ```
350
515
 
351
- ### Example 3: HTTP API Usage
516
+ ### Example 3: Video Extraction
352
517
 
353
- ```bash
354
- # Start HTTP server
355
- brave-real-browser-mcp-server --mode http --port 3000
518
+ ```javascript
519
+ // Navigate to video page
520
+ await use_mcp_tool({
521
+ server_name: "brave-real-browser",
522
+ tool_name: "navigate",
523
+ arguments: { url: "https://video-site.com/video/123" }
524
+ });
525
+
526
+ // Find video links
527
+ await use_mcp_tool({
528
+ server_name: "brave-real-browser",
529
+ tool_name: "video_link_finder",
530
+ arguments: {}
531
+ });
532
+
533
+ // Advanced video extraction with ad bypass
534
+ await use_mcp_tool({
535
+ server_name: "brave-real-browser",
536
+ tool_name: "advanced_video_extraction",
537
+ arguments: {}
538
+ });
356
539
  ```
357
540
 
541
+ ### Example 4: Multi-Page Scraping
542
+
358
543
  ```javascript
359
- // Use REST API
360
- const response = await fetch('http://localhost:3000/tools/navigate', {
361
- method: 'POST',
362
- headers: { 'Content-Type': 'application/json' },
363
- body: JSON.stringify({ url: 'https://example.com' })
544
+ // Initialize browser
545
+ await use_mcp_tool({
546
+ server_name: "brave-real-browser",
547
+ tool_name: "browser_init",
548
+ arguments: {}
364
549
  });
365
550
 
366
- const result = await response.json();
551
+ // Auto-paginate through all pages
552
+ await use_mcp_tool({
553
+ server_name: "brave-real-browser",
554
+ tool_name: "multi_page_scraper",
555
+ arguments: {
556
+ startUrl: "https://example.com/page/1",
557
+ maxPages: 10
558
+ }
559
+ });
367
560
  ```
368
561
 
369
562
  ---
370
563
 
371
- ## 📋 Requirements
564
+ ## 📋 API Endpoints (HTTP Mode)
372
565
 
373
- - **Node.js** >= 18.0.0
374
- - **Brave Browser** (auto-detected or specify path)
375
- - **Operating System:** Windows, macOS, or Linux
566
+ When running in HTTP mode, these endpoints are available:
567
+
568
+ ```
569
+ GET /health - Health check
570
+ GET /tools - List all tools
571
+ POST /tools/:toolName - Execute any tool
572
+ POST /browser/init - Initialize browser
573
+ POST /browser/navigate - Navigate to URL
574
+ POST /browser/get_content - Get page content
575
+ POST /browser/click - Click element
576
+ POST /browser/type - Type text
577
+ POST /browser/close - Close browser
578
+ ```
579
+
580
+ **Example:**
581
+ ```bash
582
+ curl -X POST http://localhost:3000/tools/navigate \
583
+ -H "Content-Type: application/json" \
584
+ -d '{"url": "https://example.com"}'
585
+ ```
376
586
 
377
587
  ---
378
588
 
@@ -387,6 +597,9 @@ HEADLESS=true
387
597
 
388
598
  # Optional: Disable content priority
389
599
  DISABLE_CONTENT_PRIORITY=true
600
+
601
+ # Optional: HTTP port
602
+ HTTP_PORT=3000
390
603
  ```
391
604
 
392
605
  ---
@@ -395,283 +608,82 @@ DISABLE_CONTENT_PRIORITY=true
395
608
 
396
609
  ### Brave Browser Not Found
397
610
 
398
- **Solution 1:** Set environment variable
611
+ **Solution:**
399
612
  ```bash
400
613
  # Windows
401
614
  set BRAVE_PATH="C:\Program Files\BraveSoftware\Brave-Browser\Application\brave.exe"
402
615
 
403
- # Linux/macOS
616
+ # Linux/Mac
404
617
  export BRAVE_PATH="/usr/bin/brave-browser"
405
618
  ```
406
619
 
407
- **Solution 2:** Specify in browser_init
408
- ```javascript
409
- await use_mcp_tool({
410
- server_name: "brave-browser",
411
- tool_name: "browser_init",
412
- arguments: {
413
- customConfig: {
414
- chromePath: "C:\\Program Files\\BraveSoftware\\Brave-Browser\\Application\\brave.exe"
415
- }
416
- }
417
- });
418
- ```
419
-
420
- ### Server Not Starting
620
+ ### Server Won't Start
421
621
 
422
622
  1. Check Node.js version: `node --version` (should be >= 18)
423
623
  2. Clear npm cache: `npm cache clean --force`
424
- 3. Reinstall: `npm install -g brave-real-browser-mcp-server`
425
- 4. Check logs in stderr
624
+ 3. Reinstall: `npm install -g brave-real-browser-mcp-server@latest`
426
625
 
427
- ### CAPTCHA Not Solving
428
-
429
- 1. Wait for CAPTCHA to fully load
430
- 2. Use longer timeout: `{ "timeout": 30000 }`
431
- 3. Try different CAPTCHA types: `recaptcha`, `hcaptcha`, `turnstile`
432
-
433
- ---
434
-
435
- ## 🤝 Contributing
436
-
437
- Contributions are welcome! Please feel free to submit a Pull Request.
438
-
439
- 1. Fork the repository
440
- 2. Create your feature branch (`git checkout -b feature/AmazingFeature`)
441
- 3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)
442
- 4. Push to the branch (`git push origin feature/AmazingFeature`)
443
- 5. Open a Pull Request
444
-
445
- ---
446
-
447
- ## 📄 License
448
-
449
- This project is licensed under the MIT License.
450
-
451
- ---
452
-
453
- ## 🔗 Links
454
-
455
- - **GitHub:** https://github.com/withLinda/brave-real-browser-mcp-server
456
- - **NPM:** https://www.npmjs.com/package/brave-real-browser-mcp-server
457
- - **Issues:** https://github.com/withLinda/brave-real-browser-mcp-server/issues
458
-
459
- ---
460
-
461
- <a name="hindi"></a>
462
- # 📖 हिन्दी दस्तावेज़
463
-
464
- ## 🤖 समर्थित AI IDEs (सार्वभौमिक संगतता)
465
-
466
- यह server **स्वचालित रूप से आपके AI IDE को detect करता है और adapt हो जाता है!**
467
-
468
- ### ✅ पूर्णतः समर्थित और स्वतः-पता लगाना
469
-
470
- सभी 15+ AI IDEs स्वचालित रूप से समर्थित हैं। कोई manual configuration की जरूरत नहीं!
471
-
472
- ---
473
-
474
- ## 🚀 त्वरित शुरुआत
475
-
476
- ### इंस्टॉलेशन
477
-
478
- ```bash
479
- # Global इंस्टॉल करें
480
- npm install -g brave-real-browser-mcp-server
481
-
482
- # या npx से चलाएं (बिना installation के)
483
- npx brave-real-browser-mcp-server
484
- ```
485
-
486
- ### उपयोग
626
+ ### Port Already in Use
487
627
 
488
628
  ```bash
489
- # Auto mode (आपका IDE automatically detect होगा) - डिफ़ॉल्ट
490
- brave-real-browser-mcp-server
491
-
492
- # MCP mode (Claude, Cursor, Windsurf आदि के लिए)
493
- brave-real-browser-mcp-server --mode mcp
494
-
495
- # HTTP mode (सभी IDEs के साथ काम करता है)
496
- brave-real-browser-mcp-server --mode http --port 3000
497
-
498
- # LSP mode (Zed, VSCode आदि के लिए)
499
- brave-real-browser-mcp-server --mode lsp
500
- ```
501
-
502
- ---
503
-
504
- ## ⚙️ विशिष्ट IDEs के लिए कॉन्फ़िगरेशन
505
-
506
- ### 1. Claude Desktop
507
-
508
- **फ़ाइल:** `claude_desktop_config.json`
509
-
510
- **स्थान:**
511
- - **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
512
- - **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
513
-
514
- ```json
515
- {
516
- "mcpServers": {
517
- "brave-browser": {
518
- "command": "npx",
519
- "args": ["-y", "brave-real-browser-mcp-server"]
520
- }
521
- }
522
- }
629
+ # Use different port
630
+ npx brave-real-browser-mcp-server@latest --mode http --port 8080
523
631
  ```
524
632
 
525
- ### 2. Cursor AI
526
-
527
- **फ़ाइल:** `cline_mcp_settings.json`
528
-
529
- **स्थान:**
530
- - **Windows:** `%APPDATA%\Cursor\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json`
531
-
532
- ```json
533
- {
534
- "mcpServers": {
535
- "brave-browser": {
536
- "command": "npx",
537
- "args": ["-y", "brave-real-browser-mcp-server"]
538
- }
539
- }
540
- }
541
- ```
542
-
543
- ### 3. HTTP-आधारित IDEs (Qoder AI आदि)
544
-
545
- Server को HTTP mode में start करें:
546
-
547
- ```bash
548
- brave-real-browser-mcp-server --mode http --port 3000
549
- ```
550
-
551
- फिर REST API endpoint का उपयोग करें: `http://localhost:3000`
552
-
553
- ---
633
+ ### CAPTCHA Not Solving
554
634
 
555
- ## 🛠️ सुविधाएँ और उपकरण
556
-
557
- ### 🌐 ब्राउज़र प्रबंधन
558
- - `browser_init` - Anti-detection के साथ Brave browser शुरू करें
559
- - `browser_close` - Browser बंद करें
560
- - `navigate` - URL पर जाएं
561
- - `wait` - Elements/timeout के लिए प्रतीक्षा करें
562
-
563
- ### 🖱️ इंटरैक्शन टूल्स
564
- - `click` - Elements पर क्लिक करें
565
- - `type` - Inputs में text टाइप करें
566
- - `solve_captcha` - CAPTCHA हल करें (reCAPTCHA, hCaptcha, आदि)
567
- - `random_scroll` - मानव-जैसे scrolling
568
-
569
- ### 📄 कंटेंट निष्कर्षण
570
- - `get_content` - Page content निकालें (HTML/Text/Markdown)
571
- - `scrape_table` - Table data निकालें
572
- - `extract_list` - Lists निकालें
573
- - `extract_json` - JSON data निकालें
574
- - `image_scraper` - सभी images निकालें
575
- - `link_harvester` - सभी links निकालें
576
-
577
- ### 🤖 AI-Powered टूल्स
578
- - `smart_selector_generator` - Selectors auto-generate करें
579
- - `content_classification` - Content type classify करें
580
- - `sentiment_analysis` - Sentiment का विश्लेषण करें
581
- - `summary_generator` - Summaries बनाएं
582
-
583
- ### 🔐 CAPTCHA और सुरक्षा
584
- - `solve_captcha` - Multi-CAPTCHA solver
585
- - `ocr_engine` - Text CAPTCHAs के लिए OCR
586
- - `audio_captcha_solver` - Audio CAPTCHA solver
635
+ 1. Ensure CAPTCHA is fully loaded
636
+ 2. Try longer timeout: `{ "timeout": 30000 }`
637
+ 3. Try different CAPTCHA types: `recaptcha`, `hcaptcha`, `turnstile`
587
638
 
588
639
  ---
589
640
 
590
- ## 💡 उपयोग उदाहरण
641
+ ## 📊 Supported Protocols
591
642
 
592
- ### उदाहरण 1: साधारण Web Scraping
593
-
594
- ```javascript
595
- // Browser initialize करें
596
- await use_mcp_tool({
597
- server_name: "brave-browser",
598
- tool_name: "browser_init",
599
- arguments: {}
600
- });
601
-
602
- // Website पर जाएं
603
- await use_mcp_tool({
604
- server_name: "brave-browser",
605
- tool_name: "navigate",
606
- arguments: { url: "https://example.com" }
607
- });
608
-
609
- // Content प्राप्त करें
610
- await use_mcp_tool({
611
- server_name: "brave-browser",
612
- tool_name: "get_content",
613
- arguments: { type: "text" }
614
- });
615
- ```
643
+ | Protocol | Used By | Auto-Config | Status |
644
+ |----------|---------|-------------|--------|
645
+ | **MCP (STDIO)** | Claude Desktop, Cursor, Windsurf, Cline, Warp | ✅ | 🟢 Working |
646
+ | **LSP** | Zed Editor, VSCode, Neovim | ✅ | 🟢 Working |
647
+ | **HTTP/REST** | Any IDE/Tool | ✅ | 🟢 Working |
648
+ | **WebSocket** | Modern Web Apps, Real-time Tools | ✅ | 🟢 Working |
616
649
 
617
650
  ---
618
651
 
619
- ## 📋 आवश्यकताएं
652
+ ## 📋 Requirements
620
653
 
621
654
  - **Node.js** >= 18.0.0
622
- - **Brave Browser** (auto-detected या path specify करें)
623
- - **Operating System:** Windows, macOS, या Linux
624
-
625
- ---
626
-
627
- ## 🐛 समस्या निवारण
628
-
629
- ### Brave Browser नहीं मिला
630
-
631
- **समाधान:** Environment variable सेट करें
632
- ```bash
633
- # Windows
634
- set BRAVE_PATH="C:\Program Files\BraveSoftware\Brave-Browser\Application\brave.exe"
635
-
636
- # Linux/macOS
637
- export BRAVE_PATH="/usr/bin/brave-browser"
638
- ```
639
-
640
- ### Server शुरू नहीं हो रहा
641
-
642
- 1. Node.js version check करें: `node --version` (>= 18 होना चाहिए)
643
- 2. NPM cache clear करें: `npm cache clean --force`
644
- 3. फिर से install करें: `npm install -g brave-real-browser-mcp-server`
655
+ - **Brave Browser** (auto-detected or specify path)
656
+ - **Operating System:** Windows, macOS, Linux
645
657
 
646
658
  ---
647
659
 
648
- ## 🤝 योगदान
660
+ ## 🤝 Contributing
649
661
 
650
- Contributions स्वागत है! कृपया Pull Request submit करें।
662
+ Contributions are welcome! Please submit a Pull Request.
651
663
 
652
664
  ---
653
665
 
654
- ## 📄 लाइसेंस
666
+ ## 📄 License
655
667
 
656
- यह प्रोजेक्ट MIT License के तहत लाइसेंस प्राप्त है।
668
+ MIT License - See LICENSE file for details.
657
669
 
658
670
  ---
659
671
 
660
- ## 🌟 मुख्य विशेषताएं
672
+ ## 🔗 Links
661
673
 
662
- ✅ **15+ AI IDEs समर्थित** - Claude, Cursor, Windsurf, Cline, Zed, VSCode, Qoder AI, और अधिक
663
- ✅ **Auto-Detection** - आपका IDE automatically detect होता है
664
- ✅ **4 Protocols** - MCP, LSP, HTTP, WebSocket
665
- ✅ **100+ Tools** - Browser automation, scraping, CAPTCHA solving
666
- ✅ **Anti-Detection** - Cloudflare, reCAPTCHA bypass
667
- ✅ **Cross-Platform** - Windows, macOS, Linux
674
+ - **GitHub:** https://github.com/codeiva4u/Brave-Real-Browser-Mcp-Server
675
+ - **NPM:** https://www.npmjs.com/package/brave-real-browser-mcp-server
676
+ - **Issues:** https://github.com/codeiva4u/Brave-Real-Browser-Mcp-Server/issues
668
677
 
669
678
  ---
670
679
 
671
680
  <div align="center">
672
681
 
682
+ **🌟 111 Tools | 15+ AI IDEs | 3 Protocols | Universal Support 🌟**
683
+
673
684
  **Made with ❤️ for the AI Development Community**
674
685
 
675
- [⭐ Star on GitHub](https://github.com/withLinda/brave-real-browser-mcp-server) | [🐛 Report Bug](https://github.com/withLinda/brave-real-browser-mcp-server/issues) | [💡 Request Feature](https://github.com/withLinda/brave-real-browser-mcp-server/issues)
686
+ [⭐ Star on GitHub](https://github.com/codeiva4u/Brave-Real-Browser-Mcp-Server) | [🐛 Report Bug](https://github.com/codeiva4u/Brave-Real-Browser-Mcp-Server/issues) | [💡 Request Feature](https://github.com/codeiva4u/Brave-Real-Browser-Mcp-Server/issues)
676
687
 
677
- </div>
688
+ </div>
689
+ | **MCP (STDIO)** | Claude Desktop,
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "brave-real-browser-mcp-server",
3
- "version": "2.12.0",
3
+ "version": "2.12.3",
4
4
  "description": "Universal AI IDE MCP Server - Auto-detects and supports all AI IDEs (Claude Desktop, Cursor, Windsurf, Cline, Zed, VSCode, Qoder AI, etc.) with Brave browser automation",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",