Home

Awesome

Botright v0.5.1

Tests & Linting Downloads


Sponsors

If you need to solve a captcha which isnΒ΄t solvable with Botright or you dont want to spend youΒ΄re own computer resources on AI solving, I can personally recommend:

Capsolver Banner

Capsolver.com is an AI-powered service that specializes in solving various types of captchas automatically. It supports captchas such as reCAPTCHA V2, reCAPTCHA V3, hCaptcha, FunCaptcha, DataDome, AWS Captcha, Geetest and Cloudflare Captcha / Challenge 5s, Imperva / Incapsula, among others.

For developers, Capsolver offers API integration options detailed in their documentation, facilitating the integration of captcha solving into applications. They also provide browser extensions for both Chrome and Firefox, making it easy to use their service directly within a browser. Different pricing packages are available to accommodate varying needs, ensuring flexibility for users.


Evomi Banner

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


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.

TestStatusScore
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 TypeSupportedSolved BySuccess Rate
hCaptchaβœ”οΈ ❓hcaptcha-challenger (outdated)up to 90%
reCaptchaβœ”οΈreCognizer50%-80%
geeTestv3 Currently Not Available!
v3 Intelligent Modeβœ”οΈbotrights stealthiness100%
v3 Slider Captchaβœ”οΈcv2.matchTemplate100%
v3 Nine Captchaβœ”οΈCLIP Detection50%
v3 Icon Captchaβœ”οΈcv2.matchTemplate / SSIM / CLIP70%
v3 Space Captcha❌Not solvable0%
geeTestv4 Currently Not Available!
v4 Intelligent Modeβœ”οΈbotrights stealthiness100%
v4 Slider Captchaβœ”οΈcv2.matchTemplate100%
v4 GoBang Captchaβœ”οΈMath Calculations100%
v4 Icon Captchaβœ”οΈcv2.matchTemplate / SSIM / CLIP60%
v4 IconCrush Captchaβœ”οΈMath Calculations100%

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