LighthouseがMarkdownリンクのないllms.txtを不合格にする理由

概要

Chromeの新しいLighthouse Agentic Browsing監査は、llms.txtファイルをMarkdownドキュメントとして扱います。

そのため、ファイル内のリンクがすべて正確で機能していても、Markdownリンク構文を使用していない場合、この監査に不合格となります。

例えば、あるウェブサイトで監査を実行したところ、llms.txt監査が「File does not appear to contain any links（ファイルにリンクが含まれていないようです）」というエラーで不合格となりました。

この問題の修正には、各リンクにつき5文字を追加するだけでした。

llms.txtファイルの仕様では、その形式がMarkdownドキュメントであることが明記されています。

したがって、すべてのリンクは[テキスト](URL)というMarkdownリンク構文でエンコードされている必要があります。

Lighthouseのパーサーはこれを厳密に適用します。

この監査は、ファイルが機械的に解析可能であるかどうかをチェックします。

ファイルの有用性や内容の品質をチェックするわけではありません。

例えば、AIOSEOのようなWordPressプラグインは、デフォルトでMarkdownリンク構文を含むllms.txtファイルを生成するため、多くのサイトでこの監査に合格している可能性があります。

この監査は、llms.txtがMarkdownとして解析可能であるかを教えてくれますが、そのファイルがウェブサイトを正直に記述しているかを判断することはできません。

この確認はウェブサイト運営者自身が行う必要があります。

Chrome DevToolsでAgentic Browsingカテゴリを選択して監査を実行し、不合格の場合はMarkdownリンク構文に修正することが推奨されます。

LighthouseのAgentic Browsing監査におけるllms.txtのチェックは、今後のAIエージェントや機械によるウェブコンテンツの理解において、機械可読性がどれほど重要になるかを示唆しています。

ファイル拡張子が.txtでMIMEタイプがtext/plainであっても、パーサーがMarkdownとして解釈するという事実は、技術的な実装の詳細がいかに重要かを表しています。

この監査をクリアするための最も直接的なアクションは、llms.txt内のすべてのリンクをMarkdownリンク構文（[説明文](URL)の形式）で記述することです。

これは非常に簡単な変更であり、すぐに監査結果を改善できます。

「File does not appear to contain any links」というエラーが表示された場合、たいていこの構文が原因です。

しかし、監査に合格することはあくまで第一歩に過ぎません。

この監査はファイルが「解析可能か」を問うものであり、「有用か」「正確か」は判断しません。

したがって、サイト運営者は、llms.txtの内容がウェブサイトの構造やコンテンツを正確に反映しているか、そしてAIエージェントにとって本当に役立つ情報を提供しているかを、手動で定期的に確認する必要があります。

特に、プラグインによって自動生成されたファイルの場合、意図しない情報が含まれていたり、重要な情報が欠落していたりする可能性があるため、注意が必要です。

この監査を通じて、私たちは機械ファーストのアーキテクチャという概念を改めて認識させられます。

ページのレイアウトや人間が視覚的に認識しやすい形式だけでなく、機械がプログラム的に情報を抽出しやすいデータモデルや構造でコンテンツを提供することが、これからのウェブではますます重要になるでしょう。

llms.txtは、そのための小さな、しかし重要な一歩と言えます。