brave-real-browser-mcp-server 2.9.15 → 2.9.16

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 (3) hide show
  1. package/LICENSE +51 -0
  2. package/README.md +38 -4
  3. package/package.json +9 -2
package/LICENSE ADDED
@@ -0,0 +1,51 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2024 ZFC-Digital (Original puppeteer-real-browser package)
4
+ Copyright (c) 2024 withlinda13 (Original puppeteer-real-browser-mcp-server)
5
+ Copyright (c) 2024 codeiva4u (Brave Browser adaptation and modifications)
6
+
7
+ Permission is hereby granted, free of charge, to any person obtaining a copy
8
+ of this software and associated documentation files (the "Software"), to deal
9
+ in the Software without restriction, including without limitation the rights
10
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
11
+ copies of the Software, and to permit persons to whom the Software is
12
+ furnished to do so, subject to the following conditions:
13
+
14
+ The above copyright notice and this permission notice shall be included in all
15
+ copies or substantial portions of the Software.
16
+
17
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
18
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
19
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
20
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
21
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
22
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
23
+ SOFTWARE.
24
+
25
+ ---
26
+
27
+ ## Acknowledgments
28
+
29
+ This project is built upon and adapted from the following excellent open-source projects:
30
+
31
+ ### 1. puppeteer-real-browser by ZFC-Digital
32
+ - Repository: https://github.com/ZFC-Digital/puppeteer-real-browser
33
+ - License: MIT
34
+ - Description: A puppeteer library designed to bypass bot-detecting captchas such as Cloudflare
35
+ - NPM: https://www.npmjs.com/package/puppeteer-real-browser
36
+
37
+ ### 2. puppeteer-real-browser-mcp-server by withlinda13
38
+ - Repository: https://github.com/withLinda/puppeteer-real-browser-mcp-server
39
+ - License: MIT
40
+ - Description: MCP server wrapper for puppeteer-real-browser providing AI assistant integration
41
+
42
+ ### Modifications in this Fork:
43
+ - Adapted for Brave Browser instead of Chrome
44
+ - Updated to use brave-real-browser package
45
+ - Enhanced with 60+ specialized tools
46
+ - Comprehensive testing suite (219 unit tests)
47
+ - Improved documentation and examples
48
+ - Additional data extraction and processing capabilities
49
+ - AI-powered content analysis features
50
+
51
+ All modifications are also released under the MIT License.
package/README.md CHANGED
@@ -1197,9 +1197,43 @@ This project is licensed under the MIT License - see the LICENSE file for detail
1197
1197
 
1198
1198
  ## Acknowledgments
1199
1199
 
1200
- This MCP server is based on the excellent [brave-real-browser](https://github.com/ZFC-Digital/brave-real-browser) library by ZFC-Digital.
1200
+ This project is built upon and adapted from the following excellent open-source projects:
1201
1201
 
1202
- **Thank you** to the brave-real-browser team for creating such a powerful and detection-resistant browser automation solution!
1202
+ ### 1. puppeteer-real-browser by ZFC-Digital
1203
1203
 
1204
- - GitHub: [https://github.com/ZFC-Digital/brave-real-browser](https://github.com/ZFC-Digital/brave-real-browser)
1205
- - npm: [https://www.npmjs.com/package/brave-real-browser](https://www.npmjs.com/package/brave-real-browser)
1204
+ The foundation of this project is the powerful [puppeteer-real-browser](https://github.com/ZFC-Digital/puppeteer-real-browser) library by **ZFC-Digital**.
1205
+
1206
+ **Thank you** to the ZFC-Digital team for creating such a powerful and detection-resistant browser automation solution!
1207
+
1208
+ - **GitHub:** [https://github.com/ZFC-Digital/puppeteer-real-browser](https://github.com/ZFC-Digital/puppeteer-real-browser)
1209
+ - **npm (original):** [https://www.npmjs.com/package/puppeteer-real-browser](https://www.npmjs.com/package/puppeteer-real-browser)
1210
+ - **npm (Brave version):** [https://www.npmjs.com/package/brave-real-browser](https://www.npmjs.com/package/brave-real-browser)
1211
+ - **License:** MIT
1212
+
1213
+ ### 2. puppeteer-real-browser-mcp-server by withlinda13
1214
+
1215
+ This project is also based on [puppeteer-real-browser-mcp-server](https://github.com/withLinda/puppeteer-real-browser-mcp-server) by **withlinda13**, which provides the MCP (Model Context Protocol) server wrapper for browser automation.
1216
+
1217
+ **Thank you** to withlinda13 for the excellent MCP integration and server architecture!
1218
+
1219
+ - **GitHub:** [https://github.com/withLinda/puppeteer-real-browser-mcp-server](https://github.com/withLinda/puppeteer-real-browser-mcp-server)
1220
+ - **License:** MIT
1221
+
1222
+ ### Our Contributions
1223
+
1224
+ This fork (Brave Real Browser MCP Server) includes the following enhancements:
1225
+
1226
+ - ✅ **Brave Browser Support:** Complete adaptation from Chrome to Brave Browser
1227
+ - ✅ **60+ Specialized Tools:** Expanded from 11 to 60+ tools for comprehensive automation
1228
+ - ✅ **Comprehensive Testing:** 219 unit tests ensuring reliability
1229
+ - ✅ **Data Extraction Tools:** Advanced scraping capabilities (tables, lists, images, links)
1230
+ - ✅ **AI-Powered Features:** Content classification, sentiment analysis, summarization
1231
+ - ✅ **Visual Tools:** Screenshots, PDF generation, video recording
1232
+ - ✅ **Data Processing:** Smart text cleaning, price parsing, date normalization
1233
+ - ✅ **Enhanced Documentation:** Detailed guides and examples
1234
+
1235
+ ### License
1236
+
1237
+ This project maintains the MIT License from the original projects. See [LICENSE](LICENSE) file for complete details.
1238
+
1239
+ **All credit goes to the original authors for their foundational work. This project simply adapts and extends their excellent work for Brave Browser with additional features.**
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "brave-real-browser-mcp-server",
3
- "version": "2.9.15",
3
+ "version": "2.9.16",
4
4
  "description": "MCP server for brave-real-browser",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",
@@ -66,9 +66,16 @@
66
66
  "keywords": [
67
67
  "mcp",
68
68
  "puppeteer",
69
- "browser-automation"
69
+ "browser-automation",
70
+ "brave-browser",
71
+ "web-scraping",
72
+ "automation"
70
73
  ],
71
74
  "author": "codeiva4u",
75
+ "contributors": [
76
+ "ZFC-Digital <https://github.com/ZFC-Digital> (Original puppeteer-real-browser)",
77
+ "withlinda13 <https://github.com/withLinda> (Original MCP server wrapper)"
78
+ ],
72
79
  "license": "MIT",
73
80
  "repository": {
74
81
  "type": "git",