Impostazioni cookie

I cookie necessari tengono il sito funzionante. La statistica mostra quali pagine sono utili. Puoi cambiare scelta in qualsiasi momento dal footer.

Cookie policy di questo sito — tutti i dettagli: categorie di cookie, come salviamo la tua scelta nel browser e come revocare il consenso.

Necessari

Funzioni di base del sito e la tua scelta di consenso. Sempre attivi.

Analisi

Aiuta a capire come viene usato il sito. Caricato solo dopo il tuo consenso.

GitHubScarica lo ZIP

Dati strutturati e validatore di schema

Valida JSON-LD, Microdata e RDFa contro il vocabolario Schema.org incorporato e le regole locali dei rich result di Google, e bozza nuovo JSON-LD con schema-build.

Vedi su GitHubAvvio rapido

Cosa fa

  • App desktop SpiderHead: la scheda Schema URL con i blocchi JSON-LD rilevati e analizzati.
  • SpiderHead nel terminale: seohead schema-check

Due strati di validazione

Il primo strato chiede se il markup è Schema.org valido: il tipo esiste, la proprietà è ammessa su di esso, le proprietà ereditate contano, e il valore è compatibile con il tipo atteso. Il secondo strato verifica le condizioni visibili in locale per i rich result di Google, come le proprietà obbligatorie. Superare il secondo strato non è una promessa che Google mostrerà un rich result.

  • Vocabolario Schema.org incorporato, funziona offline
  • Proprietà ereditate gestite, quindi un author su un Article non è un falso errore
  • Proprietà obbligatorie e one-of per i tipi di rich result
  • Errori di parse segnalati quando un blocco JSON-LD non è JSON valido

Il markup come grafo

Le entità si collegano tramite riferimenti @id. Il controllo mappa quali entità portano un @id, quali sono collegate, quali restano isolate e se qualche riferimento punta nel vuoto. Un'entità isolata è una segnalazione utile, perché i motori non possono collegarla al resto della pagina.

  • Entità senza @id o senza un legame con il resto
  • Riferimenti a un @id inesistente
  • Markup letto da JSON-LD, Microdata e RDFa

Costruzione

schema-build bozza un @graph connesso per il tipo di pagina, usando solo fatti visibili sulla pagina. Mostra i segnali usati e quanto è sicuro del tipo. Imposti tu il tipo con --type quando la stima è debole, e rivedi la bozza prima che vada online.

  • Fatti presi solo dalla pagina
  • Stima del tipo con segnali e confidenza
  • --type per forzarla
  • Campi raccomandati mancanti elencati

Tre passaggi, una scansione salvata

  1. Valida contro il vocabolario Schema.org

    schema-check legge i dati strutturati della pagina e verifica ogni tipo e proprietà contro il vocabolario Schema.org incorporato.

  2. Verifica il markup come grafo

    Mappa quali entità portano un @id, quali sono collegate, quali restano isolate, e se un riferimento @id punta nel vuoto.

  3. Costruisci il markup mancante

    schema-build propone un @graph connesso usando solo fatti visibili sulla pagina, ed elenca i campi raccomandati ancora mancanti.

Controlli di questa funzionalità

ControlloCosa significaGravitàEvidenza
SCHEMA_VALIDATION_ERRORI dati strutturati della pagina hanno errori di validazione contro il vocabolario Schema.orgImportantNumero di errori di validazione per pagina
STRUCTURED_DATA_PARSE_ERRORUn blocco JSON-LD è presente ma non fa il parse come JSON valido, quindi i motori lo ignoranoImportantBlocchi trovati contro blocchi analizzati
STRUCTURED_DATA_MISSINGLa pagina non ha markup Schema.orgTipPagina con zero blocchi di dati strutturati
Anche nel registro dei controlli
STRUCTURED_DATA_SCHEMA_ERRORSTRUCTURED_DATA_SCHEMA_WARNINGSTRUCTURED_DATA_RICH_RESULT_REQUIRED_MISSING

Un solo comando

bash
seohead schema-check --url https://example.com/product

Prima installa SpiderHead: guida all'installazione. Ogni comando funziona anche come strumento MCP per agenti AI.

Cosa ti serve

  • Una URL di pagina, oppure l'HTML stesso (argomento html) per un controllo offline
  • Un nome di tipo per schema-build quando la stima è debole
  • Nessuna chiave API

Limiti

  • Un controllo statico non può dire se Google mostrerà davvero un rich result
  • Vede l'HTML che riceve: il markup iniettato da JavaScript sfugge se l'HTML non è prima renderizzato
  • RDFa, HTML e dimensioni del grafo sono limitati; superare un limite dà un risultato parziale esplicito
  • schema-build bozza il markup, non lo pubblica

Domande

Cosa eseguo?
seohead schema-check --url https://example.com/product. Per controllare il markup offline, passa l'HTML stesso nell'argomento html, per esempio con --input e un oggetto JSON.
Lo strumento verifica anche l'idoneità ai rich result?
Sì, in locale. Il primo strato è il vocabolario Schema.org: se un tipo esiste, se una proprietà è ammessa su di esso e se un tipo di valore corrisponde. Il secondo strato verifica le proprietà obbligatorie per ogni tipo di rich result di Google per cui ha regole. Non può sapere se Google mostrerà il risultato.
Quali formati di markup legge?
JSON-LD, Microdata e RDFa. Un blocco JSON-LD che non fa il parse è segnalato come errore di parse, perché i motori lo ignorano.
schema-build inventerà fatti per la mia pagina?
No. Costruisce il grafo da fatti visibili sulla pagina. Mostra i segnali e la sua confidenza. Se la stima del tipo è poco affidabile, imposta tu il tipo con --type.
Cambia il mio sito?
No. Entrambi i comandi si limitano a leggere la pagina. Il JSON-LD che bozza è un suggerimento che rivedi e pubblichi tu.
Gira anche in una scansione?
Sì. Una scansione registra le segnalazioni sui dati strutturati per pagina: markup mancante, errori di parse, errori di schema e proprietà obbligatorie dei rich result mancanti.

Continua a esplorare

Dal blog e dal glossario

Schema.org e JSON-LD: guida completaBlogSchema.orgGlossarioJSON-LDGlossarioDati strutturatiGlossario

Altre funzionalità del gruppo · Audit

Audit SEO tecnicoFunzionalitàControllo redirect: catene, loop e 302FunzionalitàControllo link rotti con origine e posizioneFunzionalitàControllo dei tag canonicalFunzionalitàControllo hreflangFunzionalitàControllo di title e meta descriptionFunzionalitàControllo della struttura delle intestazioniFunzionalitàControllo di contenuto duplicato e poveroFunzionalitàControllo e ottimizzatore image SEOFunzionalitàAudit dei link interni e della profonditàFunzionalitàControlli di peso pagina e velocitàFunzionalitàControllo HTTPS e header di sicurezzaFunzionalitàVisibilità nella ricerca AI (GEO/AEO)Funzionalità

Provalo sul tuo sito

Scarica lo ZIPTutte le funzionalità