Aller au contenu

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

Migrer depuis Camoufox →

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)

Migrer depuis Fortress →

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

Migrer depuis Browserless →

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

Migrer depuis Browserbase →

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 navigator via evaluateOnNewDocument ou add_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=True et 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.

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

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