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
| 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") 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_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) | Chaque onglet est sa propre page ; context.pages les liste |
Options
| Avant | Avec 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’authentification | proxy={"server", "username", "password"} dans launch() ; nécessite le dernier build (voir plus bas) |
--user-agent, --lang, --window-size | Supprimez-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 driver | Rien à 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.
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.