Pydoll

Pydoll is an async Python web automation library built on Chrome DevTools Protocol (CDP). It is designed for browser automation on anti-bot-protected sites,…

Pydoll

Pydoll is an async Python web automation library built on Chrome DevTools Protocol (CDP). It is designed for browser automation on anti-bot-protected sites, with first-class support for fingerprint evasion, proxy configuration, and behavioral mimicry.

Docs: https://pydoll.tech

Core Design

Uses CDP directly rather than WebDriver (Selenium/Playwright), which eliminates the navigator.webdriver automation flag at the source — no patching required. All operations are async (asyncio).

Key Capabilities

• WebRTC leak protection: options.webrtc_leak_protection = True adds --force-webrtc-ip-handling-policy=disable_non_proxied_udp
• Proxy support: HTTP, HTTPS, SOCKS4, SOCKS5; includes a built-in SOCKS5Forwarder to work around Chrome’s lack of inline SOCKS5 authentication
• Browser preferences API: direct control over WebRTC settings, multiple routes, nonproxied UDP
• Request interception: header consistency enforcement
• Behavioral mimicry: human-like timing, entropy injection

Documentation Modules

Module	Coverage
Network Fundamentals	OSI model, TCP/UDP, WebRTC leaks, ICE, STUN, QUIC
Browser Fingerprinting	Canvas/WebGL, audio API, navigator, fonts
Network Fingerprinting	TCP/IP, TLS/JA3/JA4, HTTP/2
Behavioral Fingerprinting	Mouse, keystroke, scroll ML models
Evasion Techniques	CDP spoofing, JS overrides, behavioral mimicry
Legal & Ethical	GDPR, CFAA, ToS compliance, rate limiting

Related Pages

• Web Fingerprinting — the detection model Pydoll is designed to evade
• WebRTC IP Leak — the leak vector Pydoll’s webrtc_leak_protection addresses
• Proxy Rotation — proxy types and strategies Pydoll supports