Saltar al contenido

Migrar desde Browserless

Browserless te da una dirección WebSocket a la que conectar Puppeteer o Playwright, en su nube o en su imagen de Docker. Clearcote también ofrece ambas cosas, así que lo único que cambia es la dirección a la que se conecta tu código. El código de la página se queda igual.

Desde la nube de Browserless

Una dirección de Browserless es fija. Una sesión de Clearcote se crea primero y su connectUrl se usa una sola vez, así que el único paso nuevo es una llamada de creación antes de cada conexión. El SDK hace ambas cosas en una sola llamada.

import puppeteer from "puppeteer-core";

async function connectUrl(options = {}) {
  const res = await fetch("https://www.clearcotelabs.com/api/v1/browsers", {
    method: "POST",
    headers: { authorization: "Bearer " + process.env.CLEARCOTE_API_KEY, "content-type": "application/json" },
    body: JSON.stringify(options),
  });
  const { connectUrl, error } = await res.json();
  if (error) throw new Error(error);
  return connectUrl;                      // single-use: create one per connection
}

const browser = await puppeteer.connect({
  browserWSEndpoint: "wss://production-sfo.browserless.io?token=" + process.env.BROWSERLESS_TOKEN,
  browserWSEndpoint: await connectUrl({ identity: "acct-1", country: "us" }),
  defaultViewport: null,
});
const page = await browser.newPage();
await page.goto("https://example.com");
await browser.close();                    // ends the session

Obtén la clave en la página “API keys”; el SDK la lee de CLEARCOTE_API_KEY. El navegador arranca cuando te conectas, normalmente en pocos segundos; con un country puede tardar hasta medio minuto, así que dale a connectOverCDP de Playwright un timeout de dos minutos. Mantén defaultViewport: null para que Puppeteer conserve el tamaño de ventana que la persona le dio al navegador.

Adónde van las opciones de la URL

Los ajustes que pones en la URL de Browserless van en el cuerpo JSON de la llamada de creación. Los flags de inicio de Chromium no tienen equivalente en el modo alojado: la persona y sus switches se configuran por ti.

QuieresCuerpo de creación
una salida residencial en un país"country": "de" (también state, city); el pool gestionado es el predeterminado
tu propio proxy"proxy": { "server": "http://host:8080", "username": "…", "password": "…" }
la misma IP y el mismo dispositivo para una cuenta"identity": "acct-1"
cookies que se conservan entre sesiones"profile": { "name": "acct-1", "persist": true }
un límite de tiempo para la sesión"timeoutSec", "idleTimeoutSec"
una grabación"record": true
volver a conectarte más tarde"keepAlive": true

Todas las opciones están en Opciones e identidades. El stealth no es una ruta aparte: cada navegador alojado ejecuta la persona a nivel del motor, y las casillas, los sliders y las verificaciones de presionar y mantener se gestionan por defecto (Desafíos). No hay endpoints /content, /screenshot ni /pdf: escríbelos con unas pocas líneas de Playwright, o describe la tarea e inicia una ejecución de agente, que devuelve JSON.

Desde la imagen de Docker de Browserless

clearcote serve es lo más parecido a la imagen open source: un endpoint permanente, un navegador propio por identidad y los ajustes en la URL de conexión.

docker run -p 3000:3000 -e TOKEN=... ghcr.io/browserless/chromium
pip install -U clearcote          # or: npm install -g clearcote
clearcote serve --port 9222 --idle-timeout 300 --max-browsers 16
python
p.chromium.connect_over_cdp("http://127.0.0.1:9222")                                     # one shared browser
p.chromium.connect_over_cdp("http://127.0.0.1:9222?fingerprint=acct-1&platform=windows")  # a browser of its own
p.chromium.connect_over_cdp("http://127.0.0.1:9222?fingerprint=acct-2&proxy=http://user:pass@host:8080&geoip=true")

Para una identidad por contenedor, la imagen teamflatearth/clearcote sirve CDP en el puerto 9222; consulta Despliegue y Docker. En cualquier caso, mantén el puerto solo en redes de confianza: un puerto CDP da control total del navegador. Varios navegadores a la vez y los proxies con contraseña necesitan una clave de licencia: gratis iniciando sesión con GitHub para un navegador a la vez, y Pro para hasta 250.

Cuánto cuesta

Los navegadores alojados se pagan por GB de tráfico desde un saldo prepago, sin ningún plan que elegir. Consulta Precios y tráfico, y Límites y errores para la concurrencia.

Actualizado el 16 oct 2026 · SDK 0.70.5 · navegador r63

¿Te resultó útil esta página?