brave-real-browser-mcp-server 2.12.2 → 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 +471 -445
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,68 +1,33 @@
|
|
|
1
|
-
# 🌐 Brave Real Browser MCP Server
|
|
1
|
+
# 🌐 Brave Real Browser MCP Server
|
|
2
|
+
|
|
3
|
+
## Universal AI IDE Support with Advanced Browser Automation
|
|
2
4
|
|
|
3
5
|
<div align="center">
|
|
4
6
|
|
|
5
|
-

|
|
6
8
|

|
|
7
|
-

|
|
10
|
+

|
|
11
|
+

|
|
10
12
|
|
|
11
|
-
**सभी AI IDEs के लिए Universal MCP Server | Browser Automation | Web Scraping | CAPTCHA Solving**
|
|
13
|
+
**सभी AI IDEs के लिए Universal MCP Server | 111+ Tools | Browser Automation | Web Scraping | CAPTCHA Solving**
|
|
12
14
|
|
|
13
|
-
[
|
|
15
|
+
[Installation](#-installation) | [Quick Start](#-quick-start) | [Tools](#-available-tools-111) | [HTTP/WebSocket](#-httpwebsocket-setup) | [Configuration](#-ide-configurations)
|
|
14
16
|
|
|
15
17
|
</div>
|
|
16
18
|
|
|
17
19
|
---
|
|
18
20
|
|
|
19
|
-
## 🎯 What
|
|
20
|
-
|
|
21
|
-
**यह प्रोजेक्ट सभी AI IDEs में स्वचालित रूप से काम करता है!**
|
|
21
|
+
## 🎯 What is This?
|
|
22
22
|
|
|
23
|
-
|
|
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
|
-
---
|
|
23
|
+
**Brave Real Browser MCP Server** एक powerful automation tool है जो:
|
|
31
24
|
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
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
|
|
25
|
+
- ✅ **15+ AI IDEs में काम करता है** (Claude, Cursor, Windsurf, Cline, Zed, VSCode, Qoder AI, etc.)
|
|
26
|
+
- ✅ **111+ Automation Tools** - Browser control, scraping, CAPTCHA solving, video extraction
|
|
27
|
+
- ✅ **3 Protocol Modes** - MCP (STDIO), LSP, HTTP/WebSocket
|
|
28
|
+
- ✅ **Auto-Detection** - Automatically detects your IDE
|
|
29
|
+
- ✅ **Real Brave Browser** - Anti-detection features, bypass Cloudflare
|
|
30
|
+
- ✅ **Universal API** - Works with any programming language (JS, Python, PHP, Go, etc.)
|
|
66
31
|
|
|
67
32
|
---
|
|
68
33
|
|
|
@@ -74,46 +39,123 @@ This server **automatically detects and adapts** to your AI IDE!
|
|
|
74
39
|
# Install globally
|
|
75
40
|
npm install -g brave-real-browser-mcp-server@latest
|
|
76
41
|
|
|
77
|
-
# Or use with npx (no installation
|
|
42
|
+
# Or use with npx (no installation)
|
|
78
43
|
npx brave-real-browser-mcp-server@latest
|
|
79
44
|
```
|
|
80
45
|
|
|
81
|
-
###
|
|
46
|
+
### For MCP IDEs (Claude, Cursor, Windsurf)
|
|
47
|
+
|
|
48
|
+
**Add to your IDE config file:**
|
|
49
|
+
|
|
50
|
+
```json
|
|
51
|
+
{
|
|
52
|
+
"mcpServers": {
|
|
53
|
+
"brave-real-browser": {
|
|
54
|
+
"command": "npx",
|
|
55
|
+
"args": ["-y", "brave-real-browser-mcp-server@latest"]
|
|
56
|
+
}
|
|
57
|
+
}
|
|
58
|
+
}
|
|
59
|
+
```
|
|
60
|
+
|
|
61
|
+
**Config file locations:**
|
|
62
|
+
|
|
63
|
+
- **Claude Desktop:** `%APPDATA%\Claude\claude_desktop_config.json` (Windows) or `~/Library/Application Support/Claude/claude_desktop_config.json` (Mac)
|
|
64
|
+
- **Cursor:** `%APPDATA%\Cursor\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json`
|
|
65
|
+
- **Windsurf:** `%APPDATA%\Windsurf\mcp.json`
|
|
66
|
+
|
|
67
|
+
### For Other IDEs (Qoder AI, Custom Tools)
|
|
68
|
+
|
|
69
|
+
Use HTTP/WebSocket mode - [See HTTP/WebSocket Setup](#-httpwebsocket-setup)
|
|
70
|
+
|
|
71
|
+
---
|
|
72
|
+
|
|
73
|
+
## 🌐 HTTP/WebSocket Setup
|
|
74
|
+
|
|
75
|
+
### HTTP Protocol - 5 Steps
|
|
76
|
+
|
|
77
|
+
HTTP mode works with **ANY IDE or programming language**. No special configuration needed!
|
|
78
|
+
|
|
79
|
+
#### Step 1: Start HTTP Server
|
|
82
80
|
|
|
83
81
|
```bash
|
|
84
|
-
#
|
|
85
|
-
brave-real-browser-mcp-server@latest
|
|
82
|
+
# Start server on port 3000
|
|
83
|
+
npx brave-real-browser-mcp-server@latest --mode http --port 3000
|
|
86
84
|
|
|
87
|
-
#
|
|
88
|
-
brave-real-browser-mcp-server@latest --mode
|
|
85
|
+
# Custom host and port
|
|
86
|
+
npx brave-real-browser-mcp-server@latest --mode http --host 0.0.0.0 --port 8080
|
|
89
87
|
|
|
90
|
-
#
|
|
91
|
-
brave-real-browser-mcp-server@latest --mode
|
|
88
|
+
# HTTP only (without WebSocket)
|
|
89
|
+
npx brave-real-browser-mcp-server@latest --mode http --port 3000 --no-websocket
|
|
90
|
+
```
|
|
92
91
|
|
|
93
|
-
|
|
94
|
-
brave-real-browser-mcp-server@latest --mode http --port 3000
|
|
92
|
+
**Server will start and show:**
|
|
95
93
|
|
|
96
|
-
# LSP mode (for Zed, VSCode, etc.)
|
|
97
|
-
brave-real-browser-mcp-server@latest --mode lsp
|
|
98
94
|
```
|
|
95
|
+
🟢 [HTTP] Starting HTTP/WebSocket server...
|
|
96
|
+
✅ [HTTP] Server ready at http://localhost:3000
|
|
97
|
+
💡 [HTTP] Universal mode - works with ALL AI IDEs
|
|
98
|
+
```
|
|
99
|
+
|
|
100
|
+
#### Step 2: Test Server
|
|
101
|
+
|
|
102
|
+
```bash
|
|
103
|
+
# Health check
|
|
104
|
+
curl http://localhost:3000/health
|
|
105
|
+
|
|
106
|
+
# List all available tools
|
|
107
|
+
curl http://localhost:3000/tools
|
|
108
|
+
```
|
|
109
|
+
|
|
110
|
+
#### Step 5: Configure in Your IDE
|
|
111
|
+
|
|
112
|
+
**For Qoder AI:**
|
|
113
|
+
|
|
114
|
+
```json
|
|
115
|
+
{
|
|
116
|
+
"extensions": {
|
|
117
|
+
"brave-real-browser": {
|
|
118
|
+
"type": "http",
|
|
119
|
+
"enabled": true,
|
|
120
|
+
"endpoint": "http://localhost:3000"
|
|
121
|
+
}
|
|
122
|
+
}
|
|
123
|
+
}
|
|
124
|
+
```
|
|
125
|
+
|
|
126
|
+
**For any custom tool:** Just make HTTP POST requests to `http://localhost:3000/tools/{tool_name}`
|
|
99
127
|
|
|
100
128
|
---
|
|
101
129
|
|
|
102
|
-
|
|
130
|
+
### WebSocket Protocol - 5 Steps
|
|
103
131
|
|
|
104
|
-
|
|
132
|
+
WebSocket provides **real-time, bidirectional communication** for modern applications.
|
|
133
|
+
|
|
134
|
+
#### Step 1: Start WebSocket Server
|
|
135
|
+
|
|
136
|
+
```bash
|
|
137
|
+
# WebSocket is automatically enabled with HTTP mode
|
|
138
|
+
npx brave-real-browser-mcp-server@latest --mode http --port 3000
|
|
139
|
+
|
|
140
|
+
# WebSocket will be available at: ws://localhost:3000
|
|
141
|
+
```
|
|
142
|
+
|
|
143
|
+
## 🎨 IDE Configurations
|
|
144
|
+
|
|
145
|
+
### Claude Desktop
|
|
105
146
|
|
|
106
147
|
**File:** `claude_desktop_config.json`
|
|
107
148
|
|
|
108
149
|
**Location:**
|
|
109
|
-
|
|
110
|
-
-
|
|
111
|
-
-
|
|
150
|
+
|
|
151
|
+
- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
|
|
152
|
+
- Mac: `~/Library/Application Support/Claude/claude_desktop_config.json`
|
|
153
|
+
- Linux: `~/.config/Claude/claude_desktop_config.json`
|
|
112
154
|
|
|
113
155
|
```json
|
|
114
156
|
{
|
|
115
157
|
"mcpServers": {
|
|
116
|
-
"brave-browser": {
|
|
158
|
+
"brave-real-browser": {
|
|
117
159
|
"command": "npx",
|
|
118
160
|
"args": ["-y", "brave-real-browser-mcp-server@latest"]
|
|
119
161
|
}
|
|
@@ -121,18 +163,19 @@ brave-real-browser-mcp-server@latest --mode lsp
|
|
|
121
163
|
}
|
|
122
164
|
```
|
|
123
165
|
|
|
124
|
-
###
|
|
166
|
+
### Cursor AI
|
|
125
167
|
|
|
126
168
|
**File:** `cline_mcp_settings.json`
|
|
127
169
|
|
|
128
170
|
**Location:**
|
|
129
|
-
|
|
130
|
-
-
|
|
171
|
+
|
|
172
|
+
- Windows: `%APPDATA%\Cursor\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json`
|
|
173
|
+
- Mac: `~/Library/Application Support/Cursor/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json`
|
|
131
174
|
|
|
132
175
|
```json
|
|
133
176
|
{
|
|
134
177
|
"mcpServers": {
|
|
135
|
-
"brave-browser": {
|
|
178
|
+
"brave-real-browser": {
|
|
136
179
|
"command": "npx",
|
|
137
180
|
"args": ["-y", "brave-real-browser-mcp-server@latest"],
|
|
138
181
|
"env": {
|
|
@@ -143,18 +186,19 @@ brave-real-browser-mcp-server@latest --mode lsp
|
|
|
143
186
|
}
|
|
144
187
|
```
|
|
145
188
|
|
|
146
|
-
###
|
|
189
|
+
### Windsurf
|
|
147
190
|
|
|
148
191
|
**File:** `mcp.json`
|
|
149
192
|
|
|
150
193
|
**Location:**
|
|
151
|
-
|
|
152
|
-
-
|
|
194
|
+
|
|
195
|
+
- Windows: `%APPDATA%\Windsurf\mcp.json`
|
|
196
|
+
- Mac: `~/.windsurf/mcp.json`
|
|
153
197
|
|
|
154
198
|
```json
|
|
155
199
|
{
|
|
156
200
|
"mcpServers": {
|
|
157
|
-
"brave-browser": {
|
|
201
|
+
"brave-real-browser": {
|
|
158
202
|
"command": "npx",
|
|
159
203
|
"args": ["-y", "brave-real-browser-mcp-server@latest"]
|
|
160
204
|
}
|
|
@@ -162,18 +206,19 @@ brave-real-browser-mcp-server@latest --mode lsp
|
|
|
162
206
|
}
|
|
163
207
|
```
|
|
164
208
|
|
|
165
|
-
###
|
|
209
|
+
### Cline (VSCode Extension)
|
|
166
210
|
|
|
167
211
|
**File:** `cline_mcp_settings.json`
|
|
168
212
|
|
|
169
213
|
**Location:**
|
|
170
|
-
|
|
171
|
-
-
|
|
214
|
+
|
|
215
|
+
- Windows: `%APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json`
|
|
216
|
+
- Mac: `~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json`
|
|
172
217
|
|
|
173
218
|
```json
|
|
174
219
|
{
|
|
175
220
|
"mcpServers": {
|
|
176
|
-
"brave-browser": {
|
|
221
|
+
"brave-real-browser": {
|
|
177
222
|
"command": "npx",
|
|
178
223
|
"args": ["-y", "brave-real-browser-mcp-server@latest"]
|
|
179
224
|
}
|
|
@@ -181,198 +226,377 @@ brave-real-browser-mcp-server@latest --mode lsp
|
|
|
181
226
|
}
|
|
182
227
|
```
|
|
183
228
|
|
|
184
|
-
###
|
|
229
|
+
### Zed Editor
|
|
185
230
|
|
|
186
231
|
**File:** `settings.json`
|
|
187
232
|
|
|
188
233
|
**Location:**
|
|
189
|
-
|
|
190
|
-
-
|
|
234
|
+
|
|
235
|
+
- Windows: `%APPDATA%\Zed\settings.json`
|
|
236
|
+
- Mac: `~/.config/zed/settings.json`
|
|
191
237
|
|
|
192
238
|
```json
|
|
193
239
|
{
|
|
194
|
-
"
|
|
195
|
-
"brave-browser": {
|
|
196
|
-
"command":
|
|
197
|
-
|
|
240
|
+
"context_servers": {
|
|
241
|
+
"brave-real-browser": {
|
|
242
|
+
"command": {
|
|
243
|
+
"path": "npx",
|
|
244
|
+
"args": ["-y", "brave-real-browser-mcp-server@latest"]
|
|
245
|
+
},
|
|
246
|
+
"settings": {}
|
|
198
247
|
}
|
|
199
248
|
}
|
|
200
249
|
}
|
|
201
250
|
```
|
|
202
251
|
|
|
203
|
-
|
|
252
|
+
**Note:** Zed uses `context_servers` (not `lsp`) for MCP servers. Make sure you're using Zed Preview version for MCP support.
|
|
204
253
|
|
|
205
|
-
|
|
254
|
+
### Qoder AI / HTTP-based IDEs
|
|
206
255
|
|
|
207
|
-
|
|
208
|
-
brave-real-browser-mcp-server@latest --mode http --port 3000
|
|
209
|
-
```
|
|
256
|
+
Start server in HTTP mode and configure:
|
|
210
257
|
|
|
211
|
-
|
|
258
|
+
```json
|
|
259
|
+
{
|
|
260
|
+
"extensions": {
|
|
261
|
+
"brave-real-browser": {
|
|
262
|
+
"type": "http",
|
|
263
|
+
"enabled": true,
|
|
264
|
+
"endpoint": "http://localhost:3000",
|
|
265
|
+
"timeout": 30000
|
|
266
|
+
}
|
|
267
|
+
}
|
|
268
|
+
}
|
|
269
|
+
```
|
|
212
270
|
|
|
213
271
|
---
|
|
214
272
|
|
|
215
|
-
## 🛠️
|
|
216
|
-
|
|
217
|
-
### 🌐 Browser Management
|
|
218
|
-
|
|
219
|
-
|
|
220
|
-
|
|
221
|
-
|
|
222
|
-
|
|
223
|
-
|
|
224
|
-
|
|
225
|
-
|
|
226
|
-
|
|
227
|
-
|
|
228
|
-
|
|
229
|
-
|
|
230
|
-
|
|
231
|
-
|
|
232
|
-
|
|
233
|
-
|
|
234
|
-
|
|
235
|
-
|
|
236
|
-
|
|
237
|
-
|
|
238
|
-
|
|
239
|
-
|
|
240
|
-
|
|
241
|
-
|
|
242
|
-
|
|
243
|
-
|
|
244
|
-
|
|
245
|
-
|
|
246
|
-
|
|
247
|
-
|
|
248
|
-
|
|
249
|
-
|
|
250
|
-
|
|
251
|
-
|
|
252
|
-
|
|
253
|
-
|
|
254
|
-
|
|
255
|
-
|
|
256
|
-
|
|
257
|
-
|
|
258
|
-
|
|
259
|
-
|
|
260
|
-
|
|
261
|
-
|
|
262
|
-
|
|
263
|
-
|
|
264
|
-
|
|
265
|
-
|
|
266
|
-
|
|
267
|
-
|
|
268
|
-
|
|
269
|
-
|
|
270
|
-
|
|
271
|
-
|
|
272
|
-
|
|
273
|
-
|
|
274
|
-
|
|
275
|
-
|
|
276
|
-
|
|
277
|
-
|
|
278
|
-
|
|
279
|
-
|
|
280
|
-
|
|
281
|
-
|
|
282
|
-
|
|
283
|
-
###
|
|
284
|
-
|
|
285
|
-
|
|
286
|
-
|
|
287
|
-
|
|
288
|
-
|
|
289
|
-
|
|
290
|
-
|
|
291
|
-
|
|
292
|
-
|
|
293
|
-
|
|
294
|
-
|
|
295
|
-
|
|
273
|
+
## 🛠️ Available Tools (111)
|
|
274
|
+
|
|
275
|
+
### 🌐 Browser Management (2 tools)
|
|
276
|
+
|
|
277
|
+
| Tool | Description |
|
|
278
|
+
| --------------- | ----------------------------------------------- |
|
|
279
|
+
| `browser_init` | Initialize browser with anti-detection features |
|
|
280
|
+
| `browser_close` | Close browser instance |
|
|
281
|
+
|
|
282
|
+
### 🧭 Navigation (2 tools)
|
|
283
|
+
|
|
284
|
+
| Tool | Description |
|
|
285
|
+
| ---------- | ----------------------------------------- |
|
|
286
|
+
| `navigate` | Navigate to URL with wait conditions |
|
|
287
|
+
| `wait` | Wait for selector, navigation, or timeout |
|
|
288
|
+
|
|
289
|
+
### 🖱️ Interactions (4 tools)
|
|
290
|
+
|
|
291
|
+
| Tool | Description |
|
|
292
|
+
| --------------- | ---------------------------------------------------- |
|
|
293
|
+
| `click` | Click on elements |
|
|
294
|
+
| `type` | Type text into inputs |
|
|
295
|
+
| `random_scroll` | Human-like scrolling |
|
|
296
|
+
| `solve_captcha` | Solve CAPTCHA (reCAPTCHA, hCaptcha, Turnstile, etc.) |
|
|
297
|
+
|
|
298
|
+
### 📄 Content Extraction (10 tools)
|
|
299
|
+
|
|
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 |
|
|
312
|
+
|
|
313
|
+
### 🔍 Multi-Element Extraction (8 tools)
|
|
314
|
+
|
|
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 |
|
|
325
|
+
|
|
326
|
+
### 🎯 Advanced Extraction (10 tools)
|
|
327
|
+
|
|
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 |
|
|
340
|
+
|
|
341
|
+
### 🎬 Video & Media Tools (19 tools)
|
|
342
|
+
|
|
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 |
|
|
364
|
+
|
|
365
|
+
### 🔐 CAPTCHA & Security (4 tools)
|
|
366
|
+
|
|
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 |
|
|
373
|
+
|
|
374
|
+
### 🔧 Data Processing (9 tools)
|
|
375
|
+
|
|
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 |
|
|
387
|
+
|
|
388
|
+
### 📊 Data Quality (3 tools)
|
|
389
|
+
|
|
390
|
+
| Tool | Description |
|
|
391
|
+
| ---------------------- | ------------------------ |
|
|
392
|
+
| `outlier_detection` | Detect data outliers |
|
|
393
|
+
| `consistency_checker` | Check data consistency |
|
|
394
|
+
| `data_quality_metrics` | Generate quality metrics |
|
|
395
|
+
|
|
396
|
+
### 🤖 AI-Powered Tools (5 tools)
|
|
397
|
+
|
|
398
|
+
| Tool | Description |
|
|
399
|
+
| -------------------------- | --------------------------- |
|
|
400
|
+
| `smart_selector_generator` | Auto-generate CSS selectors |
|
|
401
|
+
| `content_classification` | Classify content type |
|
|
402
|
+
| `sentiment_analysis` | Analyze text sentiment |
|
|
403
|
+
| `summary_generator` | Generate content summaries |
|
|
404
|
+
| `translation_support` | Translate content |
|
|
405
|
+
|
|
406
|
+
### 🔎 Search & Filter (5 tools)
|
|
407
|
+
|
|
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 |
|
|
413
|
+
| `advanced_css_selectors` | Advanced CSS selector queries |
|
|
414
|
+
| `visual_element_finder` | Find elements visually |
|
|
415
|
+
|
|
416
|
+
### 📑 Pagination & Navigation (5 tools)
|
|
417
|
+
|
|
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 |
|
|
425
|
+
|
|
426
|
+
### 🔒 Session Management (7 tools)
|
|
427
|
+
|
|
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 |
|
|
437
|
+
|
|
438
|
+
### 📸 Visual Tools (5 tools)
|
|
439
|
+
|
|
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 |
|
|
447
|
+
|
|
448
|
+
### 📈 Monitoring & Reporting (6 tools)
|
|
449
|
+
|
|
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 |
|
|
458
|
+
|
|
459
|
+
### 🌐 API Integration (3 tools)
|
|
460
|
+
|
|
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 |
|
|
466
|
+
|
|
467
|
+
### 🛡️ Advanced Extraction & Obfuscation (5 tools)
|
|
468
|
+
|
|
469
|
+
| Tool | Description |
|
|
470
|
+
| ---------------------------- | --------------------------- |
|
|
471
|
+
| `deobfuscate_js` | Deobfuscate JavaScript |
|
|
472
|
+
| `multi_layer_redirect_trace` | Trace multi-layer redirects |
|
|
473
|
+
| `ad_protection_detector` | Detect ad protection |
|
|
474
|
+
| `url_redirect_tracer` | Trace URL redirects |
|
|
475
|
+
| `user_agent_extractor` | Extract user agent info |
|
|
296
476
|
|
|
297
477
|
---
|
|
298
478
|
|
|
299
479
|
## 💡 Usage Examples
|
|
300
480
|
|
|
301
|
-
### Example 1: Simple Web Scraping
|
|
481
|
+
### Example 1: Simple Web Scraping (MCP Mode)
|
|
302
482
|
|
|
303
483
|
```javascript
|
|
304
|
-
//
|
|
484
|
+
// Using MCP tool in Claude/Cursor
|
|
305
485
|
await use_mcp_tool({
|
|
306
|
-
server_name: "brave-browser",
|
|
486
|
+
server_name: "brave-real-browser",
|
|
307
487
|
tool_name: "browser_init",
|
|
308
|
-
arguments: {}
|
|
488
|
+
arguments: {},
|
|
309
489
|
});
|
|
310
490
|
|
|
311
|
-
// Navigate to website
|
|
312
491
|
await use_mcp_tool({
|
|
313
|
-
server_name: "brave-browser",
|
|
492
|
+
server_name: "brave-real-browser",
|
|
314
493
|
tool_name: "navigate",
|
|
315
|
-
arguments: { url: "https://example.com" }
|
|
494
|
+
arguments: { url: "https://example.com" },
|
|
316
495
|
});
|
|
317
496
|
|
|
318
|
-
// Get content
|
|
319
497
|
await use_mcp_tool({
|
|
320
|
-
server_name: "brave-browser",
|
|
498
|
+
server_name: "brave-real-browser",
|
|
321
499
|
tool_name: "get_content",
|
|
322
|
-
arguments: { type: "text" }
|
|
500
|
+
arguments: { type: "text" },
|
|
323
501
|
});
|
|
324
502
|
```
|
|
325
503
|
|
|
326
|
-
### Example 2:
|
|
504
|
+
### Example 2: CAPTCHA Solving
|
|
327
505
|
|
|
328
506
|
```javascript
|
|
329
|
-
// Navigate to page
|
|
507
|
+
// Navigate to CAPTCHA page
|
|
330
508
|
await use_mcp_tool({
|
|
331
|
-
server_name: "brave-browser",
|
|
509
|
+
server_name: "brave-real-browser",
|
|
332
510
|
tool_name: "navigate",
|
|
333
|
-
arguments: { url: "https://
|
|
511
|
+
arguments: { url: "https://site-with-captcha.com" },
|
|
334
512
|
});
|
|
335
513
|
|
|
336
514
|
// Solve CAPTCHA
|
|
337
515
|
await use_mcp_tool({
|
|
338
|
-
server_name: "brave-browser",
|
|
516
|
+
server_name: "brave-real-browser",
|
|
339
517
|
tool_name: "solve_captcha",
|
|
340
|
-
arguments: { type: "recaptcha" }
|
|
518
|
+
arguments: { type: "recaptcha" },
|
|
341
519
|
});
|
|
342
520
|
|
|
343
|
-
//
|
|
521
|
+
// Continue automation
|
|
344
522
|
await use_mcp_tool({
|
|
345
|
-
server_name: "brave-browser",
|
|
346
|
-
tool_name: "
|
|
347
|
-
arguments: { selector: "
|
|
523
|
+
server_name: "brave-real-browser",
|
|
524
|
+
tool_name: "click",
|
|
525
|
+
arguments: { selector: "button.submit" },
|
|
348
526
|
});
|
|
349
527
|
```
|
|
350
528
|
|
|
351
|
-
### Example 3:
|
|
529
|
+
### Example 3: Video Extraction
|
|
352
530
|
|
|
353
|
-
```
|
|
354
|
-
|
|
355
|
-
|
|
531
|
+
```javascript
|
|
532
|
+
// Navigate to video page
|
|
533
|
+
await use_mcp_tool({
|
|
534
|
+
server_name: "brave-real-browser",
|
|
535
|
+
tool_name: "navigate",
|
|
536
|
+
arguments: { url: "https://video-site.com/video/123" },
|
|
537
|
+
});
|
|
538
|
+
|
|
539
|
+
// Find video links
|
|
540
|
+
await use_mcp_tool({
|
|
541
|
+
server_name: "brave-real-browser",
|
|
542
|
+
tool_name: "video_link_finder",
|
|
543
|
+
arguments: {},
|
|
544
|
+
});
|
|
545
|
+
|
|
546
|
+
// Advanced video extraction with ad bypass
|
|
547
|
+
await use_mcp_tool({
|
|
548
|
+
server_name: "brave-real-browser",
|
|
549
|
+
tool_name: "advanced_video_extraction",
|
|
550
|
+
arguments: {},
|
|
551
|
+
});
|
|
356
552
|
```
|
|
357
553
|
|
|
554
|
+
### Example 4: Multi-Page Scraping
|
|
555
|
+
|
|
358
556
|
```javascript
|
|
359
|
-
//
|
|
360
|
-
|
|
361
|
-
|
|
362
|
-
|
|
363
|
-
|
|
557
|
+
// Initialize browser
|
|
558
|
+
await use_mcp_tool({
|
|
559
|
+
server_name: "brave-real-browser",
|
|
560
|
+
tool_name: "browser_init",
|
|
561
|
+
arguments: {},
|
|
364
562
|
});
|
|
365
563
|
|
|
366
|
-
|
|
564
|
+
// Auto-paginate through all pages
|
|
565
|
+
await use_mcp_tool({
|
|
566
|
+
server_name: "brave-real-browser",
|
|
567
|
+
tool_name: "multi_page_scraper",
|
|
568
|
+
arguments: {
|
|
569
|
+
startUrl: "https://example.com/page/1",
|
|
570
|
+
maxPages: 10,
|
|
571
|
+
},
|
|
572
|
+
});
|
|
367
573
|
```
|
|
368
574
|
|
|
369
575
|
---
|
|
370
576
|
|
|
371
|
-
## 📋
|
|
577
|
+
## 📋 API Endpoints (HTTP Mode)
|
|
372
578
|
|
|
373
|
-
|
|
374
|
-
|
|
375
|
-
|
|
579
|
+
When running in HTTP mode, these endpoints are available:
|
|
580
|
+
|
|
581
|
+
```
|
|
582
|
+
GET /health - Health check
|
|
583
|
+
GET /tools - List all tools
|
|
584
|
+
POST /tools/:toolName - Execute any tool
|
|
585
|
+
POST /browser/init - Initialize browser
|
|
586
|
+
POST /browser/navigate - Navigate to URL
|
|
587
|
+
POST /browser/get_content - Get page content
|
|
588
|
+
POST /browser/click - Click element
|
|
589
|
+
POST /browser/type - Type text
|
|
590
|
+
POST /browser/close - Close browser
|
|
591
|
+
```
|
|
592
|
+
|
|
593
|
+
**Example:**
|
|
594
|
+
|
|
595
|
+
```bash
|
|
596
|
+
curl -X POST http://localhost:3000/tools/navigate \
|
|
597
|
+
-H "Content-Type: application/json" \
|
|
598
|
+
-d '{"url": "https://example.com"}'
|
|
599
|
+
```
|
|
376
600
|
|
|
377
601
|
---
|
|
378
602
|
|
|
@@ -387,6 +611,9 @@ HEADLESS=true
|
|
|
387
611
|
|
|
388
612
|
# Optional: Disable content priority
|
|
389
613
|
DISABLE_CONTENT_PRIORITY=true
|
|
614
|
+
|
|
615
|
+
# Optional: HTTP port
|
|
616
|
+
HTTP_PORT=3000
|
|
390
617
|
```
|
|
391
618
|
|
|
392
619
|
---
|
|
@@ -395,284 +622,83 @@ DISABLE_CONTENT_PRIORITY=true
|
|
|
395
622
|
|
|
396
623
|
### Brave Browser Not Found
|
|
397
624
|
|
|
398
|
-
**Solution
|
|
625
|
+
**Solution:**
|
|
626
|
+
|
|
399
627
|
```bash
|
|
400
628
|
# Windows
|
|
401
629
|
set BRAVE_PATH="C:\Program Files\BraveSoftware\Brave-Browser\Application\brave.exe"
|
|
402
630
|
|
|
403
|
-
# Linux/
|
|
631
|
+
# Linux/Mac
|
|
404
632
|
export BRAVE_PATH="/usr/bin/brave-browser"
|
|
405
633
|
```
|
|
406
634
|
|
|
407
|
-
|
|
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
|
|
635
|
+
### Server Won't Start
|
|
421
636
|
|
|
422
637
|
1. Check Node.js version: `node --version` (should be >= 18)
|
|
423
638
|
2. Clear npm cache: `npm cache clean --force`
|
|
424
639
|
3. Reinstall: `npm install -g brave-real-browser-mcp-server@latest`
|
|
425
|
-
4. Check logs in stderr
|
|
426
|
-
```
|
|
427
640
|
|
|
428
|
-
###
|
|
429
|
-
|
|
430
|
-
1. Wait for CAPTCHA to fully load
|
|
431
|
-
2. Use longer timeout: `{ "timeout": 30000 }`
|
|
432
|
-
3. Try different CAPTCHA types: `recaptcha`, `hcaptcha`, `turnstile`
|
|
433
|
-
|
|
434
|
-
---
|
|
435
|
-
|
|
436
|
-
## 🤝 Contributing
|
|
437
|
-
|
|
438
|
-
Contributions are welcome! Please feel free to submit a Pull Request.
|
|
439
|
-
|
|
440
|
-
1. Fork the repository
|
|
441
|
-
2. Create your feature branch (`git checkout -b feature/AmazingFeature`)
|
|
442
|
-
3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)
|
|
443
|
-
4. Push to the branch (`git push origin feature/AmazingFeature`)
|
|
444
|
-
5. Open a Pull Request
|
|
445
|
-
|
|
446
|
-
---
|
|
447
|
-
|
|
448
|
-
## 📄 License
|
|
449
|
-
|
|
450
|
-
This project is licensed under the MIT License.
|
|
451
|
-
|
|
452
|
-
---
|
|
453
|
-
|
|
454
|
-
## 🔗 Links
|
|
455
|
-
|
|
456
|
-
- **GitHub:** https://github.com/withLinda/brave-real-browser-mcp-server
|
|
457
|
-
- **NPM:** https://www.npmjs.com/package/brave-real-browser-mcp-server
|
|
458
|
-
- **Issues:** https://github.com/withLinda/brave-real-browser-mcp-server/issues
|
|
459
|
-
|
|
460
|
-
---
|
|
461
|
-
|
|
462
|
-
<a name="hindi"></a>
|
|
463
|
-
# 📖 हिन्दी दस्तावेज़
|
|
464
|
-
|
|
465
|
-
## 🤖 समर्थित AI IDEs (सार्वभौमिक संगतता)
|
|
466
|
-
|
|
467
|
-
यह server **स्वचालित रूप से आपके AI IDE को detect करता है और adapt हो जाता है!**
|
|
468
|
-
|
|
469
|
-
### ✅ पूर्णतः समर्थित और स्वतः-पता लगाना
|
|
470
|
-
|
|
471
|
-
सभी 15+ AI IDEs स्वचालित रूप से समर्थित हैं। कोई manual configuration की जरूरत नहीं!
|
|
472
|
-
|
|
473
|
-
---
|
|
474
|
-
|
|
475
|
-
## 🚀 त्वरित शुरुआत
|
|
476
|
-
|
|
477
|
-
### इंस्टॉलेशन
|
|
478
|
-
|
|
479
|
-
```bash
|
|
480
|
-
# Global इंस्टॉल करें
|
|
481
|
-
npm install -g brave-real-browser-mcp-server@latest
|
|
482
|
-
|
|
483
|
-
# या npx से चलाएं (बिना installation के)
|
|
484
|
-
npx brave-real-browser-mcp-server@latest
|
|
485
|
-
```
|
|
486
|
-
|
|
487
|
-
### उपयोग
|
|
488
|
-
|
|
489
|
-
```bash
|
|
490
|
-
# Auto mode (आपका IDE automatically detect होगा) - डिफ़ॉल्ट
|
|
491
|
-
brave-real-browser-mcp-server@latest
|
|
492
|
-
|
|
493
|
-
# MCP mode (Claude, Cursor, Windsurf आदि के लिए)
|
|
494
|
-
brave-real-browser-mcp-server@latest --mode mcp
|
|
495
|
-
|
|
496
|
-
# HTTP mode (सभी IDEs के साथ काम करता है)
|
|
497
|
-
brave-real-browser-mcp-server@latest --mode http --port 3000
|
|
498
|
-
|
|
499
|
-
# LSP mode (Zed, VSCode आदि के लिए)
|
|
500
|
-
brave-real-browser-mcp-server@latest --mode lsp
|
|
501
|
-
```
|
|
502
|
-
|
|
503
|
-
---
|
|
504
|
-
|
|
505
|
-
## ⚙️ विशिष्ट IDEs के लिए कॉन्फ़िगरेशन
|
|
506
|
-
|
|
507
|
-
### 1. Claude Desktop
|
|
508
|
-
|
|
509
|
-
**फ़ाइल:** `claude_desktop_config.json`
|
|
510
|
-
|
|
511
|
-
**स्थान:**
|
|
512
|
-
- **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
|
|
513
|
-
- **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
|
|
514
|
-
|
|
515
|
-
```json
|
|
516
|
-
{
|
|
517
|
-
"mcpServers": {
|
|
518
|
-
"brave-browser": {
|
|
519
|
-
"command": "npx",
|
|
520
|
-
"args": ["-y", "brave-real-browser-mcp-server@latest"]
|
|
521
|
-
}
|
|
522
|
-
}
|
|
523
|
-
}
|
|
524
|
-
```
|
|
525
|
-
|
|
526
|
-
### 2. Cursor AI
|
|
527
|
-
|
|
528
|
-
**फ़ाइल:** `cline_mcp_settings.json`
|
|
529
|
-
|
|
530
|
-
**स्थान:**
|
|
531
|
-
- **Windows:** `%APPDATA%\Cursor\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json`
|
|
532
|
-
|
|
533
|
-
```json
|
|
534
|
-
{
|
|
535
|
-
"mcpServers": {
|
|
536
|
-
"brave-browser": {
|
|
537
|
-
"command": "npx",
|
|
538
|
-
"args": ["-y", "brave-real-browser-mcp-server@latest"]
|
|
539
|
-
}
|
|
540
|
-
}
|
|
541
|
-
}
|
|
542
|
-
```
|
|
543
|
-
|
|
544
|
-
### 3. HTTP-आधारित IDEs (Qoder AI आदि)
|
|
545
|
-
|
|
546
|
-
Server को HTTP mode में start करें:
|
|
641
|
+
### Port Already in Use
|
|
547
642
|
|
|
548
643
|
```bash
|
|
549
|
-
|
|
644
|
+
# Use different port
|
|
645
|
+
npx brave-real-browser-mcp-server@latest --mode http --port 8080
|
|
550
646
|
```
|
|
551
647
|
|
|
552
|
-
|
|
553
|
-
|
|
554
|
-
---
|
|
648
|
+
### CAPTCHA Not Solving
|
|
555
649
|
|
|
556
|
-
|
|
557
|
-
|
|
558
|
-
|
|
559
|
-
- `browser_init` - Anti-detection के साथ Brave browser शुरू करें
|
|
560
|
-
- `browser_close` - Browser बंद करें
|
|
561
|
-
- `navigate` - URL पर जाएं
|
|
562
|
-
- `wait` - Elements/timeout के लिए प्रतीक्षा करें
|
|
563
|
-
|
|
564
|
-
### 🖱️ इंटरैक्शन टूल्स
|
|
565
|
-
- `click` - Elements पर क्लिक करें
|
|
566
|
-
- `type` - Inputs में text टाइप करें
|
|
567
|
-
- `solve_captcha` - CAPTCHA हल करें (reCAPTCHA, hCaptcha, आदि)
|
|
568
|
-
- `random_scroll` - मानव-जैसे scrolling
|
|
569
|
-
|
|
570
|
-
### 📄 कंटेंट निष्कर्षण
|
|
571
|
-
- `get_content` - Page content निकालें (HTML/Text/Markdown)
|
|
572
|
-
- `scrape_table` - Table data निकालें
|
|
573
|
-
- `extract_list` - Lists निकालें
|
|
574
|
-
- `extract_json` - JSON data निकालें
|
|
575
|
-
- `image_scraper` - सभी images निकालें
|
|
576
|
-
- `link_harvester` - सभी links निकालें
|
|
577
|
-
|
|
578
|
-
### 🤖 AI-Powered टूल्स
|
|
579
|
-
- `smart_selector_generator` - Selectors auto-generate करें
|
|
580
|
-
- `content_classification` - Content type classify करें
|
|
581
|
-
- `sentiment_analysis` - Sentiment का विश्लेषण करें
|
|
582
|
-
- `summary_generator` - Summaries बनाएं
|
|
583
|
-
|
|
584
|
-
### 🔐 CAPTCHA और सुरक्षा
|
|
585
|
-
- `solve_captcha` - Multi-CAPTCHA solver
|
|
586
|
-
- `ocr_engine` - Text CAPTCHAs के लिए OCR
|
|
587
|
-
- `audio_captcha_solver` - Audio CAPTCHA solver
|
|
650
|
+
1. Ensure CAPTCHA is fully loaded
|
|
651
|
+
2. Try longer timeout: `{ "timeout": 30000 }`
|
|
652
|
+
3. Try different CAPTCHA types: `recaptcha`, `hcaptcha`, `turnstile`
|
|
588
653
|
|
|
589
654
|
---
|
|
590
655
|
|
|
591
|
-
##
|
|
592
|
-
|
|
593
|
-
### उदाहरण 1: साधारण Web Scraping
|
|
594
|
-
|
|
595
|
-
```javascript
|
|
596
|
-
// Browser initialize करें
|
|
597
|
-
await use_mcp_tool({
|
|
598
|
-
server_name: "brave-browser",
|
|
599
|
-
tool_name: "browser_init",
|
|
600
|
-
arguments: {}
|
|
601
|
-
});
|
|
602
|
-
|
|
603
|
-
// Website पर जाएं
|
|
604
|
-
await use_mcp_tool({
|
|
605
|
-
server_name: "brave-browser",
|
|
606
|
-
tool_name: "navigate",
|
|
607
|
-
arguments: { url: "https://example.com" }
|
|
608
|
-
});
|
|
656
|
+
## 📊 Supported Protocols
|
|
609
657
|
|
|
610
|
-
|
|
611
|
-
|
|
612
|
-
|
|
613
|
-
|
|
614
|
-
|
|
615
|
-
|
|
616
|
-
```
|
|
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 |
|
|
617
664
|
|
|
618
665
|
---
|
|
619
666
|
|
|
620
|
-
## 📋
|
|
667
|
+
## 📋 Requirements
|
|
621
668
|
|
|
622
669
|
- **Node.js** >= 18.0.0
|
|
623
|
-
- **Brave Browser** (auto-detected
|
|
624
|
-
- **Operating System:** Windows, macOS,
|
|
625
|
-
|
|
626
|
-
---
|
|
627
|
-
|
|
628
|
-
## 🐛 समस्या निवारण
|
|
629
|
-
|
|
630
|
-
### Brave Browser नहीं मिला
|
|
631
|
-
|
|
632
|
-
**समाधान:** Environment variable सेट करें
|
|
633
|
-
```bash
|
|
634
|
-
# Windows
|
|
635
|
-
set BRAVE_PATH="C:\Program Files\BraveSoftware\Brave-Browser\Application\brave.exe"
|
|
636
|
-
|
|
637
|
-
# Linux/macOS
|
|
638
|
-
export BRAVE_PATH="/usr/bin/brave-browser"
|
|
639
|
-
```
|
|
640
|
-
|
|
641
|
-
### Server शुरू नहीं हो रहा
|
|
642
|
-
|
|
643
|
-
1. Node.js version check करें: `node --version` (>= 18 होना चाहिए)
|
|
644
|
-
2. NPM cache clear करें: `npm cache clean --force`
|
|
645
|
-
3. फिर से install करें: `npm install -g brave-real-browser-mcp-server`
|
|
670
|
+
- **Brave Browser** (auto-detected or specify path)
|
|
671
|
+
- **Operating System:** Windows, macOS, Linux
|
|
646
672
|
|
|
647
673
|
---
|
|
648
674
|
|
|
649
|
-
## 🤝
|
|
675
|
+
## 🤝 Contributing
|
|
650
676
|
|
|
651
|
-
Contributions
|
|
677
|
+
Contributions are welcome! Please submit a Pull Request.
|
|
652
678
|
|
|
653
679
|
---
|
|
654
680
|
|
|
655
|
-
## 📄
|
|
681
|
+
## 📄 License
|
|
656
682
|
|
|
657
|
-
|
|
683
|
+
MIT License - See LICENSE file for details.
|
|
658
684
|
|
|
659
685
|
---
|
|
660
686
|
|
|
661
|
-
##
|
|
687
|
+
## 🔗 Links
|
|
662
688
|
|
|
663
|
-
|
|
664
|
-
|
|
665
|
-
|
|
666
|
-
✅ **100+ Tools** - Browser automation, scraping, CAPTCHA solving
|
|
667
|
-
✅ **Anti-Detection** - Cloudflare, reCAPTCHA bypass
|
|
668
|
-
✅ **Cross-Platform** - Windows, macOS, Linux
|
|
689
|
+
- **GitHub:** https://github.com/codeiva4u/Brave-Real-Browser-Mcp-Server
|
|
690
|
+
- **NPM:** https://www.npmjs.com/package/brave-real-browser-mcp-server
|
|
691
|
+
- **Issues:** https://github.com/codeiva4u/Brave-Real-Browser-Mcp-Server/issues
|
|
669
692
|
|
|
670
693
|
---
|
|
671
694
|
|
|
672
695
|
<div align="center">
|
|
673
696
|
|
|
697
|
+
**🌟 111 Tools | 15+ AI IDEs | 3 Protocols | Universal Support 🌟**
|
|
698
|
+
|
|
674
699
|
**Made with ❤️ for the AI Development Community**
|
|
675
700
|
|
|
676
|
-
[⭐ Star on GitHub](https://github.com/
|
|
701
|
+
[⭐ 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)
|
|
677
702
|
|
|
678
|
-
</div>
|
|
703
|
+
</div>
|
|
704
|
+
| **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.
|
|
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",
|