# Schema & Entity Builder AI

https://rankproof.eu/it/tools/ai-schema-entity-builder

## Risposta breve

Rileva il JSON-LD esistente, valida la copertura delle entità e suggerisce i tipi di schema mancanti.

## Cosa fa

Legge i dati strutturati JSON-LD nella tua pagina e controlla ogni blocco alla ricerca di problemi: JSON che non viene analizzato correttamente, un @context o un @type mancante, un Organization senza name, un WebSite senza url e una FAQPage senza domande. Mostra quali dei sette tipi schema.org più comuni (Organization, WebSite, BreadcrumbList, FAQPage, Article, Product, LocalBusiness) la pagina dichiara, assegna un punteggio e suggerisce cosa aggiungere. Segnala anche se il sito pubblica un file /llms.txt.

## Come funziona

1. Inserisci l'URL di una pagina
2. Recuperiamo l'HTML grezzo della pagina e leggiamo ogni blocco JSON-LD, inclusi gli elementi dentro @graph
3. Controlliamo ogni blocco per errori di parsing e proprietà fondamentali mancanti, ed elenchiamo i tipi che dichiara
4. Restituiamo un punteggio, la copertura dei tipi, i problemi di validazione e un prossimo passo

## Esempio di input e output

INPUT

```text
url: https://example.com
```

OUTPUT

```text
Punteggio dati strutturati: 77/100
Blocchi JSON-LD: 2 · tipi di entità: 3 · errori: 0 · avvisi: 1

dati strutturati trovati                 OK
nessun errore di validazione             OK
entità Organization presente             OK
entità WebSite presente                  OK
/llms.txt trovato                        warn

Copertura entità
  Organization     presente    WebSite       presente
  BreadcrumbList   assente     FAQPage       assente
  Article          presente    Product       assente
  LocalBusiness    assente

Problemi di validazione
  Blocco 2: la voce WebSite non ha l'url.
```

## Perché è importante

I dati strutturati dicono ai motori di ricerca, in una forma che possono leggere in modo affidabile, chi pubblica una pagina e di cosa parla. Google usa il markup Organization, ad esempio, quando sceglie il logo per i suoi risultati e i pannelli di conoscenza, e ignora il markup che non riesce ad analizzare. Google dice anche che non serve un markup speciale per comparire nelle sue funzionalità AI, quindi considera questo come buona igiene per la ricerca piuttosto che una scorciatoia verso le risposte AI.

## Chi lo usa

- **Responsabile contenuti**: Dopo aver pubblicato un articolo, verifica che il suo blocco Article venga analizzato correttamente e che i blocchi Organization e WebSite a livello di sito siano ancora presenti.
- **SEO tecnico**: Controlla una pagina per ogni template e trova i template privi di markup Organization o WebSite.
- **Consulente di agenzia**: Mostra a un nuovo cliente quali tipi di schema dichiarano le sue pagine chiave e quali tipi di base mancano.

## Domande frequenti

### In cosa differisce dal Validatore di dati strutturati?

Il Validatore di dati strutturati controlla che ogni blocco JSON-LD venga analizzato correttamente ed elenca i suoi tipi. Questo strumento controlla anche alcune proprietà fondamentali, mostra la copertura di sette tipi comuni, assegna un punteggio e suggerisce un prossimo passo.

### Controlla l'idoneità ai risultati arricchiti?

No. Controlla la sintassi JSON, @context, @type e alcune proprietà fondamentali. Ogni risultato arricchito ha i propri requisiti; verificali con il Rich Results Test di Google.

### Perché segnala llms.txt?

llms.txt è una proposta facoltativa della comunità, nata nel 2024, per dare agli strumenti AI una breve guida a un sito. Nessun grande motore di ricerca AI ha dichiarato di leggere il file su altri siti, e Google dice che le sue funzionalità di ricerca non lo usano, quindi il risultato è mostrato a titolo informativo e non modifica il punteggio.

### Può scrivere il markup al posto mio?

No. Trova, controlla e suggerisce. Per scrivere nuovo markup, usa il generatore di markup Schema.

### Legge i microdata o RDFa?

No, solo JSON-LD. Google supporta tutti e tre i formati e consiglia JSON-LD perché è il più facile da mantenere.

### Vede il markup aggiunto da JavaScript?

No. Legge l'HTML restituito dal tuo server, quindi il JSON-LD aggiunto dagli script dopo il caricamento della pagina non è incluso.

## Strumenti correlati in IA & GEO

- [Generatore llms.txt](https://rankproof.eu/it/tools/ai-llms-txt-generator)
- [Scoring Cite-Worthiness AI](https://rankproof.eu/it/tools/ai-cite-worthiness-scorer)
- [Content Gap AI](https://rankproof.eu/it/tools/ai-content-gap)