Migration von undetected-chromedriver
Clearcote wird über CDP gesteuert, nicht über WebDriver; der Umstieg führt also von Selenium zu Playwright. Ohne ChromeDriver gibt es keinen Treiber, den Sie patchen oder mit dem Browser synchron halten müssen. Dieselben Schritte gelten für selenium-stealth.
Die Änderung
import undetected_chromedriver as uc
from selenium.webdriver.common.by import By
from clearcote import launch
options = uc.ChromeOptions()
options.add_argument("--proxy-server=http://proxy.example:8080")
driver = uc.Chrome(options=options, headless=True)
browser = launch(
fingerprint="acct-1", # one seed per account: the same device every run
proxy={"server": "http://proxy.example:8080"},
geoip=True, # timezone, language and WebRTC follow the exit IP
humanize=True, # human mouse paths, typing and scrolling
)
page = browser.new_page()
driver.get("https://example.com")
driver.find_element(By.CSS_SELECTOR, "a").click()
print(driver.title)
driver.quit()
page.goto("https://example.com")
page.locator("a").first.click()
print(page.title())
browser.close()launch() lädt beim ersten Aufruf einen verifizierten Clearcote-Build herunter, startet ihn und gibt einen Playwright-Browser zurück.
Von Selenium zu Playwright, Aufruf für Aufruf
| Selenium | Playwright |
|---|---|
driver.get(url) | page.goto(url) |
driver.find_element(By.CSS_SELECTOR, s) | page.locator(s) |
driver.find_element(By.XPATH, x) | page.locator("xpath=" + x) |
el.click(), el.send_keys("x") | loc.click(), loc.fill("x") oder loc.press_sequentially("x") |
el.text, el.get_attribute("href") | loc.inner_text(), loc.get_attribute("href") |
WebDriverWait(driver, 10).until(...) | Meist nichts: Aktionen warten auf das Element. Sonst loc.wait_for() |
driver.execute_script(js) | page.evaluate(js) |
driver.get_cookies(), add_cookie | page.context.cookies(), add_cookies |
driver.save_screenshot(path) | page.screenshot(path=path) |
driver.switch_to.frame(f) | page.frame_locator(s) |
driver.switch_to.window(h) | Jeder Tab ist eine eigene page; context.pages listet sie auf |
Optionen
| Vorher | Mit Clearcote |
|---|---|
stealth(driver, vendor=..., webgl_vendor=..., renderer=..., platform=...) | Entfernen Sie es. Die Persona liefert diese Werte, und sie passen zur GPU, zu den Schriftarten und zum User-Agent |
| eine Proxy-Erweiterung für die Anmeldung | proxy={"server", "username", "password"} in launch(); erfordert den neuesten Build (siehe unten) |
--user-agent, --lang, --window-size | Entfernen Sie sie, oder verwenden Sie accept_language und timezone; geoip=True setzt beides anhand des Proxys |
user_data_dir= | launch_persistent_context(user_data_dir, ...) |
version_main=, Treiber-Patching | Nichts zu patchen: Es gibt keinen ChromeDriver |
Eine große Selenium-Suite?
Selenium und WebDriver werden nicht unterstützt. ChromeDriver kann sich über debugger_address an einen mit serve() gestarteten Browser anhängen, doch der Treiber bringt dann genau die WebDriver-Oberfläche zurück, die dieser Umstieg entfernen soll (siehe Wie Erkennung funktioniert). Nutzen Sie das nur während der Portierung, und portieren Sie die wichtigen Abläufe zuerst.
from urllib.parse import urlparse
from clearcote import serve
from selenium import webdriver
with serve(fingerprint="acct-1") as srv: # unsupported: for the transition only
options = webdriver.ChromeOptions()
options.debugger_address = urlparse(srv.cdp_url).netloc
driver = webdriver.Chrome(options=options)
driver.get("https://example.com")
driver.quit()Den Umstieg prüfen
clearcote info zeigt den Build, den das SDK auflöst, und einen Starttest. Ohne Lizenzschlüssel ist das der offene Build (BSD-3, kein Konto); ein Proxy mit Benutzername und Passwort erfordert den neuesten Build, kostenlos mit einer GitHub-Anmeldung (clearcote login). Öffnen Sie dann das Audit im neuen Setup und vergleichen Sie. Vergleiche: undetected-chromedriver und selenium-stealth.