La diagnosi esegue 38 controlli sui sei criteri. Ogni criterio riceve un punteggio da 0 a 100 e il punteggio complessivo è una media ponderata: catalogo 25%, carrello 20%, checkout 15%, policy sui bot 15%, pagamento 15% e tracciabilità 10%. Da 85 punti il negozio è pronto per gli agenti; da 70, pronto con alcune lacune; da 40, parzialmente pronto; sotto, non ancora pronto. Se il negozio blocca la lettura, il report lo dice invece di mostrare un punteggio basso. Il report mostra cosa è stato trovato e le cinque correzioni di maggiore impatto.
01
Catalogo accessibile agli agenti
Un agente deve capire cosa vende il negozio senza interpretare il layout della pagina. I dati di prodotto, prezzo e disponibilità devono essere leggibili dalle macchine, ad esempio con schema.org Product e Offer, feed di catalogo o una sitemap aggiornata. Se l’offerta esiste solo come immagine o testo libero, l’agente non ha una base affidabile per confrontare e scegliere.
13 controlli: robots.txt, sitemap XML, llms.txt, JSON-LD Product e Offer, varianti, feed del catalogo, prezzo nell’HTML iniziale, Organization e sameAs, pagine di fiducia, metadati, indicizzabilità e dimensione della home.
02
Endpoint del carrello
Scegliere il prodotto è solo l’inizio: l’agente deve comporre un carrello. Può trattarsi di un’API del carrello o di URL prevedibili che portano sempre allo stesso insieme di articoli. Senza un percorso stabile, la visita si ferma alla vetrina e l’ordine non nasce mai.
4 controlli: piattaforma identificabile, JSON pubblico del prodotto, lettura del carrello (come /cart.js) e prezzo con variante o disponibilità.
03
Checkout compatibile con gli agenti
Il checkout deve essere un flusso che un agente riesce a completare, e non solo una sequenza di clic pensata per una persona. Questo include la compatibilità con i protocolli di commercio agentico e un percorso chiaro fino alla conferma dell’ordine. Se un passaggio funziona solo con un’interazione umana sullo schermo, l’acquisto si ferma a metà.
5 controlli: captcha o challenge, acquisto come ospite, profilo UCP su /.well-known/ucp, documento ACP su /.well-known/acp.json e altri canali machine-to-machine.
04
Policy sui bot
Il negozio deve dichiarare quali automazioni accetta. Questo compare nel robots.txt, nel llms.txt e nelle regole di firewall o di bot management: non devono bloccare gli agenti legittimi e devono saper riconoscere i bot verificati. Trattare ogni accesso automatico come un abuso chiude la porta anche a chi verrebbe ad acquistare.
9 controlli: regole robots.txt per agente, risposta della home a ChatGPT-User, OAI-SearchBot, Claude-User e PerplexityBot, accesso della sonda, redirect HTTP, contenuti senza login, risposta in Markdown, 404 utile, policy per i crawler di addestramento e bot firmati.
05
Tracciabilità degli ordini
Dopo il pagamento, lo stato e il tracciamento devono essere consultabili dalle macchine. L’agente, o la persona che lo ha autorizzato, deve poter seguire l’ordine senza copiare codici da un’e-mail a un altro sito. Una consultazione dello stato tramite API o dati strutturati chiude il ciclo di vendita.
3 controlli: pagina di tracciamento senza account, JSON-LD Order o ParcelDelivery e corriere indicato.
06
Capacità di pagamento
L’acquisto si conclude solo quando esiste un metodo di pagamento che l’agente può usare e autorizzare. Questo include i pagamenti programmatici, in cui l’addebito segue una regola concordata in anticipo, senza che qualcuno digiti i dati a ogni ordine. Se l’unico percorso è un pulsante pensato per una persona, questa fase resta incompleta.
4 controlli: metodi di pagamento scritti nell’HTML (Pix, carta, boleto), Pix, gateway identificabile e pagamento programmatico: UCP con payment handler, ACP o /.well-known/x402.