schemastats
Valida
WebMCP

WebMCP per Schema.org

Questo sito espone i suoi dati su Schema.org agli agenti AI come strumenti richiamabili, tramite il Model Context Protocol. Nessuna chiave, nessuna registrazione, nessuno scraping.

Cos'è WebMCP

WebMCP è uno standard emergente dei browser che permette a un sito di consegnare a un agente AI una serie di strumenti invece di una pagina pensata per occhi umani. Anziché indovinare quale pulsante premere o interpretare l'HTML, un agente che arriva su schemastats.com trova un elenco dichiarato di operazioni da chiamare direttamente, con argomenti tipizzati e risposte strutturate.

Qui gli strumenti sono serviti da un server MCP sullo stesso dominio, e il bordo di Cloudflare li innesta nella pagina perché i browser che implementano WebMCP li registrino da soli. Lo stesso server risponde anche a qualunque client MCP che si colleghi direttamente.

Strumenti esposti

Quattro strumenti di sola lettura coprono tutto il dataset: il vocabolario Schema.org e, per ogni tipo e proprietà, quanti domini lo usano mese per mese.

  • search_schema_terms

    Cerca tipi e proprietà per nome parziale e restituisce la fascia di adozione di ciascuno. È il punto di partenza abituale quando si conosce solo una parte del nome.

    Argomenti: query (obbligatorio), kind, limit

  • get_schema_term

    La definizione ufficiale di un termine — descrizione, gerarchia, tipi di valore attesi, deprecazione — insieme allo storico di adozione e, per i tipi, alle proprietà che dichiara.

    Argomenti: name (obbligatorio), kind

  • get_adoption_overview

    Numeri aggregati di un mese: quanti tipi e quante proprietà sono stati osservati e come si distribuiscono nelle fasce per numero di domini.

    Argomenti: month

  • get_adoption_trends

    Termini passati a una fascia di domini più alta o più bassa rispetto al mese precedente.

    Argomenti: month, direction, limit

Come usarlo

Da un agente nel browser

Niente da installare. I browser che implementano WebMCP (Chrome 146+, Edge 147+) leggono gli strumenti dallo script bridge che Cloudflare inietta in ogni pagina e li registrano su document.modelContext per l'agente attivo nella scheda.

<script type="module"
  src="/.webmcp/bridge.js"
  data-packs="c2pa,mcp-server-client"></script>

Da qualunque client MCP

Il server parla Streamable HTTP e non tiene sessione, quindi funziona con qualsiasi client MCP che accetti un URL. Basta puntarlo a questo endpoint — solo POST, nessuna autenticazione:

https://www.schemastats.com/mcp

Esempio di chiamata

curl -sS https://www.schemastats.com/mcp \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "get_schema_term",
      "arguments": { "name": "Product" }
    }
  }'

Cosa fa e cosa non fa

  • Sola lettura. Non c'è nulla da creare, modificare o cancellare: ogni strumento risponde a una domanda su dati pubblici.
  • Nessun dato personale. Gli strumenti arrivano al vocabolario Schema.org e alle statistiche d'uso pubblicate da Google: niente account, niente log, nessun dato dei visitatori.
  • Nessun crawl per conto terzi. Il crawler del validatore non è volutamente esposto come strumento, così un agente non può usare questo endpoint per scaricare pagine altrui.
  • Limite di 60 richieste al minuto per indirizzo IP. Oltre quella soglia l'endpoint risponde 429.
  • Aperto a qualunque origine e libero da usare. I numeri sono fasce, non conteggi esatti di domini, perché così è pubblicato il dataset di origine.

Vedi anche