I 22 controlli di agent readiness
Lo scanner esegue 22 controlli in cinque categorie. Ognuno ha un criterio di superamento, una traccia di evidenze e — quando non passa — un prompt che puoi consegnare a un agente di coding.
Scopribilità
Un agente può capire cos'è il tuo sito e quali URL contano, senza scansionare il tuo HTML in cerca di indizi?
robots.txt
Restituisce HTTP 200 con testo semplice contenente almeno una direttiva User-agent.
robots.txt regole per i crawler AI
Sitemap
Un sitemap XML valido è servito su /sitemap.xml, oppure dichiarato con una direttiva Sitemap: in robots.txt.
sitemap per gli agenti AI
Link headers
La risposta della homepage porta Link headers con almeno una relazione utile agli agenti.
HTTP Link headers scoperta agenti RFC 8288
DNS for AI Discovery
Record SVCB/HTTPS in modalità ServiceMode o un indice TXT esistono sotto il namespace _agents, idealmente firmati con DNSSEC.
DNS-AID scoperta degli agenti SVCB
Contenuti
Quando un agente chiede il Markdown, gli restituisci Markdown pulito invece di una parete di markup da analizzare?
Controllo accesso dei bot
Quale policy hai dichiarato per i crawler AI e puoi dimostrare quali richieste sono tue?
Regole per i bot AI
robots.txt nomina crawler AI noti, oppure contiene un gruppo wildcard che li copre.
robots.txt regole User-agent per bot AI GPTBot ClaudeBot
Content Signals
robots.txt dichiara preferenze Content-Signal che coprono ai-train, search e ai-input.
content signals robots.txt ai-train search ai-input
Web Bot Auth
Un JWKS è pubblicato su /.well-known/http-message-signatures-directory.
Web Bot Auth JWKS firme dei messaggi HTTP
API, auth, MCP e scoperta delle skill
Se esponi un'API, un server MCP o un agente, è individuabile nella posizione well-known che un agente si aspetterebbe?
API Catalog
/.well-known/api-catalog restituisce application/linkset+json con almeno una voce.
API catalog RFC 9727 linkset well-known
Scoperta OAuth
/.well-known/oauth-authorization-server o /.well-known/openid-configuration espone metadati utilizzabili.
OAuth OIDC scoperta metadati well-known
OAuth Protected Resource
/.well-known/oauth-protected-resource dichiara resource e authorization_servers.
OAuth protected resource metadati RFC 9728
Auth.md
/auth.md esiste con un H1 Markdown che menziona auth.md.
auth.md metadati di registrazione degli agenti
MCP Server Card
/.well-known/mcp/server-card.json descrive il server con un serverInfo.name.
MCP Server Card scoperta well-known
A2A Agent Cardoptional
/.well-known/agent-card.json dichiara name, version e le interfacce supportate.
A2A Agent Card scoperta tra agenti
Agent Skills
/.well-known/agent-skills/index.json elenca almeno una skill.
Agent Skills indice di scoperta SKILL.md
WebMCP
Il codice della pagina registra strumenti lato browser tramite navigator.modelContext.
WebMCP navigator.modelContext strumenti nel browser
Manifest ARD
/.well-known/ai-catalog.json dichiara specVersion, host e almeno una voce.
ARD Agentic Resource Discovery ai-catalog
Commercio
Conteggiato solo quando il sito sembra un negozio: un agente può pagare, ordinare e saldare senza che una persona compili un modulo?
x402
Le route a pagamento rispondono con HTTP 402 e i requisiti x402, oppure viene pubblicato un documento di discovery.
x402 pagamenti degli agenti HTTP 402
MPP
Un documento OpenAPI annota le operazioni a pagamento con x-payment-info.
MPP Machine Payment Protocol OpenAPI x-payment-info
UCP
/.well-known/ucp dichiara protocol_version e almeno un servizio.
UCP Universal Commerce Protocol well-known
ACP
/.well-known/acp.json dichiara protocol.name, api_base_url, transports e capabilities.services.
ACP protocollo di commercio per agenti discovery
AP2optional
L'A2A Agent Card annuncia un'estensione AP2 con le informazioni sui ruoli.
AP2 protocollo di pagamento degli agenti estensione A2A
Ready to see where you stand?
Run the scanner against your own domain and get the fix list.