Migrando do Browserless
O Browserless oferece um endereço WebSocket para conectar o Puppeteer ou o Playwright, na nuvem dele ou na imagem Docker dele. O Clearcote também oferece as duas coisas, então o que muda é só o endereço ao qual o seu código se conecta. O código da página continua igual.
Da nuvem do Browserless
Um endereço do Browserless é fixo. Uma sessão do Clearcote é criada primeiro, e a connectUrl dela é usada uma única vez, então a única etapa nova é uma chamada de criação antes de cada conexão. O SDK faz as duas coisas em uma só chamada.
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 sessionPegue a chave na página API keys; o SDK a lê de CLEARCOTE_API_KEY. O navegador inicia quando você se conecta, normalmente em poucos segundos; com um country, pode levar até cerca de meio minuto, então dê ao connectOverCDP do Playwright um timeout de dois minutos. Mantenha defaultViewport: null para que o Puppeteer preserve o tamanho de janela que a persona deu ao navegador.
Para onde vão as opções da URL
As configurações que você coloca na URL do Browserless vão para o corpo JSON da chamada de criação. Flags de inicialização do Chromium não têm equivalente no modo hospedado: a persona e os switches dela são definidos para você.
| Você quer | Corpo da criação |
|---|---|
| uma saída residencial em um país | "country": "de" (também state, city); o pool gerenciado é o padrão |
| seu próprio proxy | "proxy": { "server": "http://host:8080", "username": "…", "password": "…" } |
| o mesmo IP e o mesmo dispositivo para uma conta | "identity": "acct-1" |
| cookies mantidos entre sessões | "profile": { "name": "acct-1", "persist": true } |
| um limite de tempo para a sessão | "timeoutSec", "idleTimeoutSec" |
| uma gravação | "record": true |
| reconectar mais tarde | "keepAlive": true |
Todas as opções estão em Opções e identidades. Stealth não é uma rota separada: todo navegador hospedado roda a persona no nível do motor, e caixas de seleção, sliders e verificações de pressionar e segurar são tratados por padrão (Desafios). Não existem endpoints /content, /screenshot ou /pdf: escreva isso em poucas linhas de Playwright, ou descreva a tarefa e inicie uma execução de agente, que retorna JSON.
Da imagem Docker do Browserless
clearcote serve é o que mais se aproxima da imagem open source: um endpoint fixo, um navegador separado por identidade e as configurações na URL de conexão.
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 16p.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 uma identidade por contêiner, a imagem teamflatearth/clearcote serve CDP na porta 9222; veja Deploy e Docker. Em qualquer caso, mantenha a porta apenas em redes confiáveis: uma porta CDP dá controle total do navegador. Vários navegadores ao mesmo tempo e proxies com senha exigem uma chave de licença: grátis com login do GitHub para um navegador por vez, e Pro para até 250.
Quanto custa
Navegadores hospedados são pagos por GB de tráfego a partir de um saldo pré-pago, sem plano para escolher. Veja Preços e tráfego e, para concorrência, Limites e erros.