{"id":24617243,"url":"https://github.com/botswin/BotBrowser","last_synced_at":"2025-10-06T09:31:05.321Z","repository":{"id":256438405,"uuid":"854084975","full_name":"MiddleSchoolStudent/BotBrowser","owner":"MiddleSchoolStudent","description":"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.","archived":false,"fork":false,"pushed_at":"2025-01-13T03:41:39.000Z","size":584793,"stargazers_count":109,"open_issues_count":7,"forks_count":17,"subscribers_count":6,"default_branch":"main","last_synced_at":"2025-01-16T11:24:04.534Z","etag":null,"topics":["adscore","akamai","antibot","automation","bypass","cloudflare","datadome","fingerprint","incapsula","kasada","perimeterx","playwright","puppeteer","recaptcha","scraping","shapesecurity","stealth"],"latest_commit_sha":null,"homepage":"https://t.me/middle_student","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/MiddleSchoolStudent.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-09-08T11:24:03.000Z","updated_at":"2025-01-16T09:40:52.000Z","dependencies_parsed_at":"2024-11-15T22:31:04.062Z","dependency_job_id":"d43e0875-dbe0-42f2-8311-0babd8cf9c04","html_url":"https://github.com/MiddleSchoolStudent/BotBrowser","commit_stats":{"total_commits":27,"total_committers":2,"mean_commits":13.5,"dds":0.03703703703703709,"last_synced_commit":"5d64547f9551ca16d5a41c6bc7a4b652e200a99a"},"previous_names":["middleschoolstudent/botbrowser"],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MiddleSchoolStudent%2FBotBrowser","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MiddleSchoolStudent%2FBotBrowser/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MiddleSchoolStudent%2FBotBrowser/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MiddleSchoolStudent%2FBotBrowser/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MiddleSchoolStudent","download_url":"https://codeload.github.com/MiddleSchoolStudent/BotBrowser/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":235279148,"owners_count":18964215,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["adscore","akamai","antibot","automation","bypass","cloudflare","datadome","fingerprint","incapsula","kasada","perimeterx","playwright","puppeteer","recaptcha","scraping","shapesecurity","stealth"],"created_at":"2025-01-24T23:01:33.760Z","updated_at":"2025-10-06T09:30:55.312Z","avatar_url":"https://github.com/MiddleSchoolStudent.png","language":"TypeScript","funding_links":[],"categories":["前端开发框架及项目","TypeScript"],"sub_categories":["前端项目_其他"],"readme":"\u003ch1 align=\"center\"\u003e🤖 BotBrowser\u003c/h1\u003e\n\n\u003ch4 align=\"center\"\u003eThe Ultimate Solution for Undetectable Automated Browsing 🚀\u003c/h4\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/MiddleSchoolStudent/BotBrowser/releases\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/v/release/MiddleSchoolStudent/BotBrowser?style=flat-square\" alt=\"Latest Release\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/MiddleSchoolStudent/BotBrowser/issues\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/issues/MiddleSchoolStudent/BotBrowser?style=flat-square\" alt=\"Issues\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n---\n\n## What is BotBrowser?\n\nBotBrowser 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.\n\n## Simplified Management\n\nStreamline your automation with [BotBrowserConsole](console), a free and open-source GUI tool designed to:\n- Easily launch multiple browser instances\n- Seamlessly manage different environments\n- Efficiently handle multiple accounts\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg width=\"800\" alt=\"BotBrowser GUI - Your Command Center\" src=\"https://github.com/user-attachments/assets/e9c0b656-83b0-4be5-986e-d4bc3c04b4b5\"\u003e\n\u003c/div\u003e\n\n---\n\n## 🚀 Features\n\n### 🎯 Core Features\n\n- **Cross-Platform Compatibility**\n  \u003e Fully supports Windows, macOS, and Ubuntu, enabling seamless cross-platform use of profiles. Start on one system and continue effortlessly on another.\n\n- **Latest Chromium Base**\n  \u003e Stays updated with the latest stable Chrome/Chromium versions to ensure compatibility with advanced antibot defenses.\n\n- **Advanced Programmatic Control**\n  \u003e 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.\n\n- **Success \u0026 Performance**\n  \u003e 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.\n\n### 🛡️ Advanced Capabilities\n\n#### 🕵️ Stealth and Detection Evasion\n\n- **Bypass headless and incognito checks**: Enables undetectable automation by seamlessly evading detection in both headless and incognito modes.\n\n- **Customizable browsing history**: Enables realistic, dynamic histories for diverse fingerprinting scenarios.\n\n- **Noise injection**: Randomizes 2D canvas, WebGL, emoji, fonts, text metrics, and audio fingerprints to avoid detection.\n\n- **Simulated OS-specific properties**: Adjusts scrollbar width, BarcodeDetector, and system-specific settings for enhanced authenticity.\n\n- **Chrome feature masking**: Removes Chromium-specific traits, simulating native Chrome with features like AdInterest and CDM for enhanced detection evasion.\n\n- **Comprehensive fingerprint spoofing**:\n\n  | **Category**    | **Details**                                 |\n  |-----------------|---------------------------------------------|\n  | **Browser**     | Version, OS, userAgentData                 |\n  | **Graphics**    | WebGL, WebGL2, GPU                         |\n  | **Hardware**    | Screen, Battery, Keyboard, CPU             |\n  | **Environment** | Permissions, FeaturePolicy, SystemFonts    |\n  | **Media**       | MediaDevices, MimeTypes                    |\n  | **Visuals**     | Emoji, Unicode, System Colors              |\n  | **Others**      | Navigator, Window, and more                |\n\n\n#### 🌐 Comprehensive Proxy and Network Control\n\n- **Proxy integration**: Easily configure proxy host, username, and password without relying on CDP ([Page.authenticate](https://pptr.dev/api/puppeteer.page.authenticate/)).\n\n- **Dynamic language and timezone settings**: Automatically adapt browser environment based on proxy IP for realistic geolocation.\n\n- **WebRTC leak protection**: Prevents exposure of real IPs during WebRTC communication.\n\n\n---\n\n## 🚀 Usage\n\n1. **Download**: Get the installer for your OS from [Releases](https://github.com/MiddleSchoolStudent/BotBrowser/releases) page.\n\n2. **Cross-Platform Profiles**:\n  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**.\n\n3. **Launching BotBrowser**:\n\n    BotBrowser can be launched in three ways:\n\n  - **CLI**:\n    Pass your profile via the `--bot-profile` parameter:\n\n    ```bash\n    chromium --bot-profile=\"{path_of_}/chrome131_win11_x64.enc\"\n    ```\n\n  - **[Playwright](demo/playwright) / [Puppeteer Demo](demo/puppeteer)**:\n    Integrate BotBrowser within automation frameworks with a few lines of code:\n\n    ```javascript\n    const browser = await chromium.launch({\n      browser: \"chrome\",\n      headless: true,\n      executablePath: BOTBROWSER_EXEC_PATH, // Path to the BotBrowser executable\n      args: [`--bot-profile=${BOT_PROFILE_PATH}`], // Path to the bot profile\n    });\n\n    const page = await browser.newPage();\n    await page.goto(\"https://www.google.com\");\n    ```\n\n  - **[BotBrowserConsole](console)**: A free and open-source GUI tool.\n\n4. **Tests**\n  Use our detailed test scripts to explore real-world use cases and implementation examples: **[Tests](tests)**.\n\n---\n\n## 🎯 Proven Effectiveness\n\n### 🧪 Code and Video Test Results\n\nBotBrowser has been extensively tested against leading antibot systems. Below are detailed test results and video demonstrations:\n\n| Service \u0026 Scripts                                                  | Test Results                                                                                                                                                                                                                                                                       |\n|--------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| **[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) |\n| **[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-) |\n| **[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-) |\n| **[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-)                                                                                     |\n| **[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)                                                                                 |\n| **[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)                                                                                     |\n| **[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-)                                                                       |\n| **[DataDome](tests/tests/antibots/datadome.spec.ts)**              | [▶️ shutterstock.com](https://middleschoolstudent.github.io/BotBrowser/video_player/index.html?video=datadome-test-shutterstock-com)                                                                       |\n| **[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)                                                                       |\n| **[Accertify](tests/tests/antibots/accertify.spec.ts)**            | [▶️ grubhub.com](https://middleschoolstudent.github.io/BotBrowser/video_player/index.html?video=perimeterx-test-grubhub)                                                                       |\n| **[Forter](tests/tests/antibots/forter.spec.ts)**                  | [▶️ grubhub.com](https://middleschoolstudent.github.io/BotBrowser/video_player/index.html?video=perimeterx-test-grubhub)                                                                       |\n| **Cloudfront Bot Management (AWS)**                                | 🚧 Coming Soon                                                                                                                                                                                                                                                                            |\n| **ThreatMetrix**                                                   | 🚧 Coming Soon                                                                                                                                                                                                                                                                            |\n| **Adscore**                                                        | 🚧 Coming Soon                                                                                                                                                                                                                                                                            |\n| **ProtectedMedia**                                                 | 🚧 Coming Soon                                                                                                                                                                                                                                                                            |\n| **[Fake Vision](tests/tests/antibots/fvpro.spec.ts)**              | [▶️ fv.pro](https://middleschoolstudent.github.io/BotBrowser/video_player/index.html?video=fvpro-test-fv-pro)                                                                                           |\n| **[FingerprintJS](tests/tests/antibots/fingerprintjs.spec.ts)**    | [▶️ Bot Detection](https://middleschoolstudent.github.io/BotBrowser/video_player/index.html?video=fingerprintjs-test-fingerprintjs-bot-detection)                                                         |\n| **[CreepJS](tests/tests/antibots/creepjs.spec.ts)**                | [▶️ Test Video](https://middleschoolstudent.github.io/BotBrowser/video_player/index.html?video=creepjs-test-creepjs)                                                                                            |\n| **[BrowserScan](tests/tests/antibots/browserscan.spec.ts)**        | [▶️ Test Video](https://middleschoolstudent.github.io/BotBrowser/video_player/index.html?video=browserscan-test-browserscan)                                                                                     |\n| **[Pixelscan](tests/tests/antibots/pixelscan.spec.ts)**            | [▶️ Test Video](https://middleschoolstudent.github.io/BotBrowser/video_player/index.html?video=pixelscan-test-pixelscan)                                                                                         |\n| **[iphey](tests/tests/antibots/iphey.spec.ts)**                    | [▶️ Test Video](https://middleschoolstudent.github.io/BotBrowser/video_player/index.html?video=iphey-test-iphey)                                                                                               |\n| **[deviceandbrowserinfo](tests/tests/antibots/deviceandbrowserinfo.spec.ts)**     | [▶️ Test Video](https://middleschoolstudent.github.io/BotBrowser/video_player/index.html?video=deviceandbrowserinfo-test-deviceandbrowserinfo)                                                                                               |\n| **[brotector](tests/tests/antibots/brotector.spec.ts)**            | [▶️ Test Video](https://middleschoolstudent.github.io/BotBrowser/video_player/index.html?video=brotector-test-Brotector)                                                                                       |\n\n### 🌐 Top Platforms and Websites\n\nThe following platforms have been tested:\n\n| Service \u0026 Scripts | Anti-bot Services | Test Results |\n|------------------|-------------------|--------------|\n| **[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)  |\n| **TikTok** | Generic Antibot | ✅ Success |\n| **Temu** | F5 Shape Security | ✅ Success |\n| **LinkedIn** | Generic Antibot | ✅ Success |\n| **Ticketmaster** | PerimeterX, FingerprintJS, reCAPTCHA | ✅ Success |\n| **Shein** | F5 Shape Security, FingerprintJS, Forter | ✅ Success |\n| **Facebook** | Generic Antibot | ✅ Success |\n| **Bet365** | Generic Antibot | ✅ Success |\n\n...and many more\n\n\n---\n\n\n## 📚 Additional Resources\n\n### 🔐 Profile Generation\n\nWe 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.\n\n**📞 Contact us today:**\n\n| 📧 Email    | [middleschoolstudent@mail.ru](mailto:middleschoolstudent@mail.ru) |\n|-------------|--------------------------------------------------|\n| 📱 Telegram | [middle_student](https://t.me/middle_student)   |\n\n\n### 🛠️ Building from Source\n\nIf you wish to compile your own version of Chromium with our modifications, follow the instructions provided [here](build).\n\n\n---\n\n## ⚠️ Disclaimer\n\nBotBrowser 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.\n\n---\n\nAntibots are making the world worse.\n\n---\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/MiddleSchoolStudent/BotBrowser\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/stars/MiddleSchoolStudent/BotBrowser?style=social\" alt=\"GitHub Stars\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/MiddleSchoolStudent/BotBrowser/fork\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/forks/MiddleSchoolStudent/BotBrowser?style=social\" alt=\"GitHub Forks\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbotswin%2FBotBrowser","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbotswin%2FBotBrowser","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbotswin%2FBotBrowser/lists"}