Il web sta vivendo la sua trasformazione più radicale dai tempi del passaggio al mobile. Se fino a ieri l’obiettivo della SEO era farsi trovare e leggere dagli umani (e dai crawler di Google), oggi siamo entrati nell’era del Web Agentico. In questo scenario, i visitatori non sono solo persone, ma anche Agenti AI che navigano, comprendono e compiono azioni complesse per conto degli utenti.
Per permettere questa interazione fluida, Google e il W3C hanno introdotto il WebMCP (Web Model Context Protocol).
Questa non è solo un’altra guida introduttiva. Questa è l’enciclopedia definitiva in italiano su WebMCP. Qui troverai tutto ciò che serve per comprendere, implementare e dominare questo standard, trasformando il tuo sito in una risorsa “Agent-Ready” che supera la concorrenza sui motori di risposta AI come ChatGPT Search, Perplexity e Google Gemini.
Cos’è il WebMCP e Perché è il “Robots.txt del Futuro”
Immagina il WebMCP come un’evoluzione intelligente del file robots.txt combinata con le API. Mentre il robots.txt dice ai crawler cosa non possono visitare, il WebMCP dice agli agenti AI cosa possono fare e come farlo.
In termini tecnici, il WebMCP è un’interfaccia JavaScript che estende l’oggetto navigator del browser (navigator.modelContext), permettendo a un sito web di esporre le proprie funzionalità come “strumenti” (Tools) strutturati che un’AI può invocare direttamente [1].
Il Problema dello Screen Scraping
Senza WebMCP, un agente AI che deve prenotare un volo o comprare un prodotto deve “guardare” la pagina come un umano (Screen Scraping), analizzando i pixel o il DOM HTML per indovinare quale bottone premere. Questo processo è:
- Lento: Richiede l’elaborazione di immagini o codice complesso.
- Costoso: Consuma migliaia di token per ogni interazione.
- Fragile: Basta cambiare il colore di un bottone o una classe CSS per rompere l’automazione.
Con WebMCP, l’agente non “guarda”, ma “chiama” una funzione precisa (buyTicket(destination, date)), riducendo il carico computazionale del 67% [1] e garantendo un’esecuzione perfetta.
Impatto SEO e AIO (AI Optimization): La Nuova Frontiera
L’adozione di WebMCP non è solo una questione tecnica, ma una strategia di AIO (Artificial Intelligence Optimization). I motori di ricerca stanno evolvendo in “motori di risposta” e “motori di azione”.
Perché WebMCP migliora la tua visibilità?
- Ranking nei Motori di Risposta: Piattaforme come Perplexity o le AI Overview di Google favoriranno i siti che forniscono dati strutturati e azionabili. Se il tuo sito espone un tool
get_price()chiaro, l’AI lo userà per rispondere all’utente, citandoti come fonte autoritaria. - Tasso di Conversione Agentico: Se un utente chiede al suo assistente “Comprami le scarpe da corsa migliori”, l’assistente sceglierà il negozio che permette l’acquisto diretto via protocollo, saltando i competitor che richiedono navigazione manuale.
- Riduzione del Bounce Rate: Gli utenti (o i loro agenti) trovano subito ciò che cercano senza dover navigare pagine inutili, inviando segnali di soddisfazione al motore di ricerca.
Previsione 2026: “I siti non Agent-Ready saranno invisibili per il 40% del traffico transazionale generato da assistenti AI.”
Specifiche Tecniche: L’Architettura del “Tool Contract”
Il cuore del WebMCP è il Contratto degli Strumenti (Tool Contract). Esistono due modi per implementarlo: l’API Dichiarativa (HTML) e l’API Imperativa (JavaScript).
1. API Dichiarativa (HTML)
Ideale per azioni semplici come la ricerca o l’iscrizione a newsletter. Si basa sull’arricchimento dei form HTML esistenti con attributi specifici come toolname e tooldescription [7].
<form action="/search" method="get" toolname="search_products" tooldescription="Cerca prodotti nel catalogo per nome o categoria">
<input type="text" name="q" placeholder="Cerca..." required>
<button type="submit">Cerca</button>
</form>
2. API Imperativa (JavaScript)
Per interazioni complesse e dinamiche. Si utilizza navigator.modelContext.registerTool per definire strumenti con schema JSON rigoroso.
Struttura JSON del Tool Contract:
- name: Identificativo unico (es.
check_availability). - description: Spiegazione in linguaggio naturale per l’AI.
- inputSchema: Definizione dei parametri accettati (formato JSON Schema).
- execute: La funzione asincrona che esegue l’azione.
Guida Pratica 1: Implementazione su WordPress
Se usi WordPress, puoi rendere il tuo sito Agent-Ready inserendo questo codice nel file functions.php del tuo tema child. Questo script inietta la logica WebMCP nel footer, esponendo la ricerca e la navigazione.
function add_webmcp_support() {
?>
<script>
document.addEventListener('DOMContentLoaded', function() {
// Verifica supporto browser (o polyfill)
if (!window.navigator.modelContext) return;
// Strumento 1: Ricerca nel Blog
window.navigator.modelContext.registerTool({
name: "search_articles",
description: "Cerca articoli nel blog di Davide Minetti su SEO e AI.",
inputSchema: {
type: "object",
properties: {
query: { type: "string", description: "Argomento da cercare" }
},
required: ["query"]
},
execute: async (args) => {
window.location.href = '/?s=' + encodeURIComponent(args.query);
return { result: "Ricerca avviata per: " + args.query };
}
});
// Strumento 2: Recupera Ultimi Articoli (JSON)
window.navigator.modelContext.registerTool({
name: "get_latest_posts",
description: "Restituisce la lista degli ultimi 5 articoli in formato JSON.",
inputSchema: { type: "object", properties: {} },
execute: async () => {
const response = await fetch('/wp-json/wp/v2/posts?per_page=5');
const posts = await response.json();
return {
content: posts.map(p => ({ title: p.title.rendered, link: p.link }))
};
}
});
});
</script>
<?php
}
add_action('wp_footer', 'add_webmcp_support');
Guida Pratica 2: Implementazione Custom (React/Next.js)
Per le applicazioni moderne in React, l’approccio migliore è creare un Custom Hook.
Step 1: useWebMCP.ts
import { useEffect } from 'react';
export const useWebMCP = () => {
useEffect(() => {
if (!navigator.modelContext) return;
navigator.modelContext.registerTool({
name: "navigate_site",
description: "Naviga verso le sezioni principali del sito.",
inputSchema: {
type: "object",
properties: {
section: {
type: "string",
enum: ["home", "blog", "servizi", "contatti"],
description: "La sezione di destinazione"
}
},
required: ["section"]
},
execute: async ({ section }) => {
const paths = { home: "/", blog: "/blog", servizi: "/servizi", contatti: "/contatti" };
window.location.href = paths[section];
return { success: true, message: `Navigato a ${section}` };
}
});
}, []);
};
Step 2: Integrazione in App.tsx
import { useWebMCP } from './hooks/useWebMCP';
function App() {
useWebMCP(); // Attiva gli agenti AI al caricamento
return <RouterProvider router={router} />;
}
Casi d’Uso Avanzati: E-commerce, News e Local Business
WebMCP non serve solo a navigare. Ecco come può trasformare settori specifici.
🛒 E-commerce: Acquisto Diretto
Permetti all’agente di aggiungere prodotti al carrello e procedere al checkout senza visitare la pagina prodotto.
navigator.modelContext.registerTool({
name: "add_to_cart",
description: "Aggiunge un prodotto al carrello dato il suo ID.",
inputSchema: {
type: "object",
properties: {
productId: { type: "string" },
quantity: { type: "integer", minimum: 1 }
},
required: ["productId"]
},
execute: async ({ productId, quantity }) => {
await cartService.add(productId, quantity);
return { success: true, cartTotal: await cartService.getTotal() };
}
});
📰 News & Editoria: Citazioni Corrette
Assicurati che le AI citino correttamente le tue notizie fornendo metadati strutturati.
navigator.modelContext.registerTool({
name: "get_fact_check",
description: "Restituisce il fact-checking strutturato per l'articolo corrente.",
execute: async () => {
return {
claim: "L'AI sostituirà i SEO Specialist",
verdict: "Falso",
source: "Davide Minetti - SEO Specialist 2026"
};
}
});
📍 Local Business: Prenotazioni
Per ristoranti o studi professionali, esponi la disponibilità in tempo reale.
navigator.modelContext.registerTool({
name: "check_availability",
description: "Controlla se c'è disponibilità per un appuntamento.",
inputSchema: {
type: "object",
properties: { date: { type: "string", format: "date" } }
},
execute: async ({ date }) => {
const slots = await bookingApi.getSlots(date);
return { availableSlots: slots };
}
});
Sicurezza e Best Practices
Aprire il sito agli agenti comporta rischi? Sì, se non si seguono queste regole auree.
- Permission-First: Il browser (Chrome) agisce da gatekeeper. Per azioni sensibili (es. “Paga ora”), WebMCP richiede esplicitamente la conferma dell’utente tramite
client.requestUserInteraction()[5]. - Nessun Dato Sensibile: Non esporre mai strumenti che restituiscono dati personali (GDPR) o token di amministrazione.
- Rate Limiting: Proteggi le tue API sottostanti. Un agente potrebbe chiamare
search100 volte al secondo. Implementa limiti lato server. - Descrizioni “Human-Like”: Scrivi le descrizioni dei tool per un umano intelligente, non per un compilatore. L’AI deve capire l’intento (“Cerca prodotti economici”), non solo la sintassi.
Conclusione e Risorse Ufficiali
Implementare WebMCP oggi è come aver adottato il protocollo HTTPS nel 2015 o il Responsive Design nel 2012. Non è ancora obbligatorio, ma chi lo fa ottiene un vantaggio competitivo enorme, posizionandosi come leader tecnologico agli occhi di Google e degli utenti.
Il web non è più solo “clicca e leggi”. È “chiedi e ottieni”. E il tuo sito deve essere pronto a rispondere.
Riferimenti Bibliografici
- Forbes: Google Ships WebMCP, The Browser-Based Backbone For The Agentic Web
- WebMCP Official Documentation
- W3C Web Machine Learning Community Group
- GitHub: WebMCP Specification & Polyfill
- Ivan Turkovic: How to Make Your Website Agent-Ready
- Schema.org vs WebMCP Comparison
- Chrome Developers: Declarative WebMCP API


