Lancia il tuo SaaS sulle directory con un agente browser

Di cosa ha bisogno un agente browser

Accesso ai file del repository

L’agente deve leggere il playbook di una piattaforma, product.json e identity.json. Un agente di coding con uno strumento browser li legge direttamente; a un agente browser puramente in cloud devi passare tu, piattaforma per piattaforma, il playbook e i dati del prodotto.

Un browser in cui hai fatto l’accesso

Gli invii avvengono con i tuoi account. Un agente browser che gira in un suo browser remoto non ha fatto l’accesso come te e non può leggere la tua casella di posta per i codici di verifica; la guida del repository presuppone un Chrome che puoi vedere.

Un modo per registrare gli esiti

record.py e la dashboard locale sono script Python sul tuo computer. Se l’agente browser non può eseguirli, registri tu ogni esito nella dashboard dopo l’esecuzione.

Le condizioni di stop del runbook

Prima la ricerca dei duplicati, controllo dell’identità per ogni piattaforma, nessun acquisto, stop in caso di CAPTCHA o ambiguità. Sono istruzioni che l’agente deve seguire davvero, non funzioni che ha di serie.

Collegare un agente browser al tuo Chrome

BROWSER-SETUP.md è scritto per agenti che si collegano a un Chrome sotto la tua supervisione. Se il tuo agente browser è un agente di coding con uno strumento browser, la guida vale così com’è: Chrome DevTools MCP con auto-connect sul tuo Chrome di tutti i giorni (144 o successivo), oppure un profilo Chrome dedicato con una porta di debug locale, una sola connessione duratura per gruppo.

Un agente che offre solo un proprio browser remoto non soddisfa il requisito di connessione supportato. Configura Chrome DevTools MCP con il Chrome locale ed esegui il controllo visibile prima di iniziare.

Chiudi le schede sensibili non pertinenti, usa solo i siti consentiti per il prodotto, non esportare mai cookie o un profilo del browser, e considera una chiamata a uno strumento completata solo per quello che è: rileggi la pagina per vedere se il salvataggio è andato a buon fine.

Se il tuo agente browser è un agente di coding con uno strumento browser, questa è la definizione generica del server tratta da BROWSER-SETUP.md. Il tuo agente può tenerla in un altro file o formato; è la sua schermata di configurazione a decidere dove va:

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

Formato come documentato da github.com, controllato il 30 settembre 2026. ↗

Un agente che non può caricare un server come questo non è sul percorso supportato. Può comunque compilare un singolo modulo partendo da un playbook che incolli tu, e il risultato lo registri tu nella dashboard.

Collega il tuo coding agent al tuo Chrome →

Il prompt di avvio

Il prompt di avvio pubblico di START.md, senza modifiche. Presuppone un agente che possa eseguire Python nella cartella clonata, in genere un agente di coding con uno strumento browser. Con un agente browser puramente in cloud, esegui invece nel tuo terminale i comandi “doing it yourself” di START.md e usa la dashboard per copiare all’agente i prompt di ogni piattaforma.

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.

Playbook e istruzioni sono Markdown in inglese, il formato che gli agenti di coding gestiscono meglio. I testi del tuo prodotto possono essere in qualsiasi lingua accettata da una directory; l’agente ti risponde nella tua lingua.

In entrambi i casi workspace, product.json, authorizations.json e submissions.json finiscono come file sul tuo computer, e la dashboard mostra cosa è live, in attesa, programmato o fermo in attesa di te.

Avvia LaunchRepo in tre passaggi →

Com’è un’esecuzione

L’illustrazione qui sotto è quella della home page: un gruppo, con ogni piattaforma che termina nello stato effettivamente osservato. Con un agente browser gli stati possono essere inseriti da te dopo l’esecuzione; in ogni caso vengono dal tracker, non da questa pagina.

Quando un agente browser si blocca

Gli agenti browser falliscono in modo diverso dagli agenti di coding. Queste sono le tre situazioni da riconoscere presto, prima che un gruppo vada storto:

Non ha fatto l’accesso da nessuna parte

L’agente lavora in un suo browser remoto o gestito. I tuoi account sulle directory e la tua casella di posta sono nel tuo Chrome, quindi sposta lì l’esecuzione tramite Chrome DevTools MCP, oppure considera il lavoro dell’agente una bozza da completare tu.

Un sito lo rifiuta

Alcuni siti limitano gli agenti automatizzati nei browser in cloud anche se nel tuo funzionano senza problemi. Segna che la piattaforma ha bisogno di te e inviala a mano con il suo playbook aperto.

Ha dimenticato cosa ha fatto l’ultima volta

Gli agenti browser tengono raramente un registro tra una sessione e l’altra. Inserisci ogni esito nella dashboard subito dopo l’esecuzione; il gruppo successivo parte così dal tracker invece che dalla memoria.

Se gli strumenti del browser vanno in timeout con --autoConnect, controlla quattro cose: Chrome 144 o successivo è già aperto, il debug remoto è attivo su chrome://inspect/#remote-debugging, hai accettato la richiesta di connessione di Chrome e nessun altro strumento sta usando lo stesso browser. Chrome DevTools MCP carica ogni scheda aperta, quindi chiudi quelle che non ti servono.

Dove servi ancora tu

LaunchRepo di proposito non è un servizio in background. Questi momenti fermano l’esecuzione e vengono registrati come passaggi a una persona; l’agente non li aggira mai:

CAPTCHA e controlli anti-bot

Qualunque sia l’agente, la verifica la risolvi tu nella finestra prevista. Il tracker registra prepared_needs_human; in nessun playbook ci sono passaggi per mimetizzarsi o aggirare i controlli.

2FA e codici di verifica

La maggior parte delle directory conferma via email. Se l’agente browser non può leggere la tua casella di posta, il codice e il clic di conferma sono un passaggio a una persona, registrato come tale e mai come accesso automatizzato.

Upsell a pagamento

I percorsi solo a pagamento vengono registrati come deferred_paid. A un agente browser va detto di non comprare; i playbook lo ripetono per ogni piattaforma, e la decisione resta tua.

Registrare e confermare

Se l’agente non può eseguire record.py, inserisci tu l’esito nella dashboard locale. “Live” richiede sempre un URL pubblico e la tua conferma.

Nessun benchmark, nessuna classifica: consideriamo compatibili gli agenti browser che soddisfano i due requisiti qui sopra, non perché li abbiamo misurati rispetto ad altri agenti.

Domande