Instalación

Instala el SDK y deja que descargue un navegador verificado, o descarga y verifica un build por tu cuenta.

Clearcote está en desarrollo activo. Hay builds para Windows x64 y Linux x64, y el SDK descarga el que corresponde a tu sistema operativo. macOS está en el roadmap; mientras tanto, en macOS puedes ejecutar la imagen de Docker. En un host Linux mínimo, instala las bibliotecas de runtime del navegador (libnss3 libgbm1 libasound2 libatk1.0-0 libatk-bridge2.0-0 libcups2 libxkbcommon0 libpango-1.0-0 …); clearcote info indica las que faltan. Si inicias el binario tú mismo como root (lo habitual en contenedores), pasa --no-sandbox; el SDK y clearcote serve se encargan de eso por ti.

NuevoEl build más reciente es gratis con GitHub para un navegador. Sin tarjeta.

Obtenlo gratis

Instala el SDK (recomendado)

bash

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

El primer launch() descarga el navegador para tu sistema operativo, comprueba su SHA-256 y lo guarda en caché. No hace falta ejecutar playwright install: cada SDK trae su driver de Playwright y descarga su propio navegador. El build que obtienes depende de si hay una clave de licencia configurada:

	Build	De dónde viene
Sin clave	El build abierto: Chromium 149.0.7827.114 (v0.1.0-pre.22). BSD-3, reproducible desde el código público.	GitHub Releases, fijado por la versión del SDK
Con clave	El build con licencia: Chromium 153.0.8010.36-r28. Gratis con GitHub para un navegador a la vez, o Pro.	clearcotelabs.com, el build actual en cada lanzamiento

Configura una clave de licencia

El SDK busca la clave en este orden: la opción de lanzamiento licenseKey / license_key / LicenseKey, luego la variable de entorno CLEARCOTE_LICENSE_KEY y, por último, ~/.clearcote/license.key, el archivo que escribe clearcote login. Todos los SDK, incluido el de .NET, leen ese archivo. Consigue una clave gratis en “Licenses”, en tu panel.

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

El comando clearcote

Los paquetes de Python y Node instalan un comando clearcote (con una instalación local de npm, ejecútalo como npx clearcote …). El paquete de .NET no incluye ninguno.

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 o --channel preview elige un build concreto; consulta cómo elegir un build. Después, intégralo con Playwright o Puppeteer.

Instalación manual (build abierto)

¿Prefieres el binario sin más? En GitHub Releases está el build abierto. El build con licencia no se publica ahí: se ejecuta a través del SDK, de clearcote serve o de la imagen de Docker, y no arranca sin el token de ejecución que proporciona el SDK.

1. Descarga

Descarga la versión v0.1.0-pre.* más reciente; actualmente es v0.1.0-pre.22 (Chromium 149.0.7827.114). Cada versión incluye:

clearcote-<version>-windows-x64.zip: el build para Windows (Chromium + runtime + DLLs de VC++)
clearcote-<version>-linux-x64.tar.xz: el build para Linux
archivos .sha256 y SHA256SUMS.txt: checksums
archivos .asc + clearcote-signing-key.asc: firmas GPG separadas y la clave pública

2. Verifica (recomendado)

El build abierto está hecho para que no tengas que confiar en nosotros. Antes de extraerlo, confirma que la descarga es exactamente lo que se compiló y firmó; consulta Verificación.

3. Extrae

El archivo de Windows es autónomo: incluye las DLLs del runtime de VC++ 2015–2022, así que funciona en un Windows 10/11 recién instalado. El archivo de Linux necesita las bibliotecas de runtime indicadas arriba.

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. Prueba de humo

Lánzalo con un seed contra una página de test de huella digital:

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

Mismo seed de --fingerprint ⇒ la misma identidad en cada lanzamiento; un seed nuevo ⇒ una identidad nueva. Para reportar los valores capturados de una máquina real en lugar de los derivados del seed, importa un perfil capturado; consulta Flags de huella digital. Después, intégralo con Playwright o Puppeteer.

Ejecución en Docker

La imagen oficial ejecuta Clearcote como un endpoint CDP: descárgala y apunta cualquier cliente de Playwright, Puppeteer o browser-use hacia ella mediante el Chrome DevTools Protocol, sin cambiar el código.

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

Configura la persona con variables de entorno: CC_PLATFORM (windows/linux/macos/android), CC_FINGERPRINT (seed), CC_BRAND (Edge…), CC_ACCEPT_LANGUAGE, CC_TIMEZONE, CC_TLS_PROFILE. Define CC_FINGERPRINT para cada identidad: sin ella, todos los contenedores comparten el mismo seed por defecto. La imagen incluye el build abierto; agrega -e CLEARCOTE_LICENSE_KEY=cc_lic_… -v clearcote-cache:/opt/xdg-cache para ejecutar el build con licencia más reciente, que se descarga una sola vez en el volumen. El navegador se ejecuta en modo headed sobre una pantalla virtual (CC_HEADLESS=1 para headless puro) y la imagen es linux/amd64. El Dockerfile se puede auditar: recompílalo tú mismo. El endpoint CDP da control total del navegador, así que publícalo solo en redes de confianza (-p 127.0.0.1:9222:9222 lo mantiene local al host). Más información en Despliegue.

Requisitos

Windows 10 / 11 x64, o Linux x64 (glibc) con las bibliotecas de runtime indicadas arriba.
En Windows no hace falta instalar aparte el redistribuible de VC++: viene incluido en el archivo.
SDK: Node 20+, Python 3.8+ o .NET 8. Cada uno instala su propio driver de Playwright (playwright-core, playwright, Microsoft.Playwright).
Si usas directamente el binario del build abierto: tu instalación actual de Playwright o Puppeteer (Clearcote reemplaza el navegador, no el driver).