Um navegador antidetect em um único docker run
Baixe a imagem oficial e você tem um navegador Clearcote escutando numa porta CDP. Aponte o Playwright, o Puppeteer, o browser-use, o Crawl4AI ou o Stagehand para ele e o seu código continua como está. A imagem inicia o binário diretamente, sem o switch de automação, e o navigator.webdriver continua false.
A imagem roda o build aberto sem chave. Adicione uma chave grátis via GitHub para ter o build mais recente.
Rode e conecte
# CDP on http://localhost:9222, published to this host only
docker run -d --rm -p 127.0.0.1:9222:9222 --shm-size=1g teamflatearth/clearcoteDestaques
Um binário verificado, já embutido
A imagem traz o build aberto para Linux, verificado por SHA-256, e clones com métricas compatíveis das fontes mais comuns do Windows, então o texto latino tem as mesmas medidas que teria nas fontes da persona. O pacote de fontes do build aberto não tem faces CJK; o do build licenciado tem.
Configurado por variáveis de ambiente
Seed, plataforma, marca, idioma, fuso horário e perfil TLS são variáveis de ambiente CC_*. Não há código dentro do container para manter.
O build mais recente sob demanda
Defina CLEARCOTE_LICENSE_KEY e o container resolve o build licenciado mais novo ou, no Pro, um build fixado com CC_VERSION.
serve() e uma CLI
Não usa Docker? O serve() em Python, Node ou .NET, ou o clearcote serve num shell, faz o mesmo launch direto e te entrega uma URL CDP.
Qualquer cliente CDP
O connectOverCDP do Playwright, puppeteer.connect, browser-use, Crawl4AI, Stagehand ou o DevTools Protocol puro na porta.
Um Dockerfile auditável
O Dockerfile e o entrypoint ficam no repositório público, então você pode ler exatamente o que a imagem instala e executa, e gerar a imagem você mesmo. Isso vale para a imagem e para o build aberto que ela embute; com uma chave de licença, o container baixa o motor licenciado ao iniciar.
Como o container é montado
O container inicia o Clearcote diretamente, e não por um driver de testes, e expõe o Chrome DevTools Protocol na porta 9222. O launch direto é justamente a ideia: frameworks de automação adicionam switches de inicialização que denunciam a sua presença, e um endpoint permanente iniciado pela imagem nunca passa esses switches.
A persona padrão é uma identidade Linux nativa e coerente, e esse padrão é proposital. Parte do que uma página consegue ler vem do sistema operacional por baixo do navegador: num container Linux, o shaping do texto fica a cargo do FreeType e as fontes vêm do fontconfig, diga o user agent o que disser. Medido nesta imagem com uma persona Windows, um incremento de 0,01 px no tamanho da fonte mudou a largura do texto em 66% dos passos, contra 99% no Chrome real no Windows. Para uma identidade Windows, rode o build Windows ou use navegadores hospedados, que rodam em máquinas Windows.
Um container licenciado baixa o motor na primeira inicialização e obtém um lease de concorrência, então precisa de acesso de saída à API de licenças. Monte o volume de cache para que o motor seja baixado uma vez só, e não por cada container novo.
O que se conecta via CDP
| Cliente | Como |
|---|---|
| Playwright | chromium.connect_over_cdp(url) / connectOverCDP(url) |
| Puppeteer | puppeteer.connect({ browserURL: url, defaultViewport: null }) |
| browser-use · Crawl4AI · Stagehand | Aponte a configuração de endpoint CDP deles para a URL |
| Qualquer outra coisa que fale CDP | O DevTools Protocol puro na porta publicada |
Para que as pessoas usam
Scrapers no Compose ou no Kubernetes
Um serviço de navegador ao lado dos seus workers, configurado inteiramente por variáveis de ambiente.
Frameworks de agentes
Passe ao browser-use, Crawl4AI ou Stagehand uma URL CDP em vez de um Chrome local.
CI reproduzível
Uma tag de imagem fixada dá a cada execução do pipeline o mesmo build aberto; com uma chave de licença, só o CC_VERSION do Pro fixa o build licenciado.
Qualquer linguagem
Qualquer coisa com um cliente CDP, de Python e Node a Go ou Rust, pode controlar o endpoint.
O Clearcote foi feito para privacidade, testes, pesquisa e automação lícita. Você é responsável pela forma como o usa e por seguir os termos dos sites que visita.
Qual plano inclui
A imagem Docker, o serve() e o endpoint CDP estão em todos os planos. Por padrão, a imagem roda o build aberto; passe uma chave de licença (grátis com GitHub para um navegador por vez) para rodar o build mais recente. O limite de um navegador de uma chave grátis vale para todos os seus containers somados.
Perguntas frequentes
Qual é a imagem Docker?
teamflatearth/clearcote no Docker Hub, gerada a partir do Dockerfile do repositório público clearcote-browser. Rode docker pull teamflatearth/clearcote para atualizar uma cópia antiga.
É seguro publicar a porta 9222?
Só numa rede em que você confia. Um endpoint CDP dá controle total do navegador. Publique a porta apenas no host local com -p 127.0.0.1:9222:9222, ou mantenha-a numa rede privada, e nunca a exponha numa interface pública.
O container pode apresentar uma identidade Windows?
Você pode definir CC_PLATFORM=windows, mas as métricas de fonte e as fontes do sistema num container Linux continuam vindo do Linux, e um teste de fingerprint percebe. A persona Linux padrão é coerente. Para uma identidade Windows, rode o build Windows no Windows ou use navegadores hospedados.
Como rodo o build licenciado no Docker?
Defina CLEARCOTE_LICENSE_KEY e monte um volume em /opt/xdg-cache para que o motor seja baixado uma vez só. É preciso uma imagem gerada com o SDK 0.26.1 ou mais recente, e 0.30.0 ou mais recente para uma chave grátis via GitHub. O log de inicialização mostra qual motor você recebeu e se o lease da licença foi obtido.
Por que o navigator.webdriver continua false?
O motor não o define mais a partir do --enable-automation, o switch que a automação padrão usa, e de qualquer forma a imagem inicia o navegador sem esse switch. Conectar um cliente via CDP depois não muda isso.
Vá mais fundo na documentação
Recursos relacionados
Inicie um navegador Clearcote na nuvem com uma chamada de API e conecte o Playwright ou o Puppeteer via CDP. IP residencial incluído, cobrança por GB de tráfego.
Dê ao browser-use, Stagehand, Crawl4AI ou ao seu próprio agente um Chromium com identidade no nível do motor, ou rode o agente opcional embutido no Clearcote com o seu próprio modelo.
Dê ao Claude Desktop, ao Cursor ou ao Cline um navegador Clearcote pelo Model Context Protocol: vinte ferramentas e, por baixo, uma única identidade coerente.
Um Chromium drop-in para Playwright e Puppeteer: basta trocar um import em Python, Node ou .NET, e o navegador é baixado e verificado por SHA-256 para você.
Leituras relacionadas
Experimente o Clearcote
Plug-and-play no Playwright e no Puppeteer, coerente até o handshake TLS, com um build de código aberto para começar.
Grátis para um navegador com GitHub. Sem cartão.