エージェント向けの Markdown 版が壊れています
短い答え
このページは Accept: text/markdown への応答または <link rel="alternate" type="text/markdown"> を通じてエージェントに Markdown 版を提供していますが、その版はエラー、空の本文、または HTML ページを返します。それを求めたエージェントは役に立つものを何も受け取れません。
意味
このページはエージェントに Markdown を提供していますが (Accept: text/markdown への応答、またはリンクされたコピー)、返ってくるのはエラー、空の本文、または HTML ページです。
AI 検索で重要な理由
Markdown のリンクを見つけたり text/markdown の応答を受け取ったりしたエージェントは、それを信頼し、HTML に戻らないことがあります。壊れたコピーはないよりも悪い結果を招きます。エージェントは失敗するか、エラーページをあなたのコンテンツとして読んでしまいます。
これは通常、移転や再構築のあとに起こります。.md ファイルがデプロイされていない、リライトルールが古いパスを指している、ミドルウェアが HTML に text/markdown のラベルを付けている、といったケースです。
修正方法
- 証拠にある URL を開き、ステータス、
Content-Type、本文を確認します。 - コピーがなくなっている場合は、もう一度デプロイするか、それを指している
<link rel="alternate" type="text/markdown">タグとLinkヘッダーを削除します。 - 応答が HTML または空の場合は、ページのテキストを Markdown として
Content-Type: text/markdownで返すよう変換を修正します。 - ページのレポートで「もう一度チェック」を実行して結果を確認してください。
例
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 修正の確認方法
変更後、レポートで「もう一度チェック」を押してください。修正されたものとスコアの変化が表示されます。