Pular para o conteúdo

Planos e limites

O que uma licença pode baixar e buscar por dia, o que acontece acima de um limite e como ficar abaixo dele. Os preços e o que cada plano inclui estão em Preços.

Em resumo

  • Downloads da versão licenciada: 20 por minuto e 30 a cada 24 horas da mesma versão. Inícios que encontram a versão no cache nunca contam.
  • Personas diferentes por dia: 750 no plano gratuito, 1,000,000 nos planos pagos. Reiniciar uma seed que você já usou hoje não custa nada.
  • Acima de um limite, você recebe HTTP 429. Mantenha o cache do navegador em um volume e reutilize um conjunto fixo de seeds.

Limites de download

Os downloads da versão licenciada têm limite por licença, para que uma configuração que baixa o arquivo completo a cada início não saia do controle. Um início que encontra a versão no cache não baixa nada e nunca conta: só downloads reais contam.

LimiteVale paraO que conta
20 downloads por minuto e 30 a cada 24 horasToda licença, por versão (número da versão + sistema operacional)Downloads do arquivo da mesma versão. Uma nova versão começa com uma cota nova.
10 versões diferentes a cada 24 horasLicenças gratuitasVersões diferentes baixadas. Uma versão que você já baixou hoje não conta de novo.
60 verificações por minutoPor endereço IPA verificação de versão que todo início faz em /api/v1/download/pro, com cache ou sem.

Acima de um limite, o SDK recebe HTTP 429 com um corpo JSON (code é DOWNLOAD_RATE_LIMITED (cota por versão) ou DOWNLOAD_LIMIT_EXCEEDED (plano gratuito)) e um cabeçalho Retry-After: os segundos até o limite ser reiniciado. Inícios cuja versão já está no cache continuam funcionando. A partir do SDK 0.62.0, um início que não consegue baixar uma versão nova abre, em vez de falhar, a versão mais recente da mesma versão do Chromium que já está no cache, e espera o Retry-After antes de tentar esse download de novo. Um início fixado em uma revisão exata (r50) continua recebendo essa versão ou um erro.

Você atinge esses limites quando muitas máquinas ou contêineres novos sobem ao mesmo tempo, cada um com o cache vazio. Baixe cada versão uma vez por máquina em vez de uma vez por início: os inícios também ficam mais rápidos, sem um download de cerca de 460 MB:

  • Mantenha o cache em um volume. Aponte CLEARCOTE_CACHE para um diretório que sobreviva a reinícios. Inícios que o compartilham esperam o primeiro download e o reaproveitam.
  • Coloque o navegador na sua imagem. Rode clearcote install no build, para que todo contêiner já comece com a versão no lugar. Refaça a imagem quando atualizar.
bash
# 1. a shared, persistent cache
docker run -v clearcote-cache:/clearcote-cache -e CLEARCOTE_CACHE=/clearcote-cache …

# 2. or in your Dockerfile: download once while the image is built (the key stays out of the layers)
ENV CLEARCOTE_CACHE=/opt/clearcote-cache
RUN --mount=type=secret,id=clearcote_key \
    CLEARCOTE_LICENSE_KEY="$(cat /run/secrets/clearcote_key)" clearcote install

Need a higher limit? Tell us how you run Clearcote and we'll raise it for your licence.

Chat with us

Limites de personas

Cada inicialização busca a sua persona (o fingerprint que a seed e as opções descrevem) no serviço de personas. Cada licença pode buscar um número fixo de personas diferentes por dia. Buscar uma persona que você já usou hoje não custa nada, então um conjunto fixo de perfis pode ser reiniciado quantas vezes você quiser.

PlanoPersonas diferentes por dia
Grátis750
Pro e outros planos pagos1,000,000

Uma persona é uma seed com um conjunto de opções de fingerprint (marca, plataforma etc.), então a mesma seed como Chrome e como Edge conta duas vezes. A contagem é reiniciada às 00:00 UTC. Acima do limite, a inicialização falha com HTTP 429 do serviço de personas (daily persona quota reached) até a reinicialização.

Isso acontece quando cada inicialização usa uma seed aleatória nova. Em vez disso, reutilize um conjunto fixo de seeds, por exemplo uma lista de algumas centenas de nomes que você vai alternando: cada um mantém o mesmo fingerprint toda vez que inicia, e reiniciá-lo nunca conta de novo.

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

Esta página foi útil?