Perguntas frequentes

O Clearcote é uma ferramenta de privacidade e automação destinada a fins lícitos — proteger a sua própria privacidade, testes web/QA, pesquisa, acessibilidade e automação que você tem autorização para executar. Você é responsável pela forma como o usa; respeite os termos de serviço dos sites e as leis aplicáveis.

O Clearcote controla os sinais de fingerprint do navegador para que uma sessão apresente uma única identidade coerente e plausível. Ele não é comercializado como solução contra nenhum produto de detecção específico, nem é voltado a nenhum deles, e não é garantia de escapar de nenhum sistema. Trate-o como uma ferramenta de privacidade e de consistência de identidade, e valide o comportamento por conta própria.

Esses plugins sobrescrevem propriedades de navigator em tempo de execução com JavaScript injetado, o que é frágil e acaba se denunciando. O Clearcote altera o motor em C++, então os valores vêm dos próprios caminhos de código do Chromium — não existe camada injetada para detectar. Veja Arquitetura.

Nenhuma ferramenta é. Controles coerentes no nível do motor eliminam muitos indícios comuns, mas a detecção é uma área em constante evolução. Sempre valide a sua configuração com ferramentas como CreepJS, BrowserScan e Pixelscan para o seu caso de uso.

O navegador em si não “liga para casa” nem se atualiza sozinho; ele é baseado no ungoogled-chromium, com os serviços do Google, a telemetria e os beacons de atualização removidos. O SDK baixa o navegador verificado no primeiro uso — o build aberto do GitHub Releases, o build licenciado do clearcotelabs.com — e o auto_update / autoUpdate é opt-in. Sem chave, o SDK só entra em contato conosco se você pedir uma version específica (ele lê o catálogo público de versões). Com uma chave de licença (Grátis com GitHub ou Pro), cada inicialização pergunta qual build é o atual e reserva um slot de navegador — enviando a chave, um ID de máquina aleatório, o seu sistema operacional e as versões do SDK e do navegador —, mantém o slot ativo enquanto o navegador roda e o devolve quando ele é fechado. O licenseThroughProxy envia a reserva do slot, os heartbeats e a devolução pelo seu proxy; a consulta do build e o download continuam se conectando diretamente. Os recursos opt-in geoip e widevine acessam as suas próprias fontes de dados.

Sim, para um navegador por vez. Entre com uma conta do GitHub que tenha pelo menos 30 dias, abra Licenses no seu painel e clique em Connect GitHub and get it free. Você recebe o mesmo build licenciado do Pro — o Chromium mais recente, movimentos humanos gravados, os patches de stealth privados e a biblioteca de perfis. A chave vale por 30 dias, e você a renova de graça na mesma página. O plano gratuito exige o SDK 0.30.0 ou mais recente e sempre roda o build mais recente. Veja como os navegadores licenciados são contados; o Pro adiciona mais navegadores simultâneos, fixação de versão e suporte por e-mail.

Windows x64 e Linux x64, por enquanto — o SDK baixa automaticamente o binário certo para o seu sistema operacional. O macOS está no roadmap; até lá, quem usa macOS pode rodar a imagem Docker (linux/amd64).

Sim. Troque o launch do Playwright pelo do Clearcote (from clearcote import launch / import { launch } from "clearcote") — ele retorna um navegador Playwright normal. O Puppeteer e outros clientes CDP se conectam ao serve() / clearcote serve. Você também pode apontar o executablePath diretamente para o build aberto; o build licenciado só inicia pelo SDK. Veja Playwright & Puppeteer.

Use uma seed de fingerprint diferente para cada identidade (por exemplo, derivada de um ID de tenant/conta) e um diretório de dados de usuário separado para cada perfil, para cookies/storage. Para servir várias ao mesmo tempo a partir de um único endpoint, o clearcote serve inicia um navegador por identidade, e cada conexão escolhe a sua seed, proxy, fuso horário e idioma — veja Deploy. No Grátis com GitHub, só um navegador roda por vez; o Pro e o build aberto não têm esse limite.

O build aberto é — BSD-3-Clause, todos os patches legíveis por humanos, reproduzível a partir do código-fonte. Não confie em nós: verifique. O build licenciado (Grátis com GitHub e Pro) adiciona patches que não são publicados, então não pode ser recompilado a partir do código-fonte público; o build aberto recebe cada nova major do Chromium mais tarde.