brave-real-browser-mcp-server 2.12.3 → 2.12.4
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.
- package/README.md +180 -165
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
# 🌐 Brave Real Browser MCP Server
|
|
2
|
+
|
|
2
3
|
## Universal AI IDE Support with Advanced Browser Automation
|
|
3
4
|
|
|
4
5
|
<div align="center">
|
|
@@ -58,6 +59,7 @@ npx brave-real-browser-mcp-server@latest
|
|
|
58
59
|
```
|
|
59
60
|
|
|
60
61
|
**Config file locations:**
|
|
62
|
+
|
|
61
63
|
- **Claude Desktop:** `%APPDATA%\Claude\claude_desktop_config.json` (Windows) or `~/Library/Application Support/Claude/claude_desktop_config.json` (Mac)
|
|
62
64
|
- **Cursor:** `%APPDATA%\Cursor\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json`
|
|
63
65
|
- **Windsurf:** `%APPDATA%\Windsurf\mcp.json`
|
|
@@ -88,6 +90,7 @@ npx brave-real-browser-mcp-server@latest --mode http --port 3000 --no-websocket
|
|
|
88
90
|
```
|
|
89
91
|
|
|
90
92
|
**Server will start and show:**
|
|
93
|
+
|
|
91
94
|
```
|
|
92
95
|
🟢 [HTTP] Starting HTTP/WebSocket server...
|
|
93
96
|
✅ [HTTP] Server ready at http://localhost:3000
|
|
@@ -107,6 +110,7 @@ curl http://localhost:3000/tools
|
|
|
107
110
|
#### Step 5: Configure in Your IDE
|
|
108
111
|
|
|
109
112
|
**For Qoder AI:**
|
|
113
|
+
|
|
110
114
|
```json
|
|
111
115
|
{
|
|
112
116
|
"extensions": {
|
|
@@ -143,6 +147,7 @@ npx brave-real-browser-mcp-server@latest --mode http --port 3000
|
|
|
143
147
|
**File:** `claude_desktop_config.json`
|
|
144
148
|
|
|
145
149
|
**Location:**
|
|
150
|
+
|
|
146
151
|
- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
|
|
147
152
|
- Mac: `~/Library/Application Support/Claude/claude_desktop_config.json`
|
|
148
153
|
- Linux: `~/.config/Claude/claude_desktop_config.json`
|
|
@@ -163,6 +168,7 @@ npx brave-real-browser-mcp-server@latest --mode http --port 3000
|
|
|
163
168
|
**File:** `cline_mcp_settings.json`
|
|
164
169
|
|
|
165
170
|
**Location:**
|
|
171
|
+
|
|
166
172
|
- Windows: `%APPDATA%\Cursor\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json`
|
|
167
173
|
- Mac: `~/Library/Application Support/Cursor/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json`
|
|
168
174
|
|
|
@@ -185,6 +191,7 @@ npx brave-real-browser-mcp-server@latest --mode http --port 3000
|
|
|
185
191
|
**File:** `mcp.json`
|
|
186
192
|
|
|
187
193
|
**Location:**
|
|
194
|
+
|
|
188
195
|
- Windows: `%APPDATA%\Windsurf\mcp.json`
|
|
189
196
|
- Mac: `~/.windsurf/mcp.json`
|
|
190
197
|
|
|
@@ -204,6 +211,7 @@ npx brave-real-browser-mcp-server@latest --mode http --port 3000
|
|
|
204
211
|
**File:** `cline_mcp_settings.json`
|
|
205
212
|
|
|
206
213
|
**Location:**
|
|
214
|
+
|
|
207
215
|
- Windows: `%APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json`
|
|
208
216
|
- Mac: `~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json`
|
|
209
217
|
|
|
@@ -223,20 +231,26 @@ npx brave-real-browser-mcp-server@latest --mode http --port 3000
|
|
|
223
231
|
**File:** `settings.json`
|
|
224
232
|
|
|
225
233
|
**Location:**
|
|
234
|
+
|
|
226
235
|
- Windows: `%APPDATA%\Zed\settings.json`
|
|
227
236
|
- Mac: `~/.config/zed/settings.json`
|
|
228
237
|
|
|
229
238
|
```json
|
|
230
239
|
{
|
|
231
|
-
"
|
|
240
|
+
"context_servers": {
|
|
232
241
|
"brave-real-browser": {
|
|
233
|
-
"command":
|
|
234
|
-
|
|
242
|
+
"command": {
|
|
243
|
+
"path": "npx",
|
|
244
|
+
"args": ["-y", "brave-real-browser-mcp-server@latest"]
|
|
245
|
+
},
|
|
246
|
+
"settings": {}
|
|
235
247
|
}
|
|
236
248
|
}
|
|
237
249
|
}
|
|
238
250
|
```
|
|
239
251
|
|
|
252
|
+
**Note:** Zed uses `context_servers` (not `lsp`) for MCP servers. Make sure you're using Zed Preview version for MCP support.
|
|
253
|
+
|
|
240
254
|
### Qoder AI / HTTP-based IDEs
|
|
241
255
|
|
|
242
256
|
Start server in HTTP mode and configure:
|
|
@@ -256,210 +270,209 @@ Start server in HTTP mode and configure:
|
|
|
256
270
|
|
|
257
271
|
---
|
|
258
272
|
|
|
259
|
-
|
|
260
273
|
## 🛠️ Available Tools (111)
|
|
261
274
|
|
|
262
275
|
### 🌐 Browser Management (2 tools)
|
|
263
276
|
|
|
264
|
-
| Tool
|
|
265
|
-
|
|
266
|
-
| `browser_init`
|
|
267
|
-
| `browser_close` | Close browser instance
|
|
277
|
+
| Tool | Description |
|
|
278
|
+
| --------------- | ----------------------------------------------- |
|
|
279
|
+
| `browser_init` | Initialize browser with anti-detection features |
|
|
280
|
+
| `browser_close` | Close browser instance |
|
|
268
281
|
|
|
269
282
|
### 🧭 Navigation (2 tools)
|
|
270
283
|
|
|
271
|
-
| Tool
|
|
272
|
-
|
|
273
|
-
| `navigate` | Navigate to URL with wait conditions
|
|
274
|
-
| `wait`
|
|
284
|
+
| Tool | Description |
|
|
285
|
+
| ---------- | ----------------------------------------- |
|
|
286
|
+
| `navigate` | Navigate to URL with wait conditions |
|
|
287
|
+
| `wait` | Wait for selector, navigation, or timeout |
|
|
275
288
|
|
|
276
289
|
### 🖱️ Interactions (4 tools)
|
|
277
290
|
|
|
278
|
-
| Tool
|
|
279
|
-
|
|
280
|
-
| `click`
|
|
281
|
-
| `type`
|
|
282
|
-
| `random_scroll` | Human-like scrolling
|
|
291
|
+
| Tool | Description |
|
|
292
|
+
| --------------- | ---------------------------------------------------- |
|
|
293
|
+
| `click` | Click on elements |
|
|
294
|
+
| `type` | Type text into inputs |
|
|
295
|
+
| `random_scroll` | Human-like scrolling |
|
|
283
296
|
| `solve_captcha` | Solve CAPTCHA (reCAPTCHA, hCaptcha, Turnstile, etc.) |
|
|
284
297
|
|
|
285
298
|
### 📄 Content Extraction (10 tools)
|
|
286
299
|
|
|
287
|
-
| Tool
|
|
288
|
-
|
|
289
|
-
| `get_content`
|
|
290
|
-
| `find_selector`
|
|
291
|
-
| `scrape_table`
|
|
292
|
-
| `extract_list`
|
|
293
|
-
| `extract_json`
|
|
294
|
-
| `scrape_meta_tags`
|
|
295
|
-
| `extract_schema`
|
|
296
|
-
| `save_content_as_markdown` | Save page as markdown file
|
|
297
|
-
| `html_to_text`
|
|
298
|
-
| `smart_text_cleaner`
|
|
300
|
+
| Tool | Description |
|
|
301
|
+
| -------------------------- | ----------------------------------------- |
|
|
302
|
+
| `get_content` | Extract page content (HTML/Text/Markdown) |
|
|
303
|
+
| `find_selector` | Find CSS selectors for elements |
|
|
304
|
+
| `scrape_table` | Extract table data with headers |
|
|
305
|
+
| `extract_list` | Extract list items |
|
|
306
|
+
| `extract_json` | Extract JSON data from page |
|
|
307
|
+
| `scrape_meta_tags` | Extract meta tags and SEO info |
|
|
308
|
+
| `extract_schema` | Extract schema.org structured data |
|
|
309
|
+
| `save_content_as_markdown` | Save page as markdown file |
|
|
310
|
+
| `html_to_text` | Convert HTML to clean text |
|
|
311
|
+
| `smart_text_cleaner` | Clean and normalize text |
|
|
299
312
|
|
|
300
313
|
### 🔍 Multi-Element Extraction (8 tools)
|
|
301
314
|
|
|
302
|
-
| Tool
|
|
303
|
-
|
|
304
|
-
| `batch_element_scraper`
|
|
305
|
-
| `nested_data_extraction`
|
|
306
|
-
| `attribute_harvester`
|
|
307
|
-
| `image_scraper`
|
|
308
|
-
| `link_harvester`
|
|
309
|
-
| `media_extractor`
|
|
310
|
-
| `pdf_link_finder`
|
|
311
|
-
| `html_elements_extractor` | Extract specific HTML elements
|
|
315
|
+
| Tool | Description |
|
|
316
|
+
| ------------------------- | --------------------------------- |
|
|
317
|
+
| `batch_element_scraper` | Scrape multiple elements at once |
|
|
318
|
+
| `nested_data_extraction` | Extract nested data structures |
|
|
319
|
+
| `attribute_harvester` | Extract element attributes |
|
|
320
|
+
| `image_scraper` | Extract all images with metadata |
|
|
321
|
+
| `link_harvester` | Extract all links from page |
|
|
322
|
+
| `media_extractor` | Extract media files (audio/video) |
|
|
323
|
+
| `pdf_link_finder` | Find PDF download links |
|
|
324
|
+
| `html_elements_extractor` | Extract specific HTML elements |
|
|
312
325
|
|
|
313
326
|
### 🎯 Advanced Extraction (10 tools)
|
|
314
327
|
|
|
315
|
-
| Tool
|
|
316
|
-
|
|
317
|
-
| `tags_finder`
|
|
318
|
-
| `links_finder`
|
|
319
|
-
| `xpath_links`
|
|
320
|
-
| `ajax_extractor`
|
|
321
|
-
| `fetch_xhr`
|
|
322
|
-
| `network_recorder`
|
|
323
|
-
| `api_finder`
|
|
324
|
-
| `regex_pattern_finder` | Find patterns using regex
|
|
325
|
-
| `iframe_extractor`
|
|
326
|
-
| `embed_page_extractor` | Extract embedded pages
|
|
328
|
+
| Tool | Description |
|
|
329
|
+
| ---------------------- | ---------------------------- |
|
|
330
|
+
| `tags_finder` | Find elements by tag name |
|
|
331
|
+
| `links_finder` | Advanced link extraction |
|
|
332
|
+
| `xpath_links` | Extract links using XPath |
|
|
333
|
+
| `ajax_extractor` | Extract AJAX/dynamic content |
|
|
334
|
+
| `fetch_xhr` | Capture XHR/Fetch requests |
|
|
335
|
+
| `network_recorder` | Record all network traffic |
|
|
336
|
+
| `api_finder` | Discover API endpoints |
|
|
337
|
+
| `regex_pattern_finder` | Find patterns using regex |
|
|
338
|
+
| `iframe_extractor` | Extract iframe content |
|
|
339
|
+
| `embed_page_extractor` | Extract embedded pages |
|
|
327
340
|
|
|
328
341
|
### 🎬 Video & Media Tools (19 tools)
|
|
329
342
|
|
|
330
|
-
| Tool
|
|
331
|
-
|
|
332
|
-
| `video_link_finder`
|
|
333
|
-
| `video_download_page`
|
|
334
|
-
| `video_download_button`
|
|
335
|
-
| `video_play_push_source`
|
|
336
|
-
| `video_play_button_click`
|
|
337
|
-
| `url_redirect_trace_endpoints`
|
|
338
|
-
| `network_recording_finder`
|
|
339
|
-
| `network_recording_extractors`
|
|
340
|
-
| `video_links_finders`
|
|
341
|
-
| `videos_selectors`
|
|
342
|
-
| `link_process_extracts`
|
|
343
|
-
| `video_link_finders_extracts`
|
|
344
|
-
| `video_download_button_finders` | Find all download buttons
|
|
345
|
-
| `advanced_video_extraction`
|
|
346
|
-
| `image_extractor_advanced`
|
|
347
|
-
| `video_source_extractor`
|
|
348
|
-
| `video_player_extractor`
|
|
349
|
-
| `video_player_hoster_finder`
|
|
350
|
-
| `original_video_hoster_finder`
|
|
343
|
+
| Tool | Description |
|
|
344
|
+
| ------------------------------- | ---------------------------------------- |
|
|
345
|
+
| `video_link_finder` | Find video URLs |
|
|
346
|
+
| `video_download_page` | Navigate to video download page |
|
|
347
|
+
| `video_download_button` | Find video download buttons |
|
|
348
|
+
| `video_play_push_source` | Get video play sources |
|
|
349
|
+
| `video_play_button_click` | Click video play button |
|
|
350
|
+
| `url_redirect_trace_endpoints` | Trace URL redirects |
|
|
351
|
+
| `network_recording_finder` | Find network recordings |
|
|
352
|
+
| `network_recording_extractors` | Extract network data |
|
|
353
|
+
| `video_links_finders` | Multiple video link finders |
|
|
354
|
+
| `videos_selectors` | Video element selectors |
|
|
355
|
+
| `link_process_extracts` | Process and extract links |
|
|
356
|
+
| `video_link_finders_extracts` | Advanced video link extraction |
|
|
357
|
+
| `video_download_button_finders` | Find all download buttons |
|
|
358
|
+
| `advanced_video_extraction` | Advanced video extraction with ad-bypass |
|
|
359
|
+
| `image_extractor_advanced` | Advanced image extraction |
|
|
360
|
+
| `video_source_extractor` | Extract video source URLs |
|
|
361
|
+
| `video_player_extractor` | Extract video player info |
|
|
362
|
+
| `video_player_hoster_finder` | Find video hosting platform |
|
|
363
|
+
| `original_video_hoster_finder` | Find original video source |
|
|
351
364
|
|
|
352
365
|
### 🔐 CAPTCHA & Security (4 tools)
|
|
353
366
|
|
|
354
|
-
| Tool
|
|
355
|
-
|
|
356
|
-
| `solve_captcha`
|
|
357
|
-
| `ocr_engine`
|
|
358
|
-
| `audio_captcha_solver`
|
|
359
|
-
| `puzzle_captcha_handler` | Handle puzzle CAPTCHAs
|
|
367
|
+
| Tool | Description |
|
|
368
|
+
| ------------------------ | ------------------------------------------------------------------- |
|
|
369
|
+
| `solve_captcha` | Multi-CAPTCHA solver (reCAPTCHA, hCaptcha, Turnstile, Arkose, etc.) |
|
|
370
|
+
| `ocr_engine` | OCR for text-based CAPTCHAs |
|
|
371
|
+
| `audio_captcha_solver` | Solve audio CAPTCHAs |
|
|
372
|
+
| `puzzle_captcha_handler` | Handle puzzle CAPTCHAs |
|
|
360
373
|
|
|
361
374
|
### 🔧 Data Processing (9 tools)
|
|
362
375
|
|
|
363
|
-
| Tool
|
|
364
|
-
|
|
365
|
-
| `price_parser`
|
|
366
|
-
| `date_normalizer`
|
|
367
|
-
| `contact_extractor`
|
|
368
|
-
| `schema_validator`
|
|
369
|
-
| `required_fields_checker` | Check for required fields
|
|
370
|
-
| `duplicate_remover`
|
|
371
|
-
| `data_deduplication`
|
|
372
|
-
| `missing_data_handler`
|
|
373
|
-
| `data_type_validator`
|
|
376
|
+
| Tool | Description |
|
|
377
|
+
| ------------------------- | ---------------------------------- |
|
|
378
|
+
| `price_parser` | Extract and parse prices |
|
|
379
|
+
| `date_normalizer` | Normalize dates to standard format |
|
|
380
|
+
| `contact_extractor` | Extract contact information |
|
|
381
|
+
| `schema_validator` | Validate data against schema |
|
|
382
|
+
| `required_fields_checker` | Check for required fields |
|
|
383
|
+
| `duplicate_remover` | Remove duplicate entries |
|
|
384
|
+
| `data_deduplication` | Advanced deduplication |
|
|
385
|
+
| `missing_data_handler` | Handle missing data |
|
|
386
|
+
| `data_type_validator` | Validate data types |
|
|
374
387
|
|
|
375
388
|
### 📊 Data Quality (3 tools)
|
|
376
389
|
|
|
377
|
-
| Tool
|
|
378
|
-
|
|
379
|
-
| `outlier_detection`
|
|
380
|
-
| `consistency_checker`
|
|
390
|
+
| Tool | Description |
|
|
391
|
+
| ---------------------- | ------------------------ |
|
|
392
|
+
| `outlier_detection` | Detect data outliers |
|
|
393
|
+
| `consistency_checker` | Check data consistency |
|
|
381
394
|
| `data_quality_metrics` | Generate quality metrics |
|
|
382
395
|
|
|
383
396
|
### 🤖 AI-Powered Tools (5 tools)
|
|
384
397
|
|
|
385
|
-
| Tool
|
|
386
|
-
|
|
398
|
+
| Tool | Description |
|
|
399
|
+
| -------------------------- | --------------------------- |
|
|
387
400
|
| `smart_selector_generator` | Auto-generate CSS selectors |
|
|
388
|
-
| `content_classification`
|
|
389
|
-
| `sentiment_analysis`
|
|
390
|
-
| `summary_generator`
|
|
391
|
-
| `translation_support`
|
|
401
|
+
| `content_classification` | Classify content type |
|
|
402
|
+
| `sentiment_analysis` | Analyze text sentiment |
|
|
403
|
+
| `summary_generator` | Generate content summaries |
|
|
404
|
+
| `translation_support` | Translate content |
|
|
392
405
|
|
|
393
406
|
### 🔎 Search & Filter (5 tools)
|
|
394
407
|
|
|
395
|
-
| Tool
|
|
396
|
-
|
|
397
|
-
| `keyword_search`
|
|
398
|
-
| `regex_pattern_matcher`
|
|
399
|
-
| `xpath_support`
|
|
408
|
+
| Tool | Description |
|
|
409
|
+
| ------------------------ | ----------------------------- |
|
|
410
|
+
| `keyword_search` | Search for keywords in page |
|
|
411
|
+
| `regex_pattern_matcher` | Match regex patterns |
|
|
412
|
+
| `xpath_support` | XPath query support |
|
|
400
413
|
| `advanced_css_selectors` | Advanced CSS selector queries |
|
|
401
|
-
| `visual_element_finder`
|
|
414
|
+
| `visual_element_finder` | Find elements visually |
|
|
402
415
|
|
|
403
416
|
### 📑 Pagination & Navigation (5 tools)
|
|
404
417
|
|
|
405
|
-
| Tool
|
|
406
|
-
|
|
407
|
-
| `auto_pagination`
|
|
408
|
-
| `infinite_scroll`
|
|
409
|
-
| `multi_page_scraper`
|
|
410
|
-
| `sitemap_parser`
|
|
411
|
-
| `breadcrumb_navigator` | Navigate using breadcrumbs
|
|
418
|
+
| Tool | Description |
|
|
419
|
+
| ---------------------- | --------------------------- |
|
|
420
|
+
| `auto_pagination` | Auto-paginate through pages |
|
|
421
|
+
| `infinite_scroll` | Handle infinite scroll |
|
|
422
|
+
| `multi_page_scraper` | Scrape multiple pages |
|
|
423
|
+
| `sitemap_parser` | Parse and navigate sitemaps |
|
|
424
|
+
| `breadcrumb_navigator` | Navigate using breadcrumbs |
|
|
412
425
|
|
|
413
426
|
### 🔒 Session Management (7 tools)
|
|
414
427
|
|
|
415
|
-
| Tool
|
|
416
|
-
|
|
417
|
-
| `cookie_manager`
|
|
418
|
-
| `session_persistence`
|
|
419
|
-
| `form_auto_fill`
|
|
420
|
-
| `ajax_content_waiter`
|
|
421
|
-
| `modal_popup_handler`
|
|
422
|
-
| `login_session_manager` | Manage login sessions
|
|
423
|
-
| `shadow_dom_extractor`
|
|
428
|
+
| Tool | Description |
|
|
429
|
+
| ----------------------- | -------------------------- |
|
|
430
|
+
| `cookie_manager` | Manage cookies |
|
|
431
|
+
| `session_persistence` | Persist sessions |
|
|
432
|
+
| `form_auto_fill` | Auto-fill forms |
|
|
433
|
+
| `ajax_content_waiter` | Wait for AJAX content |
|
|
434
|
+
| `modal_popup_handler` | Handle modal popups |
|
|
435
|
+
| `login_session_manager` | Manage login sessions |
|
|
436
|
+
| `shadow_dom_extractor` | Extract Shadow DOM content |
|
|
424
437
|
|
|
425
438
|
### 📸 Visual Tools (5 tools)
|
|
426
439
|
|
|
427
|
-
| Tool
|
|
428
|
-
|
|
429
|
-
| `full_page_screenshot` | Full page screenshot
|
|
430
|
-
| `element_screenshot`
|
|
431
|
-
| `pdf_generation`
|
|
432
|
-
| `video_recording`
|
|
433
|
-
| `visual_comparison`
|
|
440
|
+
| Tool | Description |
|
|
441
|
+
| ---------------------- | --------------------------- |
|
|
442
|
+
| `full_page_screenshot` | Full page screenshot |
|
|
443
|
+
| `element_screenshot` | Screenshot specific element |
|
|
444
|
+
| `pdf_generation` | Generate PDF from page |
|
|
445
|
+
| `video_recording` | Record page as video |
|
|
446
|
+
| `visual_comparison` | Compare screenshots |
|
|
434
447
|
|
|
435
448
|
### 📈 Monitoring & Reporting (6 tools)
|
|
436
449
|
|
|
437
|
-
| Tool
|
|
438
|
-
|
|
439
|
-
| `progress_tracker`
|
|
440
|
-
| `error_logger`
|
|
441
|
-
| `success_rate_reporter` | Report success rates
|
|
442
|
-
| `data_quality_metrics`
|
|
443
|
-
| `performance_monitor`
|
|
444
|
-
| `monitoring_summary`
|
|
450
|
+
| Tool | Description |
|
|
451
|
+
| ----------------------- | ------------------------- |
|
|
452
|
+
| `progress_tracker` | Track automation progress |
|
|
453
|
+
| `error_logger` | Log errors |
|
|
454
|
+
| `success_rate_reporter` | Report success rates |
|
|
455
|
+
| `data_quality_metrics` | Data quality metrics |
|
|
456
|
+
| `performance_monitor` | Monitor performance |
|
|
457
|
+
| `monitoring_summary` | Get monitoring summary |
|
|
445
458
|
|
|
446
459
|
### 🌐 API Integration (3 tools)
|
|
447
460
|
|
|
448
|
-
| Tool
|
|
449
|
-
|
|
450
|
-
| `rest_api_endpoint_finder` | Find REST API endpoints
|
|
451
|
-
| `webhook_support`
|
|
452
|
-
| `all_website_api_finder`
|
|
461
|
+
| Tool | Description |
|
|
462
|
+
| -------------------------- | ------------------------ |
|
|
463
|
+
| `rest_api_endpoint_finder` | Find REST API endpoints |
|
|
464
|
+
| `webhook_support` | Webhook integration |
|
|
465
|
+
| `all_website_api_finder` | Find all APIs on website |
|
|
453
466
|
|
|
454
467
|
### 🛡️ Advanced Extraction & Obfuscation (5 tools)
|
|
455
468
|
|
|
456
|
-
| Tool
|
|
457
|
-
|
|
458
|
-
| `deobfuscate_js`
|
|
469
|
+
| Tool | Description |
|
|
470
|
+
| ---------------------------- | --------------------------- |
|
|
471
|
+
| `deobfuscate_js` | Deobfuscate JavaScript |
|
|
459
472
|
| `multi_layer_redirect_trace` | Trace multi-layer redirects |
|
|
460
|
-
| `ad_protection_detector`
|
|
461
|
-
| `url_redirect_tracer`
|
|
462
|
-
| `user_agent_extractor`
|
|
473
|
+
| `ad_protection_detector` | Detect ad protection |
|
|
474
|
+
| `url_redirect_tracer` | Trace URL redirects |
|
|
475
|
+
| `user_agent_extractor` | Extract user agent info |
|
|
463
476
|
|
|
464
477
|
---
|
|
465
478
|
|
|
@@ -472,19 +485,19 @@ Start server in HTTP mode and configure:
|
|
|
472
485
|
await use_mcp_tool({
|
|
473
486
|
server_name: "brave-real-browser",
|
|
474
487
|
tool_name: "browser_init",
|
|
475
|
-
arguments: {}
|
|
488
|
+
arguments: {},
|
|
476
489
|
});
|
|
477
490
|
|
|
478
491
|
await use_mcp_tool({
|
|
479
492
|
server_name: "brave-real-browser",
|
|
480
493
|
tool_name: "navigate",
|
|
481
|
-
arguments: { url: "https://example.com" }
|
|
494
|
+
arguments: { url: "https://example.com" },
|
|
482
495
|
});
|
|
483
496
|
|
|
484
497
|
await use_mcp_tool({
|
|
485
498
|
server_name: "brave-real-browser",
|
|
486
499
|
tool_name: "get_content",
|
|
487
|
-
arguments: { type: "text" }
|
|
500
|
+
arguments: { type: "text" },
|
|
488
501
|
});
|
|
489
502
|
```
|
|
490
503
|
|
|
@@ -495,21 +508,21 @@ await use_mcp_tool({
|
|
|
495
508
|
await use_mcp_tool({
|
|
496
509
|
server_name: "brave-real-browser",
|
|
497
510
|
tool_name: "navigate",
|
|
498
|
-
arguments: { url: "https://site-with-captcha.com" }
|
|
511
|
+
arguments: { url: "https://site-with-captcha.com" },
|
|
499
512
|
});
|
|
500
513
|
|
|
501
514
|
// Solve CAPTCHA
|
|
502
515
|
await use_mcp_tool({
|
|
503
516
|
server_name: "brave-real-browser",
|
|
504
517
|
tool_name: "solve_captcha",
|
|
505
|
-
arguments: { type: "recaptcha" }
|
|
518
|
+
arguments: { type: "recaptcha" },
|
|
506
519
|
});
|
|
507
520
|
|
|
508
521
|
// Continue automation
|
|
509
522
|
await use_mcp_tool({
|
|
510
523
|
server_name: "brave-real-browser",
|
|
511
524
|
tool_name: "click",
|
|
512
|
-
arguments: { selector: "button.submit" }
|
|
525
|
+
arguments: { selector: "button.submit" },
|
|
513
526
|
});
|
|
514
527
|
```
|
|
515
528
|
|
|
@@ -520,21 +533,21 @@ await use_mcp_tool({
|
|
|
520
533
|
await use_mcp_tool({
|
|
521
534
|
server_name: "brave-real-browser",
|
|
522
535
|
tool_name: "navigate",
|
|
523
|
-
arguments: { url: "https://video-site.com/video/123" }
|
|
536
|
+
arguments: { url: "https://video-site.com/video/123" },
|
|
524
537
|
});
|
|
525
538
|
|
|
526
539
|
// Find video links
|
|
527
540
|
await use_mcp_tool({
|
|
528
541
|
server_name: "brave-real-browser",
|
|
529
542
|
tool_name: "video_link_finder",
|
|
530
|
-
arguments: {}
|
|
543
|
+
arguments: {},
|
|
531
544
|
});
|
|
532
545
|
|
|
533
546
|
// Advanced video extraction with ad bypass
|
|
534
547
|
await use_mcp_tool({
|
|
535
548
|
server_name: "brave-real-browser",
|
|
536
549
|
tool_name: "advanced_video_extraction",
|
|
537
|
-
arguments: {}
|
|
550
|
+
arguments: {},
|
|
538
551
|
});
|
|
539
552
|
```
|
|
540
553
|
|
|
@@ -545,7 +558,7 @@ await use_mcp_tool({
|
|
|
545
558
|
await use_mcp_tool({
|
|
546
559
|
server_name: "brave-real-browser",
|
|
547
560
|
tool_name: "browser_init",
|
|
548
|
-
arguments: {}
|
|
561
|
+
arguments: {},
|
|
549
562
|
});
|
|
550
563
|
|
|
551
564
|
// Auto-paginate through all pages
|
|
@@ -554,8 +567,8 @@ await use_mcp_tool({
|
|
|
554
567
|
tool_name: "multi_page_scraper",
|
|
555
568
|
arguments: {
|
|
556
569
|
startUrl: "https://example.com/page/1",
|
|
557
|
-
maxPages: 10
|
|
558
|
-
}
|
|
570
|
+
maxPages: 10,
|
|
571
|
+
},
|
|
559
572
|
});
|
|
560
573
|
```
|
|
561
574
|
|
|
@@ -578,6 +591,7 @@ POST /browser/close - Close browser
|
|
|
578
591
|
```
|
|
579
592
|
|
|
580
593
|
**Example:**
|
|
594
|
+
|
|
581
595
|
```bash
|
|
582
596
|
curl -X POST http://localhost:3000/tools/navigate \
|
|
583
597
|
-H "Content-Type: application/json" \
|
|
@@ -609,6 +623,7 @@ HTTP_PORT=3000
|
|
|
609
623
|
### Brave Browser Not Found
|
|
610
624
|
|
|
611
625
|
**Solution:**
|
|
626
|
+
|
|
612
627
|
```bash
|
|
613
628
|
# Windows
|
|
614
629
|
set BRAVE_PATH="C:\Program Files\BraveSoftware\Brave-Browser\Application\brave.exe"
|
|
@@ -640,12 +655,12 @@ npx brave-real-browser-mcp-server@latest --mode http --port 8080
|
|
|
640
655
|
|
|
641
656
|
## 📊 Supported Protocols
|
|
642
657
|
|
|
643
|
-
| Protocol
|
|
644
|
-
|
|
645
|
-
| **MCP (STDIO)** | Claude Desktop, Cursor, Windsurf, Cline, Warp | ✅
|
|
646
|
-
| **LSP**
|
|
647
|
-
| **HTTP/REST**
|
|
648
|
-
| **WebSocket**
|
|
658
|
+
| Protocol | Used By | Auto-Config | Status |
|
|
659
|
+
| --------------- | --------------------------------------------- | ----------- | ---------- |
|
|
660
|
+
| **MCP (STDIO)** | Claude Desktop, Cursor, Windsurf, Cline, Warp | ✅ | 🟢 Working |
|
|
661
|
+
| **LSP** | Zed Editor, VSCode, Neovim | ✅ | 🟢 Working |
|
|
662
|
+
| **HTTP/REST** | Any IDE/Tool | ✅ | 🟢 Working |
|
|
663
|
+
| **WebSocket** | Modern Web Apps, Real-time Tools | ✅ | 🟢 Working |
|
|
649
664
|
|
|
650
665
|
---
|
|
651
666
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "brave-real-browser-mcp-server",
|
|
3
|
-
"version": "2.12.
|
|
3
|
+
"version": "2.12.4",
|
|
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",
|