- Claude Code è lo strumento di programmazione agentico di Anthropic. Per la SEO lavora su file e dati collegati: audit, schema, correzioni on-page in blocco, fogli di parole chiave e preparazione dei report.
- Parti da una cartella per cliente, git, un breve CLAUDE.md e dati di sola lettura dal connettore MCP di ZeusSEO.
- Aggiungi gli agenti in parallelo più avanti, con una sessione guida che pianifica il lavoro e filtra ciò che arriva a te.
Claude Code per la SEO significa usare un agente AI che legge i file del tuo sito, li modifica, esegue comandi e, tramite un connettore MCP, legge i tuoi dati di Search Console, Analytics e Google Business Profile. Parti in piccolo: una cartella sotto git, la regola di leggere ogni diff e un accesso ai dati di sola lettura. Quando quel ciclo è affidabile, aggiungi agenti in parallelo e poi più sessioni con una guida.
C'è chi lo chiama "vibe coding SEO" o "vibe SEO": descrivi il risultato con parole semplici e lasci che sia l'AI a scrivere il codice. È un'etichetta informale, non un termine di Anthropic né di Google, ed è sicura solo con i controlli qui sotto. Etichette affini sono "Claude SEO", "Claude Code SEO" e "MCP SEO". Per iniziare subito, collega il connettore ZeusSEO, incluso in ogni piano: la guida all'MCP di Google Business Profile ha la configurazione, e la sezione MCP qui sotto aggiunge i comandi di Claude Code. Se preferisci leggere di un esperto già pronto invece di costruire un flusso di lavoro, c'è anche Athena, l'esperto SEO AI di ZeusSEO (in accesso anticipato).
- Che cos'è Claude Code e cosa può fare per la SEO
- Strumenti consigliati e suggeriti
- Git e cartelle locali: il tuo pulsante di annullamento
- Cinque flussi di lavoro SEO da cui partire
- MCP: collega ZeusSEO a Claude Code
- Uso delle API: chiavi, costi e script
- Permessi e hook: imposta una volta i limiti
- Agenti AI per la SEO: subagenti in parallelo
- Un agente che fa da guida
- Avanzato: più sessioni, una guida, tu come ultimo controllo
- Pratica sicura e cosa dice Google sui contenuti AI
- Un ordine sensato per adottare tutto questo
Che cos'è Claude Code e cosa può fare per la SEO
Anthropic descrive Claude Code come uno strumento di programmazione agentico che legge il tuo codice, modifica i file, esegue comandi e si integra con i tuoi strumenti di sviluppo. Funziona in un terminale, in un IDE, in un'app desktop e in un browser, e la maggior parte delle superfici richiede un abbonamento Claude o un account Anthropic Console.
Per la SEO, "codice" significa qualsiasi cartella di testo: template, articoli in markdown, snippet di schema, robots.txt, mappe di redirect ed esportazioni CSV. "SEO con Claude" spesso vuol dire chattare in una finestra; Claude Code lavora dentro una cartella sul tuo computer, quindi può aprire file, modificarli ed eseguire controlli. Non ha alcuna visione di Google finché non gliene dai una, come esportazioni o tramite un connettore.
Strumenti consigliati e suggeriti
Installa dalla panoramica ufficiale, come strumento da terminale, estensione di VS Code o app desktop. Ogni superficie usa lo stesso motore, quindi i tuoi file CLAUDE.md, le impostazioni e i server MCP si trasferiscono.
| Strumento | A cosa serve | Nota |
|---|---|---|
| Claude Code | Leggere, modificare e controllare file | Terminale, VS Code, JetBrains, desktop o browser |
| git | Punti di ripristino, branch, diff | Claude Code può mettere in staging, fare commit e creare branch |
| Connettore MCP di ZeusSEO | Dati di Search Console, Analytics, Google Business Profile, scansione e posizionamenti | Riferimento completo degli strumenti |
| Argus e Kronos | Problemi di scansione e un audit on-page gratuito | Vedi Argus, letto tramite il connettore |
Esegui /init per preparare un CLAUDE.md, poi riducilo. La guida alla memoria dice di puntare a meno di 200 righe, quindi conserva solo le regole che Claude non può indovinare.
Un CLAUDE.md iniziale per la cartella di un cliente potrebbe dire:
- Quali cartelle contengono template, contenuti ed esportazioni.
- Non modificare mai robots.txt o la mappa dei redirect senza chiedere.
- Non inventare mai fatti, prezzi, recensioni o statistiche.
- Proponi le modifiche a Google Business Profile; non pubblicarle mai.
Git e cartelle locali: il tuo pulsante di annullamento
Ogni modifica dovrebbe essere un diff che puoi leggere e annullare. Lo fa git; i checkpoint di Claude Code non lo sostituiscono.
Dai a ogni cliente una cartella per i file del sito, le esportazioni e i report, e avvia Claude Code lì. In modalità Manual chiede prima di leggere o scrivere fuori dalla cartella in cui è partito, come spiega la pagina sulla sicurezza.
- Usa git, anche per le esportazioni. Nessun repository per un sito su CMS? Tieni bozze e CSV in una cartella ed esegui
git init. - Un branch per attività, e fai commit prima di ogni esecuzione.
- Leggi
git diffprima di accettare. Claude Code può fare il commit per te, ma la revisione spetta a te.
La documentazione sui checkpoint dice che /rewind ripristina le modifiche fatte tramite gli strumenti per file di Claude, non quelle fatte da comandi di shell, e che i checkpoint non sostituiscono il controllo di versione. Fai commit prima di qualsiasi esecuzione in blocco.
Cinque flussi di lavoro SEO da cui partire
Scegli lavori in cui il risultato è testo che puoi confrontare e il test di successo è un controllo che puoi eseguire.
Usa un unico flusso di lavoro AI SEO ripetibile per tutti e cinque i lavori SEO con Claude Code: definisci l'ambito, estrai i dati, pianifica, modifica i file su un branch, esegui un controllo, leggi il diff, fai il commit. Le buone pratiche di Anthropic consigliano di pianificare prima di scrivere codice e di dare a Claude un controllo eseguibile, così può iterare finché il controllo non passa.
1. Audit tecnico dei file di un sito
Chiedi a Claude di leggere template, robots.txt e configurazione della sitemap in modalità plan e di elencare i risultati per file e riga. Google dice che robots.txt non è un modo per tenere una pagina fuori da Google, quindi segnala ogni Disallow usato a questo scopo. La nostra guida all'audit SEO tecnico tratta il lato live.
2. Scrivere e controllare lo schema
L'introduzione ai dati strutturati di Google raccomanda JSON-LD nella maggior parte dei casi e dice che il markup deve descrivere contenuti che gli utenti possono vedere. Fallo preparare a Claude per template, poi convalidalo tu.
3. Correzioni on-page in blocco in un repository
Dai a Claude un CSV con URL e nuovo titolo e lascia che modifichi i file corrispondenti. Prova prima su una manciata, poi usa /batch, che divide una modifica tra 5 e 30 subagenti, ciascuno nel proprio worktree.
4. Fogli di cluster di parole chiave
Esporta le query in un CSV e chiedi a Claude di scrivere ed eseguire uno script che le raggruppi per argomento e proponga una pagina per ogni gruppo.
5. Preparazione dei report
Estrai i numeri tramite il connettore e chiedi un breve commento per ogni cliente. Consulta la nostra guida al report sul posizionamento SEO per cosa deve contenere un report per il cliente.
| Flusso di lavoro | Controllo prima di accettare |
|---|---|
| Audit tecnico | Ogni risultato indica un file e una riga |
| Schema | Il Rich Results Test non mostra errori |
| On-page in blocco | Prima il diff di 5 file; nessuna modifica estranea |
| Cluster di parole chiave | 10 cluster controllati a mano a campione |
| Preparazione dei report | Ogni numero ricondotto a una fonte |
MCP: collega ZeusSEO a Claude Code
Un solo URL del connettore dà a Claude Code i tuoi dati di Search Console, Analytics, Google Business Profile, scansione e posizionamenti. Parti dagli strumenti di lettura.
MCP, il Model Context Protocol, è uno standard aperto per collegare gli strumenti AI a fonti di dati esterne, e Claude Code supporta i server MCP remoti via HTTP. L'MCP per la SEO significa che il tuo agente legge dati live del cliente invece di un'esportazione incollata. Il connettore ZeusSEO ha un solo URL e più di 100 strumenti.
- Aggiungi il server in un terminale, non dentro una sessione:
- Verificalo.
claude mcp listmostra "Needs authentication" finché non accedi, come descrive la guida rapida MCP. - Accedi. Avvia
claude, digita/mcp, sceglizeuseoe seleziona Authenticate. Il browser si apre sul passaggio di accesso descritto nella guida all'MCP di Google Business Profile.
Aggiungi --scope user per usarlo in ogni progetto. Se hai aggiunto il connettore in Claude e usi lo stesso account per Claude Code, la documentazione MCP dice che i connettori di Claude si caricano automaticamente, a meno che il tuo accesso non sia una chiave API. Il nostro accesso è un flusso OAuth standard con PKCE che accetta l'indirizzo di callback locale di Claude Code.
| Lavoro SEO | Strumenti del connettore | Modalità |
|---|---|---|
| Query e indicizzazione | gsc_top_queries (filtri di posizione), gsc_underperforming_pages, gsc_inspect_url, gsc_sitemap_diff | Sola lettura; non richiede mai l'indicizzazione |
| Scansione e audit | argus_crawl_status, seo_list_page_issues, kronos_run_audit | Legge la scansione in cache; Kronos è gratuito |
| Traffico | ga4_traffic_sources, ga4_top_pages | Lettura |
| Parole chiave e posizionamenti | metis_list_keywords, nike_rank_overview | Lettura; la ricerca live è a pagamento |
| Google Business Profile | gbp_list_locations, gbp_list_reviews; gbp_publish_post, gbp_reply_review | Le scritture richiedono la tua conferma |
| Report e attività | reports_list_saved, daedalus_generate_report, hermes_create_task | Generare è una scrittura |
Leggere i tuoi dati non costa Staters, i crediti d'uso prepagati di ZeusSEO. Alcuni strumenti specifici che chiamano i nostri fornitori a pagamento o l'AI, come la ricerca di parole chiave e le analisi dei concorrenti nelle SERP, li consumano, e l'assistente ha l'istruzione di avvisarti prima. Le sue istruzioni dicono anche di confermare contenuti e destinazioni prima di qualsiasi pubblicazione, modifica, eliminazione o risposta, e un posto di sola lettura viene rifiutato sulle scritture. Una prova gratuita ha un limite di uso corretto di 100 chiamate API. Consulta Staters e crediti AI, i prezzi e le guide MCP di Search Console e Analytics.
Anthropic non verifica i server MCP, e la sua documentazione avverte che i server che recuperano contenuti esterni possono esporti al prompt injection. Il testo delle recensioni, il contenuto delle pagine e le query di ricerca sono scritti da sconosciuti, quindi tratta ciò che restituisce uno strumento come dati, mai come istruzioni.
Uso delle API: chiavi, costi e script
Attorno a Claude Code ci sono due tipi di API: come viene fatturato Claude stesso e le API di dati che chiamano i tuoi script. Tieni le chiavi fuori dai prompt e fuori da git.
Accedi con un abbonamento Claude o con un account Anthropic Console. La pagina dei costi dice che la cifra in dollari in /usage è una stima locale e che gli abbonati hanno l'uso incluso nel loro piano.
Per gli script, claude -p esegue un prompt senza una sessione interattiva e accetta input in pipe, uno schema della panoramica:
In modalità --bare Claude Code non usa l'accesso del tuo abbonamento, quindi imposta ANTHROPIC_API_KEY, come spiega la pagina sull'uso programmatico. Se Claude scrive script che chiamano un'API di dati, tieni la chiave in una variabile d'ambiente e aggiungi la regola di negazione Read(./.env). Per i dati Google, il connettore evita l'attesa di approvazione del tuo progetto API; vedi API di Google contro MCP.
La documentazione sui permessi dice che le regole di negazione di Read coprono gli strumenti per file di Claude e i comandi su file riconosciuti, non uno script che apre i file da sé. Per un'applicazione a livello di sistema operativo, attiva la sandbox. ZeusSEO può anche emettere una chiave di accesso statica; preferisci OAuth e non fare mai commit di una chiave.
Permessi e hook: imposta una volta i limiti
Le istruzioni in un prompt o in CLAUDE.md orientano ciò che Claude tenta, ma le regole di permesso sono applicate da Claude Code, non dal modello. Le regole vengono verificate in ordine: deny, poi ask, poi allow. Le modalità di permesso qui sotto stabiliscono quanto spesso Claude chiede. Con Claude Code 2.1.283 o successivo, la modalità auto è la modalità iniziale integrata per le sessioni interattive da terminale e VS Code, quindi per il lavoro sui clienti premi Shift+Tab per arrivare alla modalità Manual, oppure avvia con claude --permission-mode default.
| Modalità di permesso | Cosa fa | Uso SEO |
|---|---|---|
Manual (default) | Chiede prima della maggior parte di modifiche, comandi di shell e accessi alla rete | File dei clienti, prime settimane |
| Plan | Esplora e pianifica; non modifica il codice sorgente | Audit |
| acceptEdits | Approva automaticamente le modifiche ai file | Correzioni in blocco, su un branch |
| auto | Un modello classificatore rivede le azioni al posto tuo | Lavoro di routine, ben controllato; non file dei clienti |
| dontAsk | Nega tutto ciò che richiederebbe una conferma | Esecuzioni non presidiate |
| bypassPermissions | Esegue tutto | Solo contenitori isolati |
- Consenti gli strumenti di lettura:
mcp__zeuseo__gsc_*,mcp__zeuseo__ga4_*emcp__zeuseo__argus_*. Il prefissozeuseoè il nome del server che hai scelto quando l'hai aggiunto. - Tieni gli strumenti di scrittura fuori dalle regole allow, così la modalità Manual chiede ogni volta. In modalità auto una chiamata viene rivista da un classificatore, quindi aggiungi una regola ask in
/permissionsse vuoi comunque una conferma. - Nega i segreti:
Read(./.env). - Blocchi rigidi: un hook PreToolUse che esce con codice 2 ferma le modifiche ai file protetti. La guida agli hook dice che gli hook sono deterministici, a differenza di CLAUDE.md.
Quando incolli due volte la stessa checklist, trasformala in una skill: una cartella in .claude/skills/ con un SKILL.md, eseguita con /skill-name. La documentazione sulle skill dice che il suo corpo si carica solo quando viene usata.
Agenti AI per la SEO: subagenti in parallelo
Gli agenti in parallelo aiutano quando i lavori sono indipendenti. Moltiplicano i token, quindi meritali.
Un subagente funziona nella propria finestra di contesto con un prompt personalizzato, strumenti specifici e permessi indipendenti, poi restituisce un riepilogo. Definiscine uno come file markdown in .claude/agents/, per esempio un revisore dello schema limitato a Read, Grep e Glob così non può modificare. Anthropic elenca diversi modi per eseguire agenti in parallelo, tra cui:
| Approccio | Chi coordina | Nota |
|---|---|---|
| Subagenti | Claude, dentro una sessione | Riferiscono alla sessione che li ha avviati |
Agent view (claude agents) | Assegni tu le sessioni | Anteprima di ricerca |
| Agent teams | Una sessione guida | Sperimentale, disattivato per impostazione predefinita |
| Workflow dinamici | Uno script | Da decine a centinaia di agenti per esecuzione |
"Più agenti finiscono sempre prima." Anthropic dice che gli agent teams aggiungono sovraccarico di coordinamento e usano molti più token, e che il lavoro sequenziale o sullo stesso file si adatta meglio a una sola sessione o a subagenti. Parti con 3-5, non con 30.
Un agente che fa da guida
La panoramica descrive un agente guida che coordina il lavoro, assegna i sottocompiti e unisce i risultati. I subagenti riferiscono solo alla conversazione che li ha generati, quindi quella conversazione è il tuo unico punto di contatto.
- Istruisci la guida: "Usa subagenti di sola lettura per fare l'audit di /product, /locations e /blog in parallelo. Riferisci per file e riga."
- Unisci e modifica: la guida elimina i duplicati, ordina per gravità ed è l'unica che modifica, così i lavoratori non possono entrare in collisione.
- Revisione: esegui un nuovo revisore, come la skill integrata
/code-review, sul diff.
Avanzato: più sessioni, una guida, tu come ultimo controllo
Quando una sessione non basta, eseguine più d'una, ma tieni una guida come unica sessione che parla con te.
È uno schema di lavoro costruito con funzioni documentate, non una modalità integrata. La documentazione descrive una guida integrata solo per gli agent teams, che sono sperimentali e disattivati per impostazione predefinita; lì le richieste di permesso dei colleghi compaiono nella sessione guida, con un costo in token più alto.
- Stessa logica: i file CLAUDE.md del progetto e le impostazioni dei permessi possono essere condivisi tramite il controllo di versione.
- File separati:
claude --worktree schema-fixesavvia una sessione sul proprio branch sotto.claude/worktrees/; la documentazione sui worktree suggerisce di aggiungere quella cartella a.gitignore. - Messaggi: la messaggistica tra sessioni permette a Claude di elencare le tue altre sessioni e di inviare loro testo semplice. Richiede Claude Code 2.1.224 o successivo (2.1.234 su Windows nativo).
| Ruolo | Come parte | Può fare | Restituisce |
|---|---|---|---|
| Guida | L'unica sessione con cui parli, --name lead | Pianificare, inviare messaggi ai lavoratori, rivedere i diff | Un breve elenco di decisioni |
| Lavoratore | Proprio worktree e branch | Modificare solo i propri file; strumenti di lettura | Un commit e un riepilogo |
| Tu | La finestra della guida | Approvare, rifiutare, unire | Nient'altro |
- Fai commit delle regole e dividi per file: ogni sessione parte allo stesso modo e due sessioni non condividono mai un file.
- Dai un nome alle sessioni con
--nameo/rename; controllale con/list-agents, oppure menzionane una con@name. - La guida assegna tramite messaggio; i lavoratori fanno commit e rimandano un riepilogo.
- La guida rivede ogni diff, esegue i controlli e rifiuta le modifiche fuori ambito. Tu rivedi il suo breve elenco.
Un messaggio da un'altra sessione non può mai approvare una richiesta di permesso al posto tuo né cambiare la configurazione. Le richieste di permesso di un lavoratore compaiono comunque nella sua finestra, quindi pre-approva i suoi strumenti di lettura e tieni la pubblicazione nella finestra della guida.
Pratica sicura e cosa dice Google sui contenuti AI
Rivedi i diff, fai commit spesso, limita i permessi, non incollare mai segreti e pubblica solo ciò che aiuta le persone.
- Leggi ogni diff. La pagina sulla sicurezza di Anthropic dice che sei responsabile di rivedere il codice e i comandi proposti.
- Privilegio minimo, nessun segreto: consenti le letture, chiedi per le scritture e non mettere mai chiavi o password in prompt, CLAUDE.md o configurazioni di cui fai commit.
"Google penalizza tutto ciò che è scritto dall'AI." La guida di Google ai contenuti di AI generativa non lo vieta. Dice che usare l'AI per generare molte pagine senza aggiungere valore può violare la policy sull'abuso di contenuti su larga scala, e chiede di verificare i fatti dei contenuti e di rivedere titoli, descrizioni, dati strutturati e testo alternativo.
Le policy antispam di Google trattano l'abuso di contenuti su larga scala come molte pagine create principalmente per manipolare i posizionamenti, comunque vengano realizzate. Migliaia di pagine quasi duplicate sono il rischio della vibe SEO su larga scala. Per contenuti che rispondono bene alle domande, vedi l'answer engine optimization.
Un ordine sensato per adottare tutto questo
- Installa Claude Code, apri la cartella di un cliente ed esegui
git initse serve. - Scrivi un breve CLAUDE.md, nega
Read(./.env)e passa alla modalità Manual per i file dei clienti. - Esegui un audit di sola lettura in modalità plan.
- Collega ZeusSEO e consenti solo gli strumenti di lettura.
- Fai una modifica in blocco su un branch, con un controllo.
- Aggiungi un subagente revisore di sola lettura, poi una seconda sessione nel proprio worktree, poi una guida con un nome.
Gestisci molte sedi? Lo stesso approccio si adatta alle nostre guide su più sedi, ottimizzazione del profilo e risposte alle recensioni. Il tuo prossimo passo è la guida all'MCP di Google Business Profile, che collega il connettore ZeusSEO. Se preferisci leggere di un esperto già pronto invece di costruire il tuo, c'è anche Athena (in accesso anticipato).
- Claude Code lavora su file e dati, quindi dagli una cartella, git e una fonte di dati.
- Parti in sola lettura; rendi ogni scrittura un diff rivisto o un'azione confermata.
- Usa i subagenti per lavori indipendenti e una guida per il coordinamento.
- Più sessioni sono uno schema che costruisci; gli agent teams sono la soluzione integrata sperimentale.
I fatti su Claude Code provengono dalla documentazione ufficiale di Anthropic e quelli su Google dalla documentazione di Google, tutti collegati nel testo e verificati il 2026-10-20. I dettagli sul prodotto ZeusSEO sono stati verificati sul prodotto stesso. La guida è stata preparata con l'aiuto dell'AI e rivista dal team di ZeusSEO; consulta i nostri standard editoriali.