Passer à Clearcote
Clearcote est un vrai Chromium qui parle CDP : le code existant se migre donc généralement en modifiant les seules lignes qui démarrent ou trouvent le navigateur. Le code qui suit reste identique.
Depuis Playwright
launch() renvoie le même Browser Playwright, seul l’appel de lancement change donc. Avec playwright-stealth ou Patchright, le plugin disparaît aussi.
from playwright.sync_api import sync_playwright
browser = sync_playwright().start().chromium.launch()
from clearcote import launch
browser = launch(fingerprint="acct-1")
page = browser.new_page()Migrer depuis playwright-stealth ou Patchright →
Depuis puppeteer-extra-plugin-stealth
Gardez Puppeteer et retirez le plugin. serve() démarre Clearcote avec un endpoint CDP, auquel Puppeteer se connecte.
import puppeteer from "puppeteer-extra";
import StealthPlugin from "puppeteer-extra-plugin-stealth";
puppeteer.use(StealthPlugin());
const browser = await puppeteer.launch();
import puppeteer from "puppeteer-core";
import { serve } from "clearcote";
const srv = await serve({ fingerprint: "acct-1" });
const browser = await puppeteer.connect({ browserURL: srv.cdpUrl, defaultViewport: null });
const page = await browser.newPage();Migrer depuis puppeteer-extra-plugin-stealth →
Depuis undetected-chromedriver
C’est la seule migration qui demande plus d’une ligne : Clearcote se pilote via CDP, pas via WebDriver, le script passe donc à Playwright. La plupart des appels Selenium ont un équivalent en une ligne. Il en va de même pour selenium-stealth.
import undetected_chromedriver as uc
driver = uc.Chrome(headless=True)
driver.get("https://example.com")
from clearcote import launch
browser = launch(fingerprint="acct-1")
page = browser.new_page()
page.goto("https://example.com")Migrer depuis undetected-chromedriver →
Depuis Camoufox
Les deux vous donnent un objet Playwright issu d’un moteur patché : Camoufox(...) devient donc launch(...), le plus souvent avec les mêmes noms d’options, sur Chromium.
from camoufox.sync_api import Camoufox
with Camoufox(os="windows", humanize=True) as browser:
page = browser.new_page()
from clearcote import launch
browser = launch(platform="windows", humanize=True, fingerprint="acct-1")
page = browser.new_page()Depuis une application de navigateur anti-détection
Multilogin, GoLogin, AdsPower, Dolphin Anty, Kameleo : un profil devient un seed pour l’appareil et un dossier pour les cookies. Plus d’application de bureau à laisser tourner, plus d’API locale à appeler d’abord.
ws = start_profile("k1abc23") # the app's local API hands out a CDP address
browser = sync_playwright().start().chromium.connect_over_cdp(ws)
page = browser.contexts[0].new_page()
from clearcote import launch_persistent_context
context = launch_persistent_context("profiles/acct-1", fingerprint="acct-1")
page = context.new_page()Migrer depuis une application de navigateur anti-détection →
Depuis Fortress (versions BSD)
Votre client continue de se connecter à un endpoint CDP ; seul ce qui démarre l’endpoint change. Dans Docker, remplacez l’image par teamflatearth/clearcote et gardez le port.
with Fortress() as f:
browser = p.chromium.connect_over_cdp(f.cdp_url)
with serve(fingerprint="acct-1", port=9222) as srv:
browser = p.chromium.connect_over_cdp(srv.cdp_url)Depuis Browserless
Votre code se connecte toujours à une adresse WebSocket. Une session Clearcote vous en fournit une par connexion, ou le SDK crée la session et s’y connecte en un seul appel.
import { chromium } from "playwright-core";
const browser = await chromium.connectOverCDP("wss://production-sfo.browserless.io?token=" + TOKEN);
import { launch } from "clearcote";
const browser = await launch({ cloud: true, identity: "acct-1", country: "us" });
const page = await browser.contexts()[0].newPage();Depuis Browserbase
Même principe : créer une session, se connecter à son adresse. sessions.create() devient POST /api/v1/browsers, ou launch(cloud=True) fait les deux.
session = Browserbase(api_key=BROWSERBASE_API_KEY).sessions.create()
browser = sync_playwright().start().chromium.connect_over_cdp(session.connect_url)
from clearcote import launch
browser = launch(cloud=True, identity="acct-1", country="us")
page = browser.contexts[0].new_page()Ce que vous pouvez supprimer au passage
Clearcote définit l’empreinte dans le moteur, à partir d’un seul seed fingerprint. Tout ce que votre ancienne configuration modifiait de l’extérieur joue désormais contre elle :
- les plugins stealth et les scripts d’évasion (patchs de
navigatorviaevaluateOnNewDocumentouadd_init_script) ; - un user agent, un viewport, une plateforme, un vendor WebGL ou une chaîne GPU définis à la main ;
- les surcharges de fuseau horaire et de langue quand vous utilisez un proxy : passez
geoip=Trueet elles suivent l’IP de sortie.
Donnez à chaque compte son propre seed et conservez-le : le même seed, c’est le même appareil à chaque fois. Sans clé de licence, le SDK exécute le build ouvert (BSD-3, sans compte) ; une clé gratuite obtenue en vous connectant avec GitHub donne accès au dernier build. Voir Réglages recommandés et Installation.