A versão em Markdown para agentes está quebrada
A página oferece uma versão em Markdown aos agentes, por meio de uma resposta a Accept: text/markdown ou de um <link rel="alternate" type="text/markdown">, mas essa versão retorna um erro, um corpo vazio ou uma página HTML. Os agentes que a pedem não recebem nada útil.
O que significa
A página oferece Markdown aos agentes (como resposta a Accept: text/markdown ou como cópia vinculada), mas o que volta é um erro, um corpo vazio ou uma página HTML.
Por que isso importa para a busca com IA
Um agente que vê o link para o Markdown ou recebe uma resposta text/markdown confia nela e pode não voltar ao HTML. Uma cópia quebrada é pior que nenhuma: o agente falha ou lê uma página de erro como se fosse o seu conteúdo.
Isso costuma acontecer depois de uma migração ou de uma reconstrução do site: os arquivos .md não foram publicados, uma regra de rewrite aponta para um caminho antigo ou um middleware marca o HTML como text/markdown.
Como corrigir
- Abra a URL das evidências e confira o status, o
Content-Typee o corpo. - Se a cópia sumiu, publique-a de novo ou remova a tag
<link rel="alternate" type="text/markdown">e o cabeçalhoLinkque apontam para ela. - Se a resposta for HTML ou estiver vazia, corrija a conversão para que ela retorne o texto da página em Markdown com
Content-Type: text/markdown. - Execute “Verificar de novo” no relatório da página para confirmar o resultado.
Exemplo
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 Como confirmar a correção
Depois da mudança, clique em “Verificar de novo” no relatório: ele mostra o que foi corrigido e como a nota mudou.