SEO
llms.txtをAI参照用の補助インデックスとして整える
llms.txtはHTML、内部リンク、sitemap、構造化データの代わりではありません。AIがサイトの入口と重要ページを把握しやすくする補助資料として運用します。
ui.design: meta-wellknown
まず確認する症状
- サービス説明だけで、ナレッジ記事や修正方法へのリンクがない。
- robotsやsitemapと方針がずれている。
- ページは存在するが、検索エンジンやAIが主題、階層、更新日、関連ページを取り出しにくい。
- metadata、H1、パンくず、内部リンク、sitemap、llms.txtの説明がそれぞれ別の内容を指している。
なぜ問題か
- AI検索やコーディングエージェントが参照する可能性のある入口を整えると、修正ナレッジを拾いやすくなります。
- ただし標準化状況は変わるため、HTML本文と内部リンクを正にします。
- SEOとAI参照性は、1つのタグではなく、HTML本文、内部リンク、構造化データ、sitemapの整合で決まります。
- 機械可読性が弱いと、良い本文があっても検索結果、AI要約、コーディングエージェントの参照に乗りにくくなります。
診断で見る指標
llms.txtの有無
重要カテゴリリンク
サービス方針
HTML/sitemapとの整合
HTML本文とmetadataの一致
canonical/index/noindexの整合
構造化データ検証結果
内部リンクからの到達性
sitemapとrobotsの矛盾
重要URLの説明
Learnカテゴリ
更新運用
正式標準ではない前提
修正方法
最小修正
主要ページを列挙する
Scan、Review Pack、方法論、Learnカテゴリを短い説明つきで載せます。
推奨修正
修正ナレッジを分類する
Growth、UX、Accessibility、SEO、Implementationの代表記事を載せます。
さらに改善
更新運用を決める
新規Learn記事の追加時にsitemapとllms.txtの同期を確認します。
受け入れ条件
- 01PCとスマホの両方で目視確認し、主なCTAまたは操作対象が迷わず見つかる。
- 02キーボード操作、読み上げ補助、または自動検査で再発しやすい項目を確認する。
- 03修正後にui.designで再スキャンし、同じ所見が残る場合は原因を分解する。
- 04HTML本文、title、description、H1、構造化データ、内部リンクの主題が同じページ意図を示している。
- 05公開したいページが通常のHTMLリンクとsitemapから発見でき、robotsやnoindexで塞がれていない。
- 06llms.txtには、サイトの目的、重要ページ、Learnカテゴリ、代表記事が短い説明付きで載っている。
- 07AI向け補助インデックスとして扱い、HTML本文、内部リンク、sitemap、構造化データを正の情報源にしている。
コーディングエージェント向け修正指示
目的: public/llms.txtにLearnトップ、主要カテゴリ、代表記事へのURLを追加してください。llms.txtを唯一の正にせず、HTMLリンクとsitemapにも同じページを出してください。 追加確認: llms.txt更新時は、同じURLがHTMLリンクとsitemapにも存在することを確認し、過剰なプロンプト文ではなく参照先一覧にしてください。
参考資料
よくある失敗
- llms.txtだけ更新し、実際のHTMLから辿れないページを作る。
- 見た目だけを整え、見出し、リンク、フォームラベルなどの意味構造を直さない。
- 1つの指摘だけを直し、同じ原因から出た別画面の再発を確認しない。
- 検索向けの文言だけをmetadataに詰め、画面上の本文やH1と違う約束をする。
- llms.txtやsitemapだけを更新し、実際のHTMLリンクから辿れないページを増やす。