https://github.com/MiddleSchoolStudent/BotBrowser
BotBrowser modifies Chromium's C++ kernel to emulate a real browser, bypassing Cloudflare, F5 Shape, PerimeterX, Akamai, Kasada, and reCAPTCHA with unmatched stealth and reliability.
https://github.com/MiddleSchoolStudent/BotBrowser
adscore akamai antibot automation bypass cloudflare datadome fingerprint incapsula kasada perimeterx playwright puppeteer recaptcha scraping shapesecurity stealth
Last synced: 3 months ago
JSON representation
BotBrowser modifies Chromium's C++ kernel to emulate a real browser, bypassing Cloudflare, F5 Shape, PerimeterX, Akamai, Kasada, and reCAPTCHA with unmatched stealth and reliability.
- Host: GitHub
- URL: https://github.com/MiddleSchoolStudent/BotBrowser
- Owner: MiddleSchoolStudent
- License: mit
- Created: 2024-09-08T11:24:03.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2025-01-13T03:41:39.000Z (3 months ago)
- Last Synced: 2025-01-16T11:24:04.534Z (3 months ago)
- Topics: adscore, akamai, antibot, automation, bypass, cloudflare, datadome, fingerprint, incapsula, kasada, perimeterx, playwright, puppeteer, recaptcha, scraping, shapesecurity, stealth
- Language: TypeScript
- Homepage: https://t.me/middle_student
- Size: 558 MB
- Stars: 109
- Watchers: 6
- Forks: 17
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
🤖 BotBrowser
The Ultimate Solution for Undetectable Automated Browsing 🚀
---
## What is BotBrowser?
BotBrowser is a cross-platform automation tool that redefines web automation. By modifying Chromium's native C++ source code, it achieves true undetectable automation beyond the limitations of CDP-based ([Chrome DevTools Protocol](https://chromedevtools.github.io/devtools-protocol/)) solutions.
## Simplified Management
Streamline your automation with [BotBrowserConsole](console), a free and open-source GUI tool designed to:
- Easily launch multiple browser instances
- Seamlessly manage different environments
- Efficiently handle multiple accounts
---
## 🚀 Features
### 🎯 Core Features
- **Cross-Platform Compatibility**
> Fully supports Windows, macOS, and Ubuntu, enabling seamless cross-platform use of profiles. Start on one system and continue effortlessly on another.
- **Latest Chromium Base**
> Stays updated with the latest stable Chrome/Chromium versions to ensure compatibility with advanced antibot defenses.
- **Advanced Programmatic Control**
> Dual advantage: Leverages CDP for powerful automation with [Playwright](demo/playwright) and [Puppeteer](demo/puppeteer), while preventing CDP leak detection - perfect balance of control and undetectability.
- **Success & Performance**
> Real client success stories validate our exceptional performance: **98%+ success rate** against advanced antibots with over **350,000 accounts registered daily**, demonstrating unmatched efficiency and reliability under high loads.
### 🛡️ Advanced Capabilities
#### 🕵️ Stealth and Detection Evasion
- **Bypass headless and incognito checks**: Enables undetectable automation by seamlessly evading detection in both headless and incognito modes.
- **Customizable browsing history**: Enables realistic, dynamic histories for diverse fingerprinting scenarios.
- **Noise injection**: Randomizes 2D canvas, WebGL, emoji, fonts, text metrics, and audio fingerprints to avoid detection.
- **Simulated OS-specific properties**: Adjusts scrollbar width, BarcodeDetector, and system-specific settings for enhanced authenticity.
- **Chrome feature masking**: Removes Chromium-specific traits, simulating native Chrome with features like AdInterest and CDM for enhanced detection evasion.
- **Comprehensive fingerprint spoofing**:
| **Category** | **Details** |
|-----------------|---------------------------------------------|
| **Browser** | Version, OS, userAgentData |
| **Graphics** | WebGL, WebGL2, GPU |
| **Hardware** | Screen, Battery, Keyboard, CPU |
| **Environment** | Permissions, FeaturePolicy, SystemFonts |
| **Media** | MediaDevices, MimeTypes |
| **Visuals** | Emoji, Unicode, System Colors |
| **Others** | Navigator, Window, and more |
#### 🌐 Comprehensive Proxy and Network Control
- **Proxy integration**: Easily configure proxy host, username, and password without relying on CDP ([Page.authenticate](https://pptr.dev/api/puppeteer.page.authenticate/)).
- **Dynamic language and timezone settings**: Automatically adapt browser environment based on proxy IP for realistic geolocation.
- **WebRTC leak protection**: Prevents exposure of real IPs during WebRTC communication.
---
## 🚀 Usage
1. **Download**: Get the installer for your OS from [Releases](https://github.com/MiddleSchoolStudent/BotBrowser/releases) page.
2. **Cross-Platform Profiles**:
We provide sample [Profiles](profiles) for demonstration purposes. These pre-configured profiles for macOS, Windows, and Ubuntu are **cross-compatible**, enabling seamless fingerprint emulation across systems. For example, a macOS profile can be used on Ubuntu or a Windows profile on macOS **without compatibility issues**.
3. **Launching BotBrowser**:
BotBrowser can be launched in three ways:
- **CLI**:
Pass your profile via the `--bot-profile` parameter:
```bash
chromium --bot-profile="{path_of_}/chrome131_win11_x64.enc"
```
- **[Playwright](demo/playwright) / [Puppeteer Demo](demo/puppeteer)**:
Integrate BotBrowser within automation frameworks with a few lines of code:
```javascript
const browser = await chromium.launch({
browser: "chrome",
headless: true,
executablePath: BOTBROWSER_EXEC_PATH, // Path to the BotBrowser executable
args: [`--bot-profile=${BOT_PROFILE_PATH}`], // Path to the bot profile
});
const page = await browser.newPage();
await page.goto("https://www.google.com");
```
- **[BotBrowserConsole](console)**: A free and open-source GUI tool.
4. **Tests**
Use our detailed test scripts to explore real-world use cases and implementation examples: **[Tests](tests)**.
---
## 🎯 Proven Effectiveness
### 🧪 Code and Video Test Results
BotBrowser has been extensively tested against leading antibot systems. Below are detailed test results and video demonstrations:
| Service & Scripts | Test Results |
|--------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| **[Cloudflare](tests/tests/antibots/cloudflare.spec.ts)** | [▶️ Turnstile](https://middleschoolstudent.github.io/BotBrowser/video_player/index.html?video=cloudflare-test-Cloudflare-turnstile), [▶️ Challenge](https://middleschoolstudent.github.io/BotBrowser/video_player/index.html?video=cloudflare-test-Cloudflare-challenge), [▶️ taxslayer.com](https://middleschoolstudent.github.io/BotBrowser/video_player/index.html?video=cloudflare-test-taxslayer) |
| **[Akamai Bot Manager](tests/tests/antibots/akamai.spec.ts)** | [▶️ playstation.com](https://middleschoolstudent.github.io/BotBrowser/video_player/index.html?video=akamai-test-playstation-com), [▶️ wizzair.com](https://middleschoolstudent.github.io/BotBrowser/video_player/index.html?video=kasada-test-Kasada-wizzair-com-) |
| **[Kasada](tests/tests/antibots/kasada.spec.ts)** | [▶️ kick.com](https://middleschoolstudent.github.io/BotBrowser/video_player/index.html?video=kasada-test-Kasada), [▶️ playstation.com](https://middleschoolstudent.github.io/BotBrowser/video_player/index.html?video=akamai-test-playstation-com), [▶️ wizzair.com](https://middleschoolstudent.github.io/BotBrowser/video_player/index.html?video=kasada-test-Kasada-wizzair-com-) |
| **[F5 Shape Security](tests/tests/antibots/shape.spec.ts)** | [▶️ southwest.com](https://middleschoolstudent.github.io/BotBrowser/video_player/index.html?video=shape-test-Shape-southwest-com-) |
| **[reCAPTCHA](tests/tests/antibots/recaptcha.spec.ts)** | [▶️ Test Video](https://middleschoolstudent.github.io/BotBrowser/video_player/index.html?video=recaptcha-test-reCAPTCHA-v3-on-antcpt) |
| **[PerimeterX](tests/tests/antibots/perimeterx.spec.ts)** | [▶️ textnow.com](https://middleschoolstudent.github.io/BotBrowser/video_player/index.html?video=perimeterx-test-textnow), [▶️ grubhub.com](https://middleschoolstudent.github.io/BotBrowser/video_player/index.html?video=perimeterx-test-grubhub) |
| **[Imperva (Incapsula)](tests/tests/antibots/incapsula.spec.ts)** | [▶️ copaair.com](https://middleschoolstudent.github.io/BotBrowser/video_player/index.html?video=incapsula-test-Incapsula-copaair-com-) |
| **[DataDome](tests/tests/antibots/datadome.spec.ts)** | [▶️ shutterstock.com](https://middleschoolstudent.github.io/BotBrowser/video_player/index.html?video=datadome-test-shutterstock-com) |
| **[hCaptcha](tests/tests/antibots/hcaptcha.spec.ts)** | [▶️ epicgames.com](https://middleschoolstudent.github.io/BotBrowser/video_player/index.html?video=hcaptcha-test-epicgames), [▶️ discord.com](https://middleschoolstudent.github.io/BotBrowser/video_player/index.html?video=hcaptcha-test-discord) |
| **[Accertify](tests/tests/antibots/accertify.spec.ts)** | [▶️ grubhub.com](https://middleschoolstudent.github.io/BotBrowser/video_player/index.html?video=perimeterx-test-grubhub) |
| **[Forter](tests/tests/antibots/forter.spec.ts)** | [▶️ grubhub.com](https://middleschoolstudent.github.io/BotBrowser/video_player/index.html?video=perimeterx-test-grubhub) |
| **Cloudfront Bot Management (AWS)** | 🚧 Coming Soon |
| **ThreatMetrix** | 🚧 Coming Soon |
| **Adscore** | 🚧 Coming Soon |
| **ProtectedMedia** | 🚧 Coming Soon |
| **[Fake Vision](tests/tests/antibots/fvpro.spec.ts)** | [▶️ fv.pro](https://middleschoolstudent.github.io/BotBrowser/video_player/index.html?video=fvpro-test-fv-pro) |
| **[FingerprintJS](tests/tests/antibots/fingerprintjs.spec.ts)** | [▶️ Bot Detection](https://middleschoolstudent.github.io/BotBrowser/video_player/index.html?video=fingerprintjs-test-fingerprintjs-bot-detection) |
| **[CreepJS](tests/tests/antibots/creepjs.spec.ts)** | [▶️ Test Video](https://middleschoolstudent.github.io/BotBrowser/video_player/index.html?video=creepjs-test-creepjs) |
| **[BrowserScan](tests/tests/antibots/browserscan.spec.ts)** | [▶️ Test Video](https://middleschoolstudent.github.io/BotBrowser/video_player/index.html?video=browserscan-test-browserscan) |
| **[Pixelscan](tests/tests/antibots/pixelscan.spec.ts)** | [▶️ Test Video](https://middleschoolstudent.github.io/BotBrowser/video_player/index.html?video=pixelscan-test-pixelscan) |
| **[iphey](tests/tests/antibots/iphey.spec.ts)** | [▶️ Test Video](https://middleschoolstudent.github.io/BotBrowser/video_player/index.html?video=iphey-test-iphey) |
| **[deviceandbrowserinfo](tests/tests/antibots/deviceandbrowserinfo.spec.ts)** | [▶️ Test Video](https://middleschoolstudent.github.io/BotBrowser/video_player/index.html?video=deviceandbrowserinfo-test-deviceandbrowserinfo) |
| **[brotector](tests/tests/antibots/brotector.spec.ts)** | [▶️ Test Video](https://middleschoolstudent.github.io/BotBrowser/video_player/index.html?video=brotector-test-Brotector) |
### 🌐 Top Platforms and Websites
The following platforms have been tested:
| Service & Scripts | Anti-bot Services | Test Results |
|------------------|-------------------|--------------|
| **[Nike](tests/tests/websites/nike.spec.ts)** | F5 Shape Security | ✅ Success [▶️ Checkout Video](https://middleschoolstudent.github.io/BotBrowser/video_player/index.html?video=websites-nike-test-nike-com-checkout) |
| **TikTok** | Generic Antibot | ✅ Success |
| **Temu** | F5 Shape Security | ✅ Success |
| **LinkedIn** | Generic Antibot | ✅ Success |
| **Ticketmaster** | PerimeterX, FingerprintJS, reCAPTCHA | ✅ Success |
| **Shein** | F5 Shape Security, FingerprintJS, Forter | ✅ Success |
| **Facebook** | Generic Antibot | ✅ Success |
| **Bet365** | Generic Antibot | ✅ Success |
...and many more
---
## 📚 Additional Resources
### 🔐 Profile Generation
We do not provide the private key required to generate new profiles. If you need additional profiles, please contact us directly. We maintain a repository of over **300,000 real user browser fingerprints** to support your needs.
**📞 Contact us today:**
| 📧 Email | [[email protected]](mailto:[email protected]) |
|-------------|--------------------------------------------------|
| 📱 Telegram | [middle_student](https://t.me/middle_student) |
### 🛠️ Building from Source
If you wish to compile your own version of Chromium with our modifications, follow the instructions provided [here](build).
---
## ⚠️ Disclaimer
BotBrowser is intended for legitimate use cases that comply with all applicable laws and regulations. Misuse of this tool to violate the terms of service of websites or engage in illegal activities is strictly prohibited.
---
Antibots are making the world worse.
---
