Pular para o conteúdo

Início rápido na nuvem

Inicie um navegador Clearcote nos nossos servidores e controle-o pelo Playwright. Você precisa de uma chave de API, do SDK e de um argumento a mais.

GrátisGanhe €5 de tráfego grátis ao conectar o GitHub. Sem cartão.

Uma única vez, um por conta do GitHub. A conta do GitHub precisa ter pelo menos 30 dias.

Resgatar €5

1. Obtenha uma chave de API

Crie uma na página API keys. Ela começa com cc_live_. Mantenha-a em segredo: qualquer pessoa que a tenha pode gastar o seu saldo. Coloque-a no ambiente:

export CLEARCOTE_API_KEY=cc_live_...

As sessões são pagas com um saldo pré-pago: €1.00 por GB de tráfego, com proxy residencial incluído. Recarregue na aba Hosted browsers do seu painel. Veja Preços e tráfego.

2. Adicione o pacote clearcote

O modo nuvem exige o SDK 0.34.0 ou mais recente.

bash
npm i clearcote          # Node 20+
pip install clearcote    # Python 3.8+

3. Inicie na nuvem

Passe cloud=True (Python) ou cloud: true (Node). Você recebe um Browser comum do Playwright, conectado a um navegador nos nossos servidores.

from clearcote import launch

browser = launch(cloud=True, fingerprint="acct-1", country="de")
page = browser.contexts[0].new_page()
page.goto("https://example.com")
print(page.title())
browser.close()   # ends the cloud session
Esta aba roda na sua máquina.
  • fingerprint escolhe o dispositivo: o mesmo seed gera sempre o mesmo dispositivo. country escolhe o país de saída do IP residencial.
  • Abra as páginas em browser.contexts[0]: esse contexto carrega o perfil e os cookies da sessão.
  • browser.close() encerra a sessão. Você paga pelo tráfego usado, não pelo tempo.
  • Definir CLEARCOTE_CLOUD=1 tem o mesmo efeito que cloud=True, sem mexer no código.

Sem o SDK

Qualquer cliente CDP funciona: POST /api/v1/browsers retorna uma connectUrl de uso único, e o connectOverCDP do Playwright ou o connect do Puppeteer se conecta a ela. O passo a passo completo, com curl, Node e Python, está em Navegadores hospedados.

Próximos passos

Atualizado em 22 de nov. de 2026 · SDK 0.70.4 · navegador r63

Esta página foi útil?