Pular para o conteúdo

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 session

Pegue 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ê querCorpo 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 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 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.

Atualizado em 16 de out. de 2026 · SDK 0.70.5 · navegador r63

Esta página foi útil?