Installation

Installez le SDK et laissez-le récupérer un navigateur vérifié — ou téléchargez et vérifiez un build vous-même.

Clearcote est en développement actif. Des builds sont disponibles pour Windows x64 et Linux x64 — le SDK télécharge celui qui correspond à votre OS. macOS figure sur la feuille de route ; d’ici là, les utilisateurs de macOS peuvent utiliser l’image Docker. Sur un hôte Linux minimal, installez les bibliothèques d’exécution du navigateur (libnss3 libgbm1 libasound2 libatk1.0-0 libatk-bridge2.0-0 libcups2 libxkbcommon0 libpango-1.0-0 …) — clearcote info liste celles qui manquent. Si vous lancez vous-même le binaire en root (le cas typique dans un conteneur), passez --no-sandbox ; le SDK et clearcote serve s’en chargent pour vous.

NouveauLe dernier build est gratuit avec GitHub pour un navigateur. Sans carte.

Obtenir gratuitement

Installer le SDK (recommandé)

bash

npm i clearcote                # Node 20+
pip install clearcote          # Python 3.8+
dotnet add package Clearcote   # .NET 8

Le premier launch() télécharge le navigateur pour votre OS, vérifie son SHA-256 et le met en cache. Vous n’avez pas à lancer playwright install — chaque SDK apporte son driver Playwright et récupère son propre navigateur. Le build que vous obtenez dépend de la présence d’une clé de licence :

	Build	Provenance
Sans clé	Le build ouvert — Chromium 149.0.7827.114 (v0.1.0-pre.22). BSD-3, reproductible à partir des sources publiques.	GitHub Releases, épinglé par la version du SDK
Avec une clé	Le build sous licence — Chromium 153.0.8010.36-r28. Gratuit avec GitHub pour un navigateur à la fois, ou Pro.	clearcotelabs.com, le build actuel à chaque lancement

Définir une clé de licence

Le SDK cherche une clé dans cet ordre : l’option de lancement licenseKey / license_key / LicenseKey, puis la variable d’environnement CLEARCOTE_LICENSE_KEY, puis ~/.clearcote/license.key — le fichier qu’écrit clearcote login. Tous les SDK, .NET compris, lisent ce fichier. Obtenez une clé gratuite dans la section « Licenses » de votre tableau de bord.

bash

clearcote login cc_lic_...              # checks the key, saves it to ~/.clearcote/license.key
export CLEARCOTE_LICENSE_KEY=cc_lic_...  # or per process / per container

La commande clearcote

Les packages Python et Node installent une commande clearcote (avec une installation npm locale, lancez-la via npx clearcote …). Le package .NET n’en fournit pas.

bash

clearcote install              # download + verify the browser now (CI, Docker builds)
clearcote info                 # SDK, key, cached builds, seats in use, a launch test, missing libraries
clearcote info --proxy <url>   # the exit IP, timezone and language a launch through this proxy would get
clearcote update               # fetch a newer build if one exists (newest open build, or current licensed)
clearcote clear-cache          # delete cached builds — old ones are kept until you do
clearcote login [key]          # clearcote logout removes the saved key
clearcote serve                # a standing CDP endpoint — see Deployment

clearcote install --version 153 ou --channel preview sélectionne un build précis ; voir choisir un build. Ensuite, branchez-le sur Playwright ou Puppeteer.

Installation manuelle (build ouvert)

Vous préférez le binaire brut ? GitHub Releases propose le build ouvert. Le build sous licence n’y est pas publié : il s’exécute via le SDK, clearcote serve ou l’image Docker, et ne démarre pas sans le jeton d’exécution fourni par le SDK.

1. Télécharger

Téléchargez la version v0.1.0-pre.* la plus récente — actuellement v0.1.0-pre.22 (Chromium 149.0.7827.114). Chaque version contient :

clearcote-<version>-windows-x64.zip — le build Windows (Chromium + runtime + DLL VC++)
clearcote-<version>-linux-x64.tar.xz — le build Linux
les fichiers .sha256 et SHA256SUMS.txt — sommes de contrôle
les fichiers .asc + clearcote-signing-key.asc — signatures GPG détachées et clé publique

2. Vérifier (recommandé)

Le build ouvert est conçu pour que vous n’ayez pas à nous croire sur parole. Avant l’extraction, vérifiez que le téléchargement correspond exactement à ce qui a été compilé et signé — voir Vérification.

3. Extraire

L’archive Windows est autonome : les DLL du runtime VC++ 2015–2022 sont incluses, elle tourne donc sur une machine Windows 10/11 vierge. L’archive Linux nécessite les bibliothèques d’exécution listées plus haut.

Expand-Archive clearcote-149.0.7827.114-windows-x64.zip -DestinationPath C:\clearcote

# you now have:
#   C:\clearcote\chrome.exe
#   C:\clearcote\chrome.dll  + runtime, locales, ICU, ANGLE, VC++ DLLs

4. Smoke test

Lancez-le sur une page de test d’empreinte avec une seed :

C:\clearcote\chrome.exe --fingerprint=seed-123 --fingerprint-platform=windows https://abrahamjuliot.github.io/creepjs/

Même seed --fingerprint ⇒ même identité à chaque lancement ; nouvelle seed ⇒ nouvelle identité. Pour que le navigateur renvoie les valeurs capturées sur une vraie machine plutôt que celles dérivées de la seed, importez un profil capturé — voir Flags d’empreinte. Ensuite, branchez-le sur Playwright ou Puppeteer.

Lancer avec Docker

L’image officielle exécute Clearcote en tant qu’endpoint CDP — récupérez-la et pointez-y n’importe quel client Playwright, Puppeteer ou browser-use via le Chrome DevTools Protocol, sans modifier votre code.

bash

docker run -d --rm -p 127.0.0.1:9222:9222 -e CC_FINGERPRINT=user-7423 teamflatearth/clearcote   # CDP on http://localhost:9222

python

from playwright.sync_api import sync_playwright
with sync_playwright() as p:
    browser = p.chromium.connect_over_cdp("http://localhost:9222")   # your code, unchanged
    page = browser.new_page(); page.goto("https://example.com")

Configurez la persona avec des variables d’environnement — CC_PLATFORM (windows/linux/macos/android), CC_FINGERPRINT (seed), CC_BRAND (Edge…), CC_ACCEPT_LANGUAGE, CC_TIMEZONE, CC_TLS_PROFILE. Définissez CC_FINGERPRINT pour chaque identité : sans cette variable, tous les conteneurs partagent la même seed par défaut. L’image embarque le build ouvert ; ajoutez -e CLEARCOTE_LICENSE_KEY=cc_lic_… -v clearcote-cache:/opt/xdg-cache pour exécuter le dernier build sous licence, téléchargé une seule fois dans le volume. Le navigateur tourne en mode headed sur un écran virtuel (CC_HEADLESS=1 pour du pur headless), et l’image est en linux/amd64. Le Dockerfile est auditable — reconstruisez l’image vous-même. L’endpoint CDP donne le contrôle total du navigateur : ne l’exposez qu’à des réseaux de confiance (-p 127.0.0.1:9222:9222 le limite à la machine hôte). Plus de détails dans Déploiement.

Configuration requise

Windows 10 / 11 x64, ou Linux x64 (glibc) avec les bibliothèques d’exécution ci-dessus.
Aucun redistribuable VC++ à installer séparément sous Windows — il est inclus dans l’archive.
SDK : Node 20+, Python 3.8+ ou .NET 8. Chacun installe son propre driver Playwright (playwright-core, playwright, Microsoft.Playwright).
Pour utiliser directement le binaire du build ouvert : votre installation existante de Playwright ou de Puppeteer (Clearcote remplace le navigateur, pas le driver).