ultrafunkamsterdam/undetected-chromedriver
12,353 stars·1,320 forks·Python·gpl-3.0·10 viewsgithub.com/UltrafunkAmsterdam/undetected-chromedriver↗
Undetected Chromedriver
Undetected-chromedriver is a framework for automated browser navigation designed to bypass anti-bot security measures. It functions by patching browser drivers at the binary level to obscure automation signals, allowing scripts to interact with protected websites without being flagged or blocked by security services.
The project distinguishes itself through its ability to maintain stealth during automated sessions, including those executed in headless mode. It achieves this by injecting custom configurations to mimic human user behavior and by hooking into low-level browser debugging protocols to monitor internal states and network traffic in real time.
Beyond its core security capabilities, the framework provides comprehensive tools for managing the browser lifecycle. This includes automated downloading and verification of driver binaries to ensure compatibility with current browser engine releases, as well as persistent profile mapping to maintain session state and cookies across multiple execution cycles. The software supports flexible deployment, including containerized environments and various hardware architectures.
Features
- Automated Web Scraping - Extracts data from websites that employ anti-bot security measures by masking automation signals to prevent detection and blocking.
- Headless Browser Automation - Executes automated browser sessions that maintain stealth by patching low-level driver signatures and managing browser engine versions.
- Anti-Bot Evasion - Patches browser automation drivers to hide non-human signals, allowing scripts to navigate websites protected by anti-bot services.
- Driver Patching Bypasses - Provides a modified browser driver that masks automation signals to bypass anti-bot detection services and prevent automated sessions from being blocked.
- Traffic Mitigation Bypasses - Bypasses sophisticated traffic mitigation platforms and bot detection services during automated browser sessions to ensure consistent and reliable access.
- Browser Session Persistence - Maintains stealthy browser sessions by patching drivers to bypass anti-bot detection and security blocks during automated navigation.
- Binary Patching Utilities - Modifies the executable code of the browser driver at runtime to remove indicators that reveal automated control to security services.
- Browser Session Managers - Provides a utility for configuring browser environments, managing driver binaries, and persisting user profiles to ensure consistent and undetectable web navigation.
- Browser Driver Management - Automatically downloads and maintains the correct driver version to ensure compatibility with the current browser release.
- Browser Driver Configuration - Configures browser driver versions, binary paths, and proxy settings to ensure compatibility and maintain stealth during automated tasks.
- Browser Profile Management - Persists user data and session state across browser restarts by directing the automation to a specific local directory.
- Browser Debugging Protocols - Communicates directly with the browser engine using low-level commands to monitor internal state and intercept network traffic without external plugins.
- Automation Masks - Injects custom configurations into the browser session to mimic human user behavior and hide artifacts left by automation frameworks.
- Browser Binary Managers - Automatically fetches and verifies the correct driver executable version to ensure compatibility with the installed browser engine during initialization.
- Browser Automation Testing - Runs automated quality assurance tests in environments without a graphical interface while maintaining stealth to mimic real user behavior.
- Headless Browsers - Runs automated browser instances without a visible graphical interface while maintaining anti-detection protections.
- Browser Engine Version Controllers - Forces the automation driver to use a specific version of the browser engine to ensure compatibility with target environments or bypass version-based restrictions.
- Browser Environment Configurations - Defines custom execution environments including containerized setups with remote desktop access and various hardware architectures.
