Zum Inhalt springen

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

SeleniumPlaywright
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_cookiepage.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

VorherMit 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 Anmeldungproxy={"server", "username", "password"} in launch(); erfordert den neuesten Build (siehe unten)
--user-agent, --lang, --window-sizeEntfernen 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-PatchingNichts 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.

python
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.

Aktualisiert am 20. Okt. 2026 · SDK 0.70.5 · Browser r63

War diese Seite hilfreich?