thalissonvs / pydoll
- Π²ΡΠΎΡΠ½ΠΈΠΊ, 11 ΠΌΠ°ΡΡΠ° 2025β―Π³. Π² 00:00:02
https://github.com/thalissonvs/pydoll
Pydoll is a library for automating chromium-based browsers without a WebDriver, offering realistic interactions. It supports Python's asynchronous features, enhancing performance and enabling event capturing and simultaneous web scraping.
Pydoll is an innovative Python library that's redefining Chromium browser automation! Unlike other solutions, Pydoll completely eliminates the need for webdrivers, providing a much more fluid and reliable automation experience.
- Zero Webdrivers! Say goodbye to webdriver compatibility and configuration headaches
- Native Captcha Bypass! Naturally passes through Cloudflare Turnstile and reCAPTCHA v3 *
- Performance thanks to native asynchronous programming
- Realistic Interactions that simulate human behavior
- Advanced Event System for complex and reactive automations
Note: for cloudflare captcha, you have to perform a click in the checkbox. Just find a div containing the iframe and use the
.click()method. Automatic detection and click coming soon!
pip install pydoll-pythonSee how simple it is to get started - no webdriver configuration needed!
import asyncio
from pydoll.browser.chrome import Chrome
from pydoll.constants import By
async def main():
# Start the browser with no additional webdriver configuration!
async with Chrome() as browser:
await browser.start()
page = await browser.get_page()
# Navigate through captcha-protected sites without worry
await page.go_to('https://example-with-cloudflare.com')
button = await page.find_element(By.CSS_SELECTOR, 'button')
await button.click()
asyncio.run(main())Powerful interface for global browser control:
async def browser_examples():
async with Chrome() as browser:
await browser.start()
# Control multiple pages with incredible ease
pages = [await browser.get_page() for _ in range(3)]
# Advanced settings with a simple command
await browser.set_window_maximized()Individual page control with surgical precision:
async def page_examples():
page = await browser.get_page()
# Smooth navigation, even on protected sites
await page.go_to('https://site-with-recaptcha.com')
# Capture perfect screenshots
await page.get_screenshot('/screenshots/evidence.png')Interact with elements like a real user:
async def element_examples():
# Natural and precise interactions
input_field = await page.find_element(By.CSS_SELECTOR, 'input')
await input_field.type_keys('Hello World') # Realistic typing!
# Intuitive chained operations
dropdown = await page.find_element(By.CSS_SELECTOR, 'select')
await dropdown.select_option('value')
# Realistic clicks with offset
button = await page.find_element(By.CSS_SELECTOR, 'button')
await button.click(x_offset=5, y_offset=10)Powerful event system for intelligent automation:
from pydoll.events.page import PageEvents
async def event_example():
await page.enable_page_events()
# React to events in real-time!
await page.on(PageEvents.PAGE_LOADED,
lambda e: print('Page loaded successfully!'))Scrape multiple pages simultaneously with extraordinary performance:
async def concurrent_example():
pages = [await browser.get_page() for _ in range(10)]
# Parallel scraping with intelligent resource management
results = await asyncio.gather(
*(scrape_page(page) for page in pages)
)
# Just declare the scrape_page method and see the magic happens!Robust proxy support, including authentication:
async def proxy_example():
options = Options()
# Private or public proxies, you choose!
options.add_argument('--proxy-server=username:password@ip:port')
async with Chrome(options=options) as browser:
await browser.start()For exploring all available methods and additional features, check out:
- Browser interface: pydoll/browser/base.py
- Page interface: pydoll/browser/page.py
- WebElement interface: pydoll/element.py
- Chrome options: Chromium Command Line Switches
Feel free to use, open issues and contributing!