Installation

Installieren Sie das SDK und lassen Sie es einen verifizierten Browser holen — oder laden Sie einen Build selbst herunter und verifizieren Sie ihn.

Clearcote befindet sich in aktiver Entwicklung. Builds gibt es für Windows x64 und Linux x64 — das SDK lädt automatisch den passenden für Ihr Betriebssystem. macOS steht auf der Roadmap; bis dahin können macOS-Nutzer das Docker-Image verwenden. Auf einem minimalen Linux-Host installieren Sie die Laufzeitbibliotheken des Browsers (libnss3 libgbm1 libasound2 libatk1.0-0 libatk-bridge2.0-0 libcups2 libxkbcommon0 libpango-1.0-0 …) — clearcote info zeigt an, welche fehlen. Wenn Sie das Binary selbst als root starten (in Containern üblich), übergeben Sie --no-sandbox; das SDK und clearcote serve erledigen das für Sie.

SDK installieren (empfohlen)

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

Der erste Aufruf von launch() lädt den Browser für Ihr Betriebssystem herunter, prüft seine SHA-256-Prüfsumme und legt ihn im Cache ab. playwright install müssen Sie nicht ausführen — jedes SDK bringt seinen eigenen Playwright-Treiber mit und holt sich seinen Browser selbst. Welchen Build Sie bekommen, hängt davon ab, ob ein Lizenzschlüssel gesetzt ist:

Lizenzschlüssel setzen

Das SDK sucht den Schlüssel in dieser Reihenfolge: zuerst die Launch-Option licenseKey / license_key / LicenseKey, dann die Umgebungsvariable CLEARCOTE_LICENSE_KEY, dann ~/.clearcote/license.key — die Datei, die clearcote login schreibt. Jedes SDK, auch das für .NET, liest diese Datei. Einen kostenlosen Schlüssel erhalten Sie unter Lizenzen in Ihrem Dashboard.

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

Der Befehl clearcote

Die Python- und Node-Pakete installieren den Befehl clearcote (bei einer lokalen npm-Installation rufen Sie ihn als npx clearcote … auf). Das .NET-Paket bringt keinen mit.

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

Mit clearcote install --version 153 oder --channel preview wählen Sie einen bestimmten Build; siehe Build auswählen. Als Nächstes binden Sie ihn in Playwright oder Puppeteer ein.

Manuelle Installation (offener Build)

Lieber das nackte Binary? Auf GitHub Releases liegt der offene Build. Der lizenzierte Build wird dort nicht veröffentlicht: Er läuft über das SDK, clearcote serve oder das Docker-Image und startet nicht ohne das Run-Token, das das SDK bereitstellt.

1. Herunterladen

Laden Sie das neueste Release v0.1.0-pre.* herunter — derzeit v0.1.0-pre.22 (Chromium 149.0.7827.114). Jedes Release enthält:

• clearcote-<version>-windows-x64.zip — den Windows-Build (Chromium + Runtime + VC++-DLLs)
• clearcote-<version>-linux-x64.tar.xz — den Linux-Build
• .sha256-Dateien und SHA256SUMS.txt — die Prüfsummen
• .asc-Dateien + clearcote-signing-key.asc — abgetrennte GPG-Signaturen und den öffentlichen Schlüssel

2. Verifizieren (empfohlen)

Der offene Build ist so angelegt, dass Sie uns nicht vertrauen müssen. Prüfen Sie vor dem Entpacken, ob der Download exakt dem entspricht, was gebaut und signiert wurde — siehe Verifizierung.

3. Entpacken

Das Windows-Archiv ist in sich vollständig: Die Laufzeit-DLLs von VC++ 2015–2022 liegen bei, es läuft also auf einem frisch installierten Windows 10/11. Das Linux-Archiv braucht die oben genannten Laufzeitbibliotheken.

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

Starten Sie den Browser mit einem Seed auf einer Fingerprint-Testseite:

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

Gleicher --fingerprint-Seed ⇒ bei jedem Start dieselbe Identität; neuer Seed ⇒ eine neue. Sollen statt der aus dem Seed abgeleiteten Werte die erfassten Werte eines echten Rechners gemeldet werden, importieren Sie ein erfasstes Profil — siehe Fingerprint-Flags. Binden Sie den Browser anschließend in Playwright oder Puppeteer ein.

In Docker ausführen

Das offizielle Image betreibt Clearcote als CDP-Endpunkt: Image ziehen und einen beliebigen Playwright-, Puppeteer- oder browser-use-Client per Chrome DevTools Protocol darauf richten, ohne Codeänderung.

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

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

Die Persona konfigurieren Sie über Umgebungsvariablen — CC_PLATFORM (windows/linux/macos/android), CC_FINGERPRINT (Seed), CC_BRAND (Edge…), CC_ACCEPT_LANGUAGE, CC_TIMEZONE, CC_TLS_PROFILE. Setzen Sie CC_FINGERPRINT pro Identität: Ohne diese Variable teilen sich alle Container denselben Standard-Seed. Das Image enthält den offenen Build; mit -e CLEARCOTE_LICENSE_KEY=cc_lic_… -v clearcote-cache:/opt/xdg-cache läuft der neueste lizenzierte Build, der einmalig in das Volume heruntergeladen wird. Der Browser läuft im Headed-Modus auf einem virtuellen Display (CC_HEADLESS=1 für reinen Headless-Betrieb), und das Image ist linux/amd64. Das Dockerfile ist nachprüfbar — bauen Sie es selbst neu. Wer den CDP-Endpunkt erreicht, hat volle Kontrolle über den Browser; geben Sie ihn daher nur in vertrauenswürdigen Netzen frei (-p 127.0.0.1:9222:9222 hält ihn lokal auf dem Host). Mehr dazu unter Deployment.

Voraussetzungen

• Windows 10 / 11 x64 oder Linux x64 (glibc) mit den oben genannten Laufzeitbibliotheken.
• Unter Windows ist kein separates VC++ Redistributable nötig — es liegt dem Archiv bei.
• SDK: Node 20+, Python 3.8+ oder .NET 8. Jedes bringt seinen eigenen Playwright-Treiber mit (playwright-core, playwright, Microsoft.Playwright).
• Wenn Sie das Binary des offenen Builds direkt verwenden: Ihre vorhandene Playwright- oder Puppeteer-Installation (Clearcote ersetzt den Browser, nicht den Treiber).