Aller au contenu

Migrer depuis undetected-chromedriver

Clearcote se pilote via CDP, pas via WebDriver : la migration consiste donc à passer de Selenium à Playwright. Sans ChromeDriver, il n’y a plus de driver à patcher ni à garder synchronisé avec le navigateur. Les mêmes étapes valent pour selenium-stealth.

Le changement

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() télécharge un build vérifié de Clearcote à la première utilisation, le démarre et renvoie un Browser Playwright.

De Selenium à Playwright, appel par appel

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") ou loc.press_sequentially("x")
el.text, el.get_attribute("href")loc.inner_text(), loc.get_attribute("href")
WebDriverWait(driver, 10).until(...)En général rien : les actions attendent l’élément. Sinon 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)Chaque onglet est sa propre page ; context.pages les liste

Options

AvantAvec Clearcote
stealth(driver, vendor=..., webgl_vendor=..., renderer=..., platform=...)Supprimez-le. La persona fournit ces valeurs, et elles concordent avec le GPU, les polices et le user agent
une extension de proxy pour l’authentificationproxy={"server", "username", "password"} dans launch() ; nécessite le dernier build (voir plus bas)
--user-agent, --lang, --window-sizeSupprimez-les, ou utilisez accept_language et timezone ; geoip=True définit les deux à partir du proxy
user_data_dir=launch_persistent_context(user_data_dir, ...)
version_main=, patch du driverRien à patcher : il n’y a pas de ChromeDriver

Une grosse suite Selenium ?

Selenium et WebDriver ne sont pas pris en charge. ChromeDriver peut s’attacher via debugger_address à un navigateur lancé avec serve(), mais le driver réintroduit alors la surface WebDriver que cette migration doit justement supprimer (voir Fonctionnement de la détection). Ne l’utilisez que pendant le portage, et migrez d’abord les parcours importants.

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()

Vérifier la migration

clearcote info affiche le build que le SDK résout et un test de lancement. Sans clé de licence, c’est le build ouvert (BSD-3, sans compte) ; un proxy avec nom d’utilisateur et mot de passe nécessite le dernier build, gratuit avec une connexion GitHub (clearcote login). Ouvrez ensuite l’audit dans la nouvelle configuration et comparez. Comparatifs : undetected-chromedriver et selenium-stealth.

Mis à jour le 20 oct. 2026 · SDK 0.70.5 · navigateur r63

Cette page vous a-t-elle été utile ?