La versione Markdown per gli agenti non funziona
La pagina offre agli agenti una versione Markdown, tramite una risposta ad Accept: text/markdown o un <link rel="alternate" type="text/markdown">, ma quella versione restituisce un errore, un corpo vuoto o una pagina HTML. Gli agenti che la chiedono non ottengono niente di utile.
Cosa significa
La pagina offre Markdown agli agenti (come risposta ad Accept: text/markdown o come copia collegata), ma quello che torna indietro è un errore, un corpo vuoto o una pagina HTML.
Perché conta per la ricerca AI
Un agente che vede il link Markdown o riceve una risposta text/markdown se ne fida e potrebbe non tornare all'HTML. Una copia rotta è peggio di nessuna copia: l'agente fallisce, oppure legge una pagina di errore come se fosse il tuo contenuto.
Di solito succede dopo una migrazione o una ricostruzione del sito: i file .md non sono stati pubblicati, una regola di rewrite punta a un vecchio percorso, oppure un middleware etichetta l'HTML come text/markdown.
Come risolvere
- Apri l'URL indicato nelle prove e guarda lo stato, il
Content-Typee il corpo. - Se la copia non c'è più, pubblicala di nuovo oppure rimuovi il tag
<link rel="alternate" type="text/markdown">e l'headerLinkche puntano a essa. - Se la risposta è HTML o vuota, correggi la conversione in modo che restituisca il testo della pagina in Markdown con
Content-Type: text/markdown. - Esegui «Ricontrolla» sul report della pagina per confermare il risultato.
Esempio
curl -sS -H 'Accept: text/markdown' -D - -o /dev/null https://example.com/guide/
# expect: HTTP/2 200, content-type: text/markdown; charset=utf-8, vary: Accept Come confermare la correzione
Dopo la modifica, premi «Ricontrolla» nel report: mostra cosa è stato risolto e come è cambiato il punteggio.