Skip to content

Botright, the most advance undetected, fingerprint-changing, captcha-solving, open-source automation framework. Build on Playwright, its as easy to use as it is to extend your code. Solving your Captchas for free with AI.

License

Notifications You must be signed in to change notification settings

Vinyzu/Botright

Repository files navigation

Botright v0.5.1

Tests & Linting Downloads


Sponsors

Scrapeless Banner

If you're looking for an automated browser tool focused on bypassing website bot detection mechanisms, I can personally recommend Scrapeless Scraping Browser. It's suitable for tasks like web scraping, automated testing, and data collection — especially in scenarios that involve complex anti-bot systems.
Scraping Browser is a cloud-based browser platform built for high-concurrency web scraping and AI automation. It features advanced stealth modes and powerful anti-blocking capabilities, making it easy to handle dynamic websites, anti-bot mechanisms, and CAPTCHA challenges. It supports one-click scraping of single pages or entire websites, and can extract content based on prompts. It offers an efficient, stable, and cost-effective solution for large-scale data collection.

Key Features:

  • High-concurrency scraping support: Instantly launch 50–10,000+ browser instances with no server restrictions
  • Bypass anti-bot mechanisms: Automatically handles reCAPTCHA, Cloudflare, WAF, DataDome, and more
  • Highly human-like browsing environment: Dynamic fingerprint spoofing and simulation of real user behavior
  • 70M+ residential IP proxies: Global coverage with geo-targeting and automatic rotation
  • Real-time debugging and session replay: Built-in Session Inspector and Live View for real-time browser session monitoring and control
  • Low operating costs: Proxy usage costs just $1.26–$1.80/GB
  • Plug-and-play: Compatible with Puppeteer / Playwright / Python / Node.js for easy integration
  • Multiple scraping modes supported: Single-page extraction / full-site scraping / prompt-based content extraction

Scrapeless is an all-in-one, highly scalable data scraping tool designed for enterprises and developers. In addition to the Scraping Browser, it also offers Scraping API, Deep SerpAPI, and Proxies services.
👉 Learn more: Scrapeless Scraping Browser Playground | Scrapeless Scraping Browser Docs


Evomi Banner

Evomi is your Swiss Quality, affordable Proxy Provider. I can personally recommend them for their High Quality Residential Proxies.

  • 🌍 Global Presence: Available in 150+ Countries
  • Guaranteed Low Latency
  • 🔒 Swiss Quality and Privacy
  • 🎁 Free Trial: No Credit Card Required
  • 🛡️ 99.9% Uptime
  • 🤝 Special IP Pool selection: Optimize for fast, quality or quantity of ips
  • 🔧 Easy Integration: Compatible with most software and programming languages

Install it from PyPI

pip install botright
playwright install

Usage

Botright is currently only available in async mode.

It is fully plugable with your existing playwright code. You only have to change your browser initialization!

import asyncio

import botright


async def main():
    botright_client = await botright.Botright()
    browser = await botright_client.new_browser()
    page = await browser.new_page()

    # Continue by using the Page
    await page.goto("https://google.com")

    await botright_client.close()


if __name__ == "__main__":
    asyncio.run(main())

Read the Documentation


Browser Stealth

Botright uses a vast amount of techniques to hide its functionality as a bot from websites. To enhance stealth, since Version 0.3, it uses a real Chromium-based browser from the local machine to start up a botted browser. For best stealth, you want to install Ungoogled Chromium.

Furthermore, it uses self-scraped chrome-fingerprints to build up a fake browser fingerprint and to deceive website into thinking it is legit.

Test Status Score
reCaptcha Score ✔️ 0.9
=> nopecha.com ✔️ 0.9
=> recaptcha-demo.appspot.com ✔️ 0.9
=> berstend.github.io ✔️ 0.9
=> antcpt.com ❌❓ 0.1 (Detects Legitimate Browsers as Bad)
CreepJS ✔️ ~65.5% (With Canvas Manipulation 52%)
DataDome ✔️
=> antoinevastel.com ✔️
=> datadome.co ✔️
Imperva ✔️❓ (Cant find approved Testing Sites)
=> ticketmaster.es ✔️
Cloudflare ✔️
=> Turnstile ✔️ (Using Undetected-Playwright-Python)
=> Interstitial ✔️ (Using Undetected-Playwright-Python)
SannySoft ✔️
Incolumitas ✔️ 0.8-1.0
Fingerprint.com ✔️
IpHey ✔️
BrowserScan ✔️
PixelScan (Platform Test Outdated & Maybe caused by WebGL-disabling)
Bet365 ✔️ Currently only using mask_fingerprint=False

Captcha Solving

Botright is able to solve a wide viarity of Captchas. For Documentation of these functions visit BotrightDocumentation.

It uses Computer Vision/Artificial Intelligence and other Methods to solve these Captchas.

You dont need to pay for any Captcha Solving APIs and you can solve Captchas with just one simple function call.

Here all Captchas supported as of now:

Captcha Type Supported Solved By Success Rate
hCaptcha ✔️ ❓ hcaptcha-challenger (outdated) up to 90%
reCaptcha ✔️ reCognizer 50%-80%
geeTestv3 Currently Not Available!
v3 Intelligent Mode ✔️ botrights stealthiness 100%
v3 Slider Captcha ✔️ cv2.matchTemplate 100%
v3 Nine Captcha ✔️ CLIP Detection 50%
v3 Icon Captcha ✔️ cv2.matchTemplate / SSIM / CLIP 70%
v3 Space Captcha Not solvable 0%
geeTestv4 Currently Not Available!
v4 Intelligent Mode ✔️ botrights stealthiness 100%
v4 Slider Captcha ✔️ cv2.matchTemplate 100%
v4 GoBang Captcha ✔️ Math Calculations 100%
v4 Icon Captcha ✔️ cv2.matchTemplate / SSIM / CLIP 60%
v4 IconCrush Captcha ✔️ Math Calculations 100%

Development

Read the CONTRIBUTING.md file.


Copyright and License

© Vinyzu

GNU GPL

(Commercial Usage is allowed, but source, license and copyright has to made available. Botright does not provide and Liability or Warranty)


Thanks to

Kaliiiiiiiiii (For shared knowledge of Anti-Browser-Detection Measures)

Kaliiiiiiiiii (For Main-Authoring Undetected-Playwright (Co-Authored by me) )

QIN2DIM (For his great AI work)

MaxAndolini (For shared knowledge of hCaptcha bypassing)

CreativeProxies (For sponsoring me with Proxies)


Version License Python

my-discord buy-me-a-coffee

About

Botright, the most advance undetected, fingerprint-changing, captcha-solving, open-source automation framework. Build on Playwright, its as easy to use as it is to extend your code. Solving your Captchas for free with AI.

Topics

Resources

License

Stars

Watchers

Forks

Sponsor this project

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •  

Languages