How thalissonvs/pydoll works
Pydoll is a Python browser-automation library that drives installed Chrome or Edge directly through the Chrome DevTools Protocol (CDP), with async, sync, and Playwright-compatible interfaces. The principal workflow is user code opening a browser and tab, issuing browser actions and queries through CDP, and receiving page data or typed extracted results. Additional branches provide human-like interactions, fingerprint injection, network control, and proxy configuration. The index and README establish these capabilities; several subsystem connections below are documented rather than verified from sampled implementation.
Main entry points: tab.py Tab Automation · base.py Browser Control · web_element.py Web Elements · connection_handler.py WebSocket Connection
Components 20
User APIs
- Async API
pydoll/browser/chromium/chrome.py - Sync API
pydoll/sync/_generated.py - Playwright Layer
pydoll/playwright/_playwright.py
Browser Control
- Browser Control
pydoll/browser/chromium/base.py - Browser Options
pydoll/browser/options.py - Proxy Setup
pydoll/browser/managers/proxy_manager.py - Browser Process
pydoll/browser/managers/browser_process_manager.py
Page Automation
- Tab Automation
pydoll/browser/tab.py - Web Elements
pydoll/elements/web_element.py - Element Queries
pydoll/elements/mixins/find_elements_mixin.py - Frame Access
pydoll/interactions/iframe.py - Typed Extraction
pydoll/extractor/engine.py
Automation Features
- Human Interactions
pydoll/interactions/mouse.py - Fingerprint Injection
pydoll/browser/fingerprint_applier.py - Network Control
pydoll/browser/requests/request.py
CDP Transport
- CDP Commands
pydoll/commands - WebSocket Connection
pydoll/connection/connection_handler.py - CDP Protocol Types
pydoll/protocol/base.py
Other components
- Automation User
- Chrome or Edge
Connections 24
- Automation User → Async API: uses async
README.md - Automation User → Sync API: uses blocking
README.md - Automation User → Playwright Layer: adapts scripts
README.md - Async API → Browser Control: opens browser
- Sync API → Browser Control: wraps browser
pydoll/sync/_generated.py - Playwright Layer → Tab Automation: uses tabs
- Browser Control → Browser Options: configures with
- Browser Control → Browser Process: manages process
- Browser Options → Proxy Setup: configures proxy
pydoll/browser/managers/proxy_manager.py - Browser Control → WebSocket Connection: connects via CDP
- Browser Control → Tab Automation: creates tabs
pydoll/browser/tab.py - Tab Automation → CDP Commands: issues commands
pydoll/browser/tab.py - Tab Automation → Web Elements: returns elements
pydoll/browser/tab.py - Tab Automation → Typed Extraction: extracts models
pydoll/browser/tab.py - Tab Automation → Fingerprint Injection: applies fingerprint
pydoll/browser/tab.py - Tab Automation → Network Control: controls requests
pydoll/browser/tab.py - Web Elements → Element Queries: delegates queries
pydoll/elements/web_element.py - Web Elements → Frame Access: accesses frames
pydoll/elements/web_element.py - Web Elements → Human Interactions: supports actions
pydoll/elements/web_element.py - Typed Extraction → Web Elements: reads page data
pydoll/extractor/engine.py - WebSocket Connection → CDP Protocol Types: sends messages
pydoll/connection/connection_handler.py - CDP Commands → CDP Protocol Types: formats commands
pydoll/commands/storage_commands.py - WebSocket Connection → Chrome or Edge: exchanges CDP
README.md - Chrome or Edge → Tab Automation: serves page state