sb-stealth-wrapper: a small UC Mode wrapper for testing your own apps behind bot protection

[godhiraj-code]

Hi everyone,

I wanted to share a small project I've been working on: sb-stealth-wrapper. All of the real work here is done by SeleniumBase and UC Mode. This is just a thin wrapper built on top of them, so full credit goes to SeleniumBase and the people who maintain it.

I kept writing the same setup and retry code for test suites that run against apps sitting behind bot protection, so I pulled it into one package.

What it adds on top of UC Mode

• A StealthBot class (used as a context manager) with safe_get, smart_click, smart_type and save_screenshot.
• Bounded challenge recovery. If a challenge page shows up, it makes up to three recovery attempts using SeleniumBase's UC helpers. If the challenge is still there, it raises ChallengeNotSolvedError. If you set success_criteria and that text never shows up, it raises SuccessCriteriaNotMetError. The idea is that tests fail loudly instead of quietly moving on.
• smart_click falls back to a normal SeleniumBase click and then a JS click, and raises an error if none of them work.
• Fingerprint mutation is off by default. The canvas and audio noise strategies are experimental and opt-in only.

Quick example

from sb_stealth_wrapper import StealthBot

with StealthBot(headless=False) as bot:
    bot.safe_get("https://test.example.com/login")
    bot.smart_click("#login-button")
    bot.sb.wait_for_text("Dashboard", timeout=15)
    bot.save_screenshot("after-login")

Please note

This is meant for testing your own apps, or apps you are authorized to test. It does not promise to be undetectable, and it won't get past every challenge. Results depend on the site, IP, browser version and so on. It also doesn't bypass access controls, rate limits or a site's terms.

Install

pip install sb-stealth-wrapper

Repo: https://github.com/godhiraj-code/stealthautomation

Thank you @mdmintz for building and maintaining SeleniumBase. UC Mode made this possible. Any feedback is welcome, especially if I'm using something the wrong way or if there's a better built-in approach I should switch to.

Thanks!