Come aggiungo lo schema markup (JSON-LD) al mio sito con Claude Code o Codex?
Chiedi all'agente di generare il JSON-LD nei template delle pagine a partire dagli stessi dati che ogni pagina mostra, con solo tipi e valori che un lettore può vedere, reso sul server. Scrivi questa regola in CLAUDE.md o AGENTS.md così ogni nuova pagina la riceve. Poi testa l'URL pubblicato, non il codice, nel Rich Results Test di Google.
Dati
- Google raccomanda il JSON-LD tra i suoi 3 formati supportati per i dati strutturati, se la configurazione del tuo sito lo consente. (Google Search Central: introduzione al markup dei dati strutturati)
- Le linee guida di Google dicono di non marcare contenuti non visibili ai lettori, e gli elementi privi di proprietà obbligatorie non sono idonei ai risultati ricchi. (Google Search Central: linee guida generali sui dati strutturati)
- Google afferma che non serve alcun markup schema.org speciale per comparire nelle AI Overview o in AI Mode, e i dati strutturati devono corrispondere al testo visibile. (Google Search Central: AI features and your website)
- Il markup Organization va nella home page o in una pagina Chi siamo, non ha proprietà obbligatorie e il logo deve misurare almeno 112x112 pixel. (Google Search Central: dati strutturati Organization)
- Claude Code carica il CLAUDE.md del progetto in ogni sessione, insieme a una memoria automatica di fino a 200 righe o 25 KB. (Documentazione di Claude Code: come Claude ricorda il tuo progetto)
- Codex legge AGENTS.md prima di fare qualsiasi lavoro, e combina i file di istruzioni fino a 32 KiB per impostazione predefinita. (Documentazione di OpenAI Codex: istruzioni personalizzate con AGENTS.md)
Quali tipi di schema devo chiedere all'agente di aggiungere?
Chiedi il tipo che corrisponde a ciò che ogni pagina mostra, e nient'altro:
| Pagina | Tipo di schema | Proprietà principali |
|---|---|---|
| Home o pagina Chi siamo | Organization (o LocalBusiness) | name, url, logo, sameAs |
| Guida o articolo del blog | Article | headline, author, datePublished, dateModified, publisher |
| Pagina di prodotto | Product | name, offers con il prezzo che la pagina mostra |
| Pagina con domande e risposte visibili | FAQPage | Solo le domande stampate nella pagina |
Quale prompt devo dare a Claude Code o Codex?
Dagli un unico insieme di regole da applicare a ogni template, con il divieto di inventare valori:
Add JSON-LD structured data to this site. - Build it in the page templates from the same data the page renders. Never hardcode a value the page does not show. - Organization (name, url, logo, sameAs) on the home page only. - Article on guides and blog posts: headline, author, datePublished, dateModified (the real last change), publisher = the Organization. - Product, LocalBusiness or FAQPage only where that content is visible. - If a value is unknown, leave the property out. Do not invent it. - Render it on the server, in a <script type="application/ld+json">. - List every page you changed and the types each one now carries.
Dove metto la regola perché anche le nuove pagine abbiano lo schema?
Mettila nel file di istruzioni che l'agente carica da solo. Claude Code legge ./CLAUDE.md o ./.claude/CLAUDE.md all'inizio di ogni sessione, e /init crea una prima versione. Codex legge AGENTS.md dalla radice del progetto prima di fare qualsiasi lavoro. Una regola breve lì mantiene la prossima pagina scritta dall'agente coerente con la precedente.
Come verifico che l'agente non abbia inventato nulla?
Testa l'URL pubblicato nel Rich Results Test, poi confronta ogni valore con la pagina che vede il lettore. Un test sull'URL esegue il JavaScript della pagina, cosa che il codice incollato non fa. Poi usa lo Strumento Controllo URL in Search Console per confermare che Google abbia trovato il markup. Un test valido prova solo la sintassi; controllare i valori tocca a te.
Lo schema markup farà citare il mio sito da ChatGPT o dall'AI di Google?
Non da solo. Google dice che AI Overview e AI Mode non richiedono uno schema speciale, e non garantisce risultati ricchi per un markup valido. Un JSON-LD corretto aiuta i motori a capire chi sei e di cosa parla la pagina; la risposta sulla pagina è ancora ciò che viene citato.
Passo dopo passo
- Elenca i tipi di pagina. Home, chi siamo, guide, prodotti: un tipo di schema per ciascuno.
- Dai il prompt all'agente. Chiedigli di costruire il JSON-LD nei template a partire dai dati della pagina, senza valori inventati.
- Salva la regola. Aggiungila a CLAUDE.md o AGENTS.md perché le pagine future la seguano.
- Rivedi le modifiche e fai il deploy. Controlla che i valori vengano dai dati della pagina, non da testo scritto a mano.
- Testa l'URL pubblicato. Esegui il Rich Results Test sulla pagina pubblicata, poi lo Strumento Controllo URL in Search Console.
Errori comuni
- Lasciare che l'agente inserisca valutazioni, prezzi o autori che la pagina non mostra.
- Aggiungere markup FAQPage per domande che non sono stampate nella pagina.
- Testare il codice incollato invece dell'URL pubblicato, che non mostra ciò che il JavaScript renderizza.
- Impostare dateModified a ogni build invece che quando il contenuto è cambiato.
Come lo risolve easyIndex
easyIndex non cambia mai il tuo sito: il tuo agente di codifica scrive le pagine e lo schema, e easyIndex controlla ogni pagina quando viene inviata e la verifica di nuovo sul sito pubblicato dopo la pubblicazione, compreso se contiene il JSON-LD e una data di aggiornamento reale. Un passaggio si chiude su questa prova, non sul rapporto dell'agente.
Domande frequenti
JSON-LD, Microdata o RDFa?
JSON-LD. Google supporta tutti e tre e raccomanda il JSON-LD quando la configurazione lo consente.
L'agente può inserire il JSON-LD con JavaScript?
Google elabora il JSON-LD presente dopo il rendering, ma il markup reso sul server è più sicuro per i crawler che non eseguono JavaScript.
Organization va in ogni pagina?
Google lo chiede nella home page o in una pagina che descrive l'organizzazione; le altre pagine possono farvi riferimento come publisher.
Cursor o un altro agente funzionano allo stesso modo?
Sì. Qualsiasi agente che modifica i tuoi template può seguire lo stesso prompt; cambia solo il nome del file di istruzioni.
Continua a leggere
- I dati strutturati (schema) aiutano l'AI a citare il mio sito?
- Quali regole SEO devo mettere in AGENTS.md o CLAUDE.md?
- Come faccio un audit SEO tecnico e di visibilità AI con Claude Code?
- ChatGPT e Claude vedono il mio sito fatto in JavaScript?
- Come faccio il GEO con Claude Code o Codex?
- Come funziona easyIndex, cosa mi serve e quanto tempo ci vuole per vedere i risultati?
Verificato il .