Next.js / Astro / Hugo で llms.txt をビルド時に生成する

30 秒で分かる結論：Next.js / Astro / Hugo の llms.txt は sitemap と同じ一覧から生成する

Next.js では app/llms.txt/route.ts のルートハンドラがテキストを返します。export const dynamic = "force-static" を足してビルド時に一度だけ描画させます。Astro では src/pages/llms.txt.ts のエンドポイントが GET をエクスポートして Response を返し、静的ビルドでは dist/llms.txt に書き出されます。Hugo では、名前 llms、baseName llms、メディアタイプ text/plain のカスタム出力フォーマットをホームページの outputs に追加し、layouts/index.llms.txt が /llms.txt として描画されます。

生成そのものは簡単な部分です。大事な判断は中身で、すでに sitemap を作っている一覧を再利用し、初めての訪問者に見せるセクションだけに 絞って、リンクごとに一文を書きます。小さなサイトなら public/ に手書きのファイルを置けば十分で、下の コードは手書きでは古くなるくらいページが増えるサイト向けです。

手書きの静的ファイルか、生成か

Next.js：force-static のルートハンドラ

このサイトが /llms.txt で配信しているファイルと同じ形です。llms.txt という名前のフォルダはルートセグメントとして有効で、ハンドラは Markdown の本文と必要なヘッダを持つ素の Response を返します。

// app/llms.txt/route.ts
import { ROUTES } from "@/lib/routes";

export const dynamic = "force-static";

export function GET() {
  const lines = [
    "# Acme",
    "",
    "> Acme は小規模クリニック向けの予約管理ツールです。以下のページで初期設定、料金、連携を説明しています。",
    "",
    "## ガイド",
    ...ROUTES.filter((r) => r.section === "guides").map(
      (r) => `- [${r.title}](https://acme.example${r.path}): ${r.description}`,
    ),
    "",
    "## Optional",
    "- [変更履歴](https://acme.example/changelog): リリースノート。新しい順。",
    "",
  ];
  return new Response(lines.join("\n"), {
    headers: {
      "Content-Type": "text/markdown; charset=utf-8",
      "Cache-Control": "public, max-age=3600, s-maxage=86400",
    },
  });
}

補足を 2 つ。Next.js 15 以降、GET ハンドラは既定で動的なので、force-static がないとリクエストのたびに描画されます。付ければビルドが一度だけ 書き出します。もう 1 つ、App Router には robots.ts や sitemap.ts のような llms.txt の規約はないので、ルートハンドラが正規の手段です。Next.js のドキュメントサイト自身も /docs/llms.txt を同じやり方で配信しています。

Astro：コンテンツコレクションを読むエンドポイント

src/pages/ 配下の、名前が .txt.ts で終わる .ts ファイルは .txt の URL になります。静的ビルドでは Astro がエンドポイントを一度呼び、 結果を dist/llms.txt に書き出します。

// src/pages/llms.txt.ts
import type { APIRoute } from "astro";
import { getCollection } from "astro:content";

export const GET: APIRoute = async ({ site }) => {
  const docs = (await getCollection("docs", ({ data }) => !data.draft))
    .sort((a, b) => a.data.order - b.data.order);

  const body = [
    "# Acme",
    "",
    "> Acme は小規模クリニック向けの予約管理ツールです。以下のページで初期設定、料金、連携を説明しています。",
    "",
    "## ガイド",
    ...docs.map((d) => `- [${d.data.title}](${new URL(`/docs/${d.id}/`, site)}): ${d.data.description}`),
    "",
  ].join("\n");

  return new Response(body, {
    headers: { "Content-Type": "text/markdown; charset=utf-8" },
  });
};

site の値は astro.config から来て、これがリンクを絶対 URL にします。draft の絞り込みは sitemap インテグレーションが使うのと同じ規則なので、 2 つのファイルの「公開済み」が一致します。ヘッダが意味を持つのは サーバー描画の出力だけで、静的ホストでは拡張子が決めます。

Hugo：ホームページのカスタム出力フォーマット

Hugo はどの種類のページも好きな数のフォーマットに描画できます。 llms.txt 用のフォーマットを定義し、ホームページの outputs に加え、そのテンプレートを書きます。text/plain は txt の拡張子を持つ組み込みのメディアタイプで、 これがファイル名を llms.txt にします。

# hugo.toml
[outputFormats.llms]
  mediaType = "text/plain"
  baseName = "llms"
  isPlainText = true
  notAlternative = true

[outputs]
  home = ["html", "rss", "llms"]

{{/* layouts/index.llms.txt */}}
# {{ .Site.Title }}

> {{ .Site.Params.description }}

## ガイド
{{ range where .Site.RegularPages "Section" "guides" }}
- [{{ .Title }}]({{ .Permalink }}): {{ .Description | default .Summary | plainify }}
{{- end }}

## Optional
{{ range first 10 (where .Site.RegularPages "Section" "posts") }}
- [{{ .Title }}]({{ .Permalink }}): {{ .Description | default .Summary | plainify }}
{{- end }}

outputs.home を設定すると既定の一覧が置き換わるので、html と rss を残します。notAlternative は、テーマが HTML の head に出すことのある rel=alternate のリンクからこのファイルを外します。.Site.RegularPages は下書きと未来日付のコンテンツをすでに除いているので、Hugo が sitemap に載せるものと一覧が一致します。

sitemap と同期させる

手書きの llms.txt の問題は初日に間違っていることではなく、半年後に 間違っていることです。直し方は構造で、ルートの一覧を 1 つにして 両方のファイルがそれを使うようにします。

• Next.js：各ページの path、title、description、 section を持つ lib/routes.ts を用意します。app/sitemap.ts はそれを sitemap の項目に、app/llms.txt/route.ts は絞り込んだ一部を Markdown の行に変換します。ページを足すときはオブジェクトを 1 つ足すだけです。
• Astro：sitemap インテグレーションもエンドポイントも 同じコンテンツコレクションを見るので、共有の元はすでにあります。 両方に同じ draft の絞り込みをかけ、すべての項目の frontmatter に description を書きます。エンドポイントはそれをリンクの注釈に使います。
• Hugo：.Site.RegularPages が組み込みの sitemap テンプレートにも自作の llms テンプレートにも渡ります。注釈には front matter の description を、対象の選択にはパスの手書き一覧では なくセクションの絞り込みを使います。

一覧を共有することは sitemap を写すことではありません。sitemap は全部を載せ、llms.txt は初めての読者に必要なセクションを、 説明する順に、一文ずつ添えて載せます。絞り込みと説明文が 編集の仕事で、ファイルを丸ごと吐き出すのではなくデータから 生成する理由もそこにあります。

確認の仕方

curl -sI https://acme.example/llms.txt | grep -i -E 'HTTP/|content-type'
curl -s https://acme.example/llms.txt | head -8
curl -s https://acme.example/llms.txt | grep -c '^- \['

見たいのは、200 であること、text/ 系の Content-Type であること、1 行目が H1 で、引用ブロックが説明として読めること、 リンク数が数百ではなく数十であることです。そのあとバリデータに 通せば、絶対 URL のつもりで相対になっているリンクや末尾の改行の 欠落も拾えます。

よくある質問