pydoll-python

What it is and what it does

Pydoll is a Python library for automating Chromium browsers by connecting directly to the Chrome DevTools Protocol over WebSocket, eliminating the need for a WebDriver binary or the `navigator.webdriver` flag. It combines human-like interactions—Bezier-curve mouse movement, realistic typing, and scroll physics—with fingerprint injection that overrides User-Agent, Client Hints, navigator properties, WebGL, canvas, screen, fonts, timezone, and locale to present a consistent, non-bot identity. The library is built on asyncio and fully type-checked with mypy, offering clean async-native APIs for finding elements, clicking, typing, scrolling, intercepting network requests, and extracting structured data via Pydantic models.

The core use case is web scraping and automation that needs to bypass bot-detection systems like Cloudflare Turnstile or reCAPTCHA v3. It supports shadow DOM and cross-origin iframes, network request interception and monitoring, and authenticated HTTP requests that inherit the browser session. The maintainer notes the project is active but moving at a calmer pace as a single-person effort; Firefox support is planned once the project reaches 10k GitHub stars.

Use it for

• Scrape sites protected by Cloudflare Turnstile or reCAPTCHA v3 by automating realistic user interactions and spoofing a consistent browser fingerprint.
• Monitor competitor pricing or content changes on bot-protected websites without triggering detection systems.
• Test web applications' anti-bot defenses and behavioral challenges in a controlled, headless environment.
• Intercept and analyze network traffic during automation to discover undocumented APIs or track third-party requests.
• Extract structured data from dynamic pages using Pydantic models for automatic validation and type safety.

Worth the install?

AI-flagged interpretation of the facts on this page. Verify before relying on it.

Install

pydoll-python on PyPI

Before you install

Low install friction with five async-first runtime dependencies (aiofiles, aiohttp, pydantic, typing_extensions, websockets). Active maintenance with a release 1 day old. Single-maintainer project currently moving at a calmer pace, so response times may be longer than typical.

Requires Python 3.10 or later and a local Chromium installation; async/await syntax is mandatory.

License in practice

License status is unclear—no SPDX identifier or raw license text is available in the package metadata. Verify the actual license terms before use in proprietary or commercial projects.

Quickstart

import asyncio
from pydoll.browser import Chrome

async def automate():
    async with Chrome() as browser:
        tab = await browser.start()
        await tab.go_to('https://example.com')
        element = await tab.find(tag_name='input')
        await element.type_text('query', humanize=True)

asyncio.run(automate())

Package facts

Evidence: pydoll_python-2.24.0-py3-none-any.whl

Tags

More Dynamic Content packages

See also cloakbrowser · nodriver · zendriver · undetected-chromedriver · mycdp · pychrome · selenium-stealth · selenium · pyppeteer · choreographer

Further reading