Lança o teu SaaS em diretórios com um agente de browser

De que um agente de browser precisa

Acesso aos ficheiros do repositório

O agente tem de ler o playbook de uma plataforma, o product.json e o identity.json. Um agente de programação com uma ferramenta de browser lê-os diretamente; um agente de browser puramente alojado precisa que lhe entregues o playbook relevante e os factos do produto plataforma a plataforma.

Um browser onde tens sessão iniciada

As submissões acontecem com as tuas contas. Um agente de browser que corre no seu próprio browser remoto não tem sessão iniciada como tu e não consegue ler a tua caixa de correio para códigos de verificação; o guia do repositório assume um Chrome que consegues ver.

Uma forma de registar resultados

O record.py e o dashboard local são scripts Python na tua máquina. Se o agente de browser não os consegue correr, registas cada resultado tu próprio no dashboard depois da execução.

As condições de paragem do runbook

Procura de duplicados primeiro, verificação de identidade por plataforma, sem compras, parar perante CAPTCHA ou ambiguidade. São instruções que o agente tem realmente de seguir, não funcionalidades que traz de origem.

Ligar um agente de browser ao teu Chrome

O BROWSER-SETUP.md está escrito para agentes que se ligam a um Chrome que supervisionas. Se o teu agente de browser é um agente de programação com uma ferramenta de browser, o guia aplica-se tal como está: Chrome DevTools MCP com auto-connect no teu Chrome do dia a dia (144 ou mais recente), ou um perfil Chrome dedicado com uma porta de debugging local, uma ligação duradoura por lote.

Um agente que só oferece o seu próprio browser remoto não cumpre o requisito de ligação suportado. Configura o Chrome DevTools MCP com o teu Chrome local e faz o smoke check visível antes de começar.

Em qualquer dos casos: fecha separadores sensíveis não relacionados, usa apenas os sites permitidos do produto, nunca exportes cookies ou um perfil de browser, e trata uma chamada de ferramenta concluída como nada mais do que uma chamada de ferramenta — volta a ler a página para ver se gravou.

Se o teu agente de browser é um agente de programação com uma ferramenta de browser, esta é a definição genérica do servidor do BROWSER-SETUP.md. O teu agente pode guardá-la noutro ficheiro ou formato; é o seu próprio ecrã de configuração que decide onde fica:

{
  "mcpServers": {
    "chrome-devtools": {
      "command": "npx",
      "args": [
        "-y",
        "chrome-devtools-mcp@latest",
        "--autoConnect",
        "--no-usage-statistics",
        "--no-performance-crux"
      ]
    }
  }
}

Formato conforme documentado por github.com, verificado em 30 de setembro de 2026. ↗

Um agente que não consegue carregar um servidor assim não está na rota suportada. Mesmo assim, consegue preencher um formulário a partir de um playbook que colares, e registas tu o resultado no dashboard.

Liga o teu agente de código ao teu Chrome →

O prompt de arranque

O prompt de arranque público do START.md, sem alterações. Assume um agente que consegue correr Python na pasta clonada — tipicamente, um agente de programação com uma ferramenta de browser. Com um agente de browser puramente alojado, corre antes os comandos de “fazer tu próprio” do START.md no teu terminal e usa o dashboard para copiar prompts por plataforma para o agente.

Recommend Claude Code CLI or Codex CLI in a terminal instead of the desktop apps for best results. If session metadata confirms desktop hosting, explicitly advise me to switch to the CLI and resume this same private workspace. Do not infer the host from a CLI engine version alone.

Read AGENTS.md, then follow "Start the dashboard for the owner". Create my private
workspace if I do not have one yet, start the dashboard, and give me the link.
Then lead ONBOARDING.md one phase at a time. Reuse recorded permissions instead of
asking again unless their scope is missing or conflicting. Actually test my visible
existing Chrome profile and intended identity as BROWSER-SETUP.md requires; use the
OS fallback if needed. Use one platform/browser worker by default. Build the normal
run only from suitable free-ready routes, keep research separate, and preserve any
draft that needs one exact human CAPTCHA/2FA action. Never claim browser control
bypasses or reduces those challenges.

Os playbooks e as instruções são Markdown em inglês, o formato com que os agentes de programação lidam melhor. Os textos do teu produto podem estar em qualquer língua que um diretório aceite; o agente responde-te na tua língua.

De qualquer das formas, o workspace, o product.json, o authorizations.json e o submissions.json acabam como ficheiros na tua máquina, e o dashboard mostra o que está live, pendente, agendado ou à espera de ti.

Arrancar com o LaunchRepo em três passos →

Como é uma execução

A ilustração abaixo é a da página inicial: um lote, cada plataforma a terminar no estado que foi realmente observado. Com um agente de browser os estados podem ser introduzidos por ti depois da execução; de qualquer forma vêm do tracker, não desta página.

Quando um agente de browser encrava

Os agentes de browser falham de forma diferente dos agentes de programação. Estas são as três situações a reconhecer cedo, antes de um lote descarrilar:

Não tem sessão iniciada em lado nenhum

O agente está a trabalhar no seu próprio browser remoto ou gerido. As tuas contas nos diretórios e o teu correio estão no teu Chrome, por isso passa a execução para lá através do Chrome DevTools MCP, ou trata o trabalho do agente como um rascunho que terminas tu.

Um site recusa-o

Alguns sites restringem agentes automatizados em browsers alojados, mesmo funcionando bem no teu. Marca a plataforma como precisando de ti e submete-a à mão com o playbook aberto.

Esqueceu-se do que fez da última vez

Os agentes de browser raramente guardam um registo entre sessões. Introduz cada resultado no dashboard logo a seguir à execução; o lote seguinte parte então do tracker e não da memória.

Se as ferramentas de browser esgotarem o tempo com --autoConnect, verifica quatro coisas: o Chrome 144 ou mais recente já está aberto, o remote debugging está ativo em chrome://inspect/#remote-debugging, aceitaste o pedido de ligação do Chrome e nenhuma outra ferramenta está a usar o mesmo browser. O Chrome DevTools MCP carrega todos os separadores abertos, por isso fecha os de que não precisas.

O que continua a precisar de ti

O LaunchRepo não é, de propósito, um serviço em segundo plano. Estes momentos param a execução e são registados como passagens para humano; o agente nunca os contorna:

CAPTCHAs e verificações anti-bot

Seja qual for o agente, o desafio é teu para resolver na janela pretendida. O tracker regista prepared_needs_human; não há passos de stealth ou evasão em nenhum playbook.

2FA e códigos de verificação

A maioria dos diretórios confirma por email. Se o agente de browser não consegue ler a tua caixa de correio, o código e o clique de confirmação são uma passagem para humano — registada como tal, nunca como acesso automatizado.

Upsells pagos

As rotas só pagas são registadas como deferred_paid. A um agente de browser é preciso dizer-lhe para não comprar; os playbooks dizem-no em todas as plataformas, e a decisão continua a ser tua.

Registar e confirmar

Se o agente não consegue correr o record.py, introduzes o resultado no dashboard local. “Live” precisa sempre de um URL público e da tua declaração.

Sem benchmark, sem ranking: consideramos compatíveis os agentes de browser que cumprem os dois requisitos acima, não porque os tenhamos medido face a outros agentes.

Perguntas