Methodology v1.0
July 18, 2026 • By AICompatible Team • 8 min read

Next.js、WordPress、Shopifyでllms.txtを動的生成する方法:実践的な開発者ガイド

成長するプラットフォームにおけるllms.txtファイルの動的生成が不可欠な理由

要点(BLUF): 静的なllms.txtファイルは、高速でコンテンツが更新されるプラットフォームでは数時間で陳腐化し、AIエージェントが発見する情報と実際に存在する情報との間に重大なギャップが生じます。動的生成により、リアルタイムの正確性が確保され、手動メンテナンスの負担が解消され、大規模言語モデルが常に最新のサイト構造、コンテンツ階層、リソースの場所を受け取ることが保証されます。これは、毎日数十ページを公開するエンタープライズWordPressインストール、Next.jsアプリケーション、Shopifyストアにとって不可欠です。

llms.txt仕様と動的要件の理解

llms.txtファイルは、AIクローラー、言語モデル、自律エージェントをサイトの情報アーキテクチャに導く機械可読マニフェストとして機能します。クロール許可に焦点を当てるrobots.txtとは異なり、llms.txtはLLMの利用に特化して最適化されたセマンティック構造、コンテンツ分類、優先度シグナルを提供します。

動的生成が重要になるのは以下の場合です:

  • コンテンツの更新速度が手動更新能力を超える場合: 毎日50以上の商品を追加するEコマースカタログ、時間単位で公開するニュースサイト、リリースサイクルごとに更新されるSaaSドキュメント
  • タクソノミーがプログラム的に進化する場合: 自動生成されるカテゴリページ、動的フィルタリングシステム、ユーザー生成コンテンツの階層
  • パーソナライゼーション層が存在する場合: 地理的バリエーション、言語固有のルート、認証ゲート付きリソースで条件付き公開が必要な場合
  • マルチソースコンテンツ集約: ヘッドレスCMSアーキテクチャ、コンテンツAPIを提供するマイクロサービス、連携データソース

WordPressでの動的llms.txt実装

WordPressはWeb全体の43%を占めており、そのllms.txt実装パターンは非常に重要です。以下のアプローチでは、template_redirectアクションを使用してテーマレンダリング前にリクエストをインターセプトし、最大のパフォーマンスとキャッシュレイヤーとの互換性を確保します。

完全なWordPress PHP実装

<?php
/**
 * WordPress用動的llms.txtジェネレーター
 * テーマのfunctions.phpに追加するか、プラグインとして作成
 */

add_action('template_redirect', 'serve_dynamic_llms_txt');

function serve_dynamic_llms_txt() {
    // /llms.txtリクエストにのみ応答
    if ($_SERVER['REQUEST_URI'] !== '/llms.txt') {
        return;
    }

    // 適切なヘッダーを設定
    header('Content-Type: text/plain; charset=utf-8');
    header('X-Robots-Tag: noindex');
    
    // 真に動的なコンテンツのためキャッシュを防止
    header('Cache-Control: no-cache, must-revalidate');
    
    // 出力開始
    echo "# llms.txt - 動的生成\n";
    echo "# 生成日時: " . current_time('c') . "\n\n";
    
    // サイトメタデータ
    echo "# サイト: " . get_bloginfo('name') . "\n";
    echo "# 説明: " . get_bloginfo('description') . "\n";
    echo "# URL: " . home_url() . "\n\n";
    
    // メインページ
    echo "## プライマリナビゲーション\n\n";
    $pages = get_pages(array('sort_column' => 'menu_order', 'hierarchical' => 0));
    foreach ($pages as $page) {
        echo "- [{$page->post_title}](" . get_permalink($page->ID) . ")\n";
    }
    echo "\n";
    
    // カテゴリ別ブログ投稿
    echo "## ブログコンテンツ\n\n";
    $categories = get_categories(array('hide_empty' => true, 'orderby' => 'count', 'order' => 'DESC'));
    
    foreach ($categories as $category) {
        echo "### {$category->name} ({$category->count}件の投稿)\n\n";
        
        $posts = get_posts(array(
            'category' => $category->term_id,
            'numberposts' => 10,
            'orderby' => 'date',
            'order' => 'DESC'
        ));
        
        foreach ($posts as $post) {
            $date = get_the_date('Y-m-d', $post->ID);
            echo "- [{$post->post_title}](" . get_permalink($post->ID) . ") - {$date}\n";
        }
        echo "\n";
    }
    
    // WooCommerce製品連携
    if (class_exists('WooCommerce')) {
        echo "## 製品カタログ\n\n";
        
        $product_categories = get_terms(array(
            'taxonomy' => 'product_cat',
            'hide_empty' => true,
            'orderby' => 'count',
            'order' => 'DESC',
            'number' => 10
        ));
        
        foreach ($product_categories as $cat) {
            echo "- [{$cat->name}](" . get_term_link($cat) . ") - {$cat->count}製品\n";
        }
        echo "\n";
    }
    
    // ドキュメントまたはカスタム投稿タイプ
    $custom_post_types = get_post_types(array('public' => true, '_builtin' => false), 'objects');
    
    foreach ($custom_post_types as $cpt) {
        echo "## {$cpt->labels->name}\n\n";
        
        $cpt_posts = get_posts(array(
            'post_type' => $cpt->name,
            'numberposts' => 20,
            'orderby' => 'date',
            'order' => 'DESC'
        ));
        
        foreach ($cpt_posts as $post) {
            echo "- [{$post->post_title}](" . get_permalink($post->ID) . ")\n";
        }
        echo "\n";
    }
    
    exit; // WordPressの実行継続を防止
}

WordPressパフォーマンス最適化戦略

高トラフィックのWordPressインストールでは、以下のキャッシュパターンを実装します:

  • Transient APIキャッシング: set_transient('llms_txt_cache', $output, 3600)で生成された出力を保存し、投稿公開フックで自動無効化
  • オブジェクトキャッシュ統合: 分散環境でRedisまたはMemcachedを活用
  • CDNエッジキャッシング: CloudflareやFastlyのエッジノード用に適切なCache-Controlヘッダー(例:max-age=1800)を設定
  • 選択的再生成: save_post、created_term、deleted_termアクションにフックして、コンテンツ変更時のみキャッシュを無効化

Next.jsルートハンドラー実装(App Router)

Next.js 13以降のApp Routerは、大規模なllms.txtファイルに最適なネイティブストリーミング機能を提供します。以下の実装では、型安全性とエッジランタイム互換性のためにTypeScriptを使用したルートハンドラーを使用します。

Next.js TypeScript実装

// app/llms.txt/route.ts

import { NextRequest, NextResponse } from 'next/server';

// オプション: グローバル配信のためにEdge Runtimeを有効化
// export const runtime = 'edge';

export async function GET(request: NextRequest) {
  const encoder = new TextEncoder();
  
  const stream = new ReadableStream({
    async start(controller) {
      // チャンク書き込み用ヘルパー関数
      const write = (text: string) => {
        controller.enqueue(encoder.encode(text));
      };
      
      // ヘッダーセクション
      write('# llms.txt - 動的サイトマップ\n');
      write(`# 生成日時: ${new Date().toISOString()}\n`);
      write(`# ベースURL: ${process.env.NEXT_PUBLIC_SITE_URL}\n\n`);
      
      // CMS/データベースからデータを取得
      try {
        // 例: ヘッドレスCMSから取得
        const pages = await fetch(`${process.env.CMS_API_URL}/pages`, {
          headers: { 'Authorization': `Bearer ${process.env.CMS_API_KEY}` },
          next: { revalidate: 3600 } // ISRスタイルのキャッシング
        }).then(res => res.json());
        
        write('## メインページ\n\n');
        pages.forEach((page: any) => {
          write(`- [${page.title}](${process.env.NEXT_PUBLIC_SITE_URL}${page.slug})\n`);
        });
        write('\n');
        
        // ページネーション処理付きブログ投稿
        write('## ブログ記事\n\n');
        let page = 1;
        let hasMore = true;
        
        while (hasMore && page <= 10) { // 無限ループ防止のため制限
          const posts = await fetch(
            `${process.env.CMS_API_URL}/posts?page=${page}&per_page=50`,
            { next: { revalidate: 1800 } }
          ).then(res => res.json());
          
          if (posts.length === 0) {
            hasMore = false;
            break;
          }
          
          posts.forEach((post: any) => {
            const date = new Date(post.publishedAt).toISOString().split('T')[0];
            write(`- [${post.title}](${process.env.NEXT_PUBLIC_SITE_URL}/blog/${post.slug}) - ${date}\n`);
          });
          
          page++;
        }
        write('\n');
        
        // 製品カタログ(該当する場合)
        const products = await fetch(`${process.env.CMS_API_URL}/products?limit=100`)
          .then(res => res.json())
          .catch(() => []);
        
        if (products.length > 0) {
          write('## 製品\n\n');
          
          // カテゴリ別にグループ化
          const categorized = products.reduce((acc: any, product: any) => {
            const cat = product.category || '未分類';
            if (!acc[cat]) acc[cat] = [];
            acc[cat].push(product);
            return acc;
          }, {});
          
          Object.entries(categorized).forEach(([category, items]: [string, any]) => {
            write(`### ${category}\n\n`);
            items.forEach((product: any) => {
              write(`- [${product.name}](${process.env.NEXT_PUBLIC_SITE_URL}/products/${product.slug})\n`);
            });
            write('\n');
          });
        }
        
        // APIドキュメントルート
        write('## APIドキュメント\n\n');
        write(`- [APIリファレンス](${process.env.NEXT_PUBLIC_SITE_URL}/docs/api)\n`);
        write(`- [認証ガイド](${process.env.NEXT_PUBLIC_SITE_URL}/docs/auth)\n`);
        write(`- [レート制限](${process.env.NEXT_PUBLIC_SITE_URL}/docs/limits)\n\n`);
        
      } catch (error) {
        write(`# 動的コンテンツ生成エラー: ${error}\n`);
      }
      
      controller.close();
    }
  });
  
  return new NextResponse(stream, {
    headers: {
      'Content-Type': 'text/plain; charset=utf-8',
      'Cache-Control': 'public, s-maxage=1800, stale-while-revalidate=3600',
      'X-Robots-Tag': 'noindex',
    },
  });
}

Next.js高度なパターン

インクリメンタル静的再生成(ISR)統合: fetchコールでrevalidate値を設定することで、ルートハンドラーとISRを組み合わせ、鮮度保証を維持しながらエッジキャッシングを可能にします。

並列データ取得: Promise.all()を使用して複数のコンテンツソースを同時に取得し、総生成時間を短縮します:

const [pages, posts, products] = await Promise.all([
  fetchPages(),
  fetchPosts(),
  fetchProducts()
]);

条件付きセクション: フィーチャーフラグまたは環境ベースの条件を実装して、ステージング環境と本番環境で異なるコンテンツ構造を公開します。

Shopifyでの動的llms.txt実装

Shopifyのアーキテクチャでは、ストアのセットアップに応じて異なるアプローチが必要です。プラットフォームのLiquidテンプレートエンジンとテーマ構造は、独自の課題と機会を提示します。

方法1: カスタムLiquidテンプレート

テーマに新しいページテンプレートを作成します:

{% comment %}
  ファイル: templates/page.llms.liquid
  Shopify管理画面でテンプレートサフィックス「llms」のページを作成
  アクセス: yourstore.com/pages/llms-txt
{% endcomment %}

{% layout none %}
{% content_for "content_type" %}text/plain{% endcontent_for %}

# llms.txt - {{ shop.name }}
# 生成日時: {{ "now" | date: "%Y-%m-%d %H:%M:%S %Z" }}
# ストアURL: {{ shop.url }}

## コレクション

{% for collection in collections %}
{% if collection.products_count > 0 %}
### {{ collection.title }} ({{ collection.products_count }}製品)

{% for product in collection.products limit: 20 %}
- [{{ product.title }}]({{ shop.url }}{{ product.url }}) - {{ product.price | money }}
{% endfor %}

{% endif %}
{% endfor %}

## ブログ記事

{% for article in blogs.news.articles %}
- [{{ article.title }}]({{ shop.url }}{{ article.url }}) - {{ article.published_at | date: "%Y-%m-%d" }}
{% endfor %}

## ページ

{% for page in pages %}
- [{{ page.title }}]({{ shop.url }}{{ page.url }})
{% endfor %}

方法2: Shopifyアプリプロキシ

エンタープライズShopify Plusストアの場合、サーバーサイドでllms.txtを生成するアプリプロキシを実装します:

  1. アプリプロキシの設定: Shopifyアプリ設定で、プロキシパスを/apps/llmsに設定し、サーバーエンドポイントを指定
  2. サーバー実装: Shopify Admin APIを使用して現在の在庫、コレクション、コンテンツを取得するNode.js/Python/Rubyエンドポイントを構築
  3. URLリライト: Shopify Scriptsまたはテーマ変更を使用して/llms.txtを/apps/llms/generateにリダイレクト
// Express.jsアプリプロキシハンドラー
app.get('/generate', async (req, res) => {
  const shopifyClient = new Shopify.Clients.Rest(
    req.query.shop,
    process.env.SHOPIFY_ACCESS_TOKEN
  );
  
  res.setHeader('Content-Type', 'text/plain');
  
  // コレクションを取得
  const collections = await shopifyClient.get({
    path: 'custom_collections',
  });
  
  let output = '# llms.txt\n\n## コレクション\n\n';
  
  for (const collection of collections.body.custom_collections) {
    const products = await shopifyClient.get({
      path: `collections/${collection.id}/products`,
      query: { limit: 50 }
    });
    
    output += `### ${collection.title}\n\n`;
    products.body.products.forEach(product => {
      output += `- [${product.title}](https://${req.query.shop}/products/${product.handle})\n`;
    });
    output += '\n';
  }
  
  res.send(output);
});

方法3: Shopify Hydrogen(ヘッドレス)

Hydrogenストアフロントの場合、Next.jsと同様のサーバールートを実装します:

// app/routes/llms[.]txt.tsx
import { LoaderFunction } from '@shopify/remix-oxygen';

export const loader: LoaderFunction = async ({ context }) => {
  const { storefront } = context;
  
  const { collections } = await storefront.query(`
    query LLMSData {
      collections(first: 50) {
        nodes {
          title
          handle
          products(first: 20) {
            nodes {
              title
              handle
            }
          }
        }
      }
    }
  `);
  
  let output = '# llms.txt\n\n';
  
  collections.nodes.forEach(collection => {
    output += `## ${collection.title}\n\n`;
    collection.products.nodes.forEach(product => {
      output += `- [${product.title}](/products/${product.handle})\n`;
    });
    output += '\n';
  });
  
  return new Response(output, {
    headers: {
      'Content-Type': 'text/plain',
      'Cache-Control': 'public, max-age=3600'
    }
  });
};

検証とテスト方法論

動的に生成されたllms.txtファイルが仕様要件を満たし、最適に機能することを保証するには、体系的な検証が必要です。

フォーマット検証チェックリスト

  • Markdown準拠: 適切な見出し階層を確認(タイトルにH1、セクションにH2、サブセクションにH3)
  • リンク整合性: すべてのURLは絶対パス、適切にエンコードされ、200ステータスコードを返す必要がある
  • 文字エンコーディング: 特殊文字、絵文字、国際テキストの適切な処理を伴うUTF-8エンコーディング
  • ファイルサイズの考慮: 最適なLLM処理のため10MB未満に保つ。大規模サイトではページネーションまたは要約を実装
  • 更新頻度インジケーター: 生成タイムスタンプと変更頻度のヒントを含める

自動テストスクリプト

import requests
import re
from urllib.parse import urlparse

def validate_llms_txt(url):
    """llms.txtのフォーマットとコンテンツを検証"""
    
    response = requests.get(url)
    
    # レスポンスヘッダーをチェック
    assert response.status_code == 200, "ファイルにアクセスできません"
    assert 'text/plain' in response.headers.get('Content-Type', ''), "コンテンツタイプが間違っています"
    
    content = response.text
    lines = content.split('\n')
    
    # 構造を検証
    assert lines[0].startswith('#'), "タイトルで始まる必要があります"
    
    # すべてのURLを抽出して検証
    url_pattern = r'\[([^\]]+)\]\(([^\)]+)\)'
    urls = re.findall(url_pattern, content)
    
    print(f"{len(urls)}個のリンクが見つかりました")
    
    # サンプル検証(最初の10リンクをチェック)
    for title, link in urls[:10]:
        parsed = urlparse(link)
        assert parsed.scheme in ['http', 'https'], f"無効なスキーム: {link}"
        assert parsed.netloc, f"ドメインが欠落: {link}"
        
        # オプション: リンクがアクセス可能かチェック
        try:
            link_response = requests.head(link, timeout=5, allow_redirects=True)
            assert link_response.status_code < 400, f"リンク切れ: {link}"
        except requests.RequestException as e:
            print(f"警告: {link}を検証できませんでした: {e}")
    
    # 必須セクションをチェック
    assert '##' in content, "セクションヘッダーが欠落しています"
    
    # ファイルサイズを検証
    size_mb = len(content.encode('utf-8')) / (1024 * 1024)
    assert size_mb < 10, f"ファイルが大きすぎます: {size_mb:.2f}MB"
    
    print("✓ 検証に合格しました")
    return True

# 使用方法
validate_llms_txt('https://yoursite.com/llms.txt')

パフォーマンス監視

動的生成がサイトパフォーマンスに影響を与えないよう、以下の監視戦略を実装します:

  • レスポンスタイム追跡: 生成時間が2秒を超える場合のアラートを設定
  • キャッシュヒット率監視: キャッシュされたレスポンスと再生成されたレスポンスの割合を追跡
  • エラー率ログ: 生成中の失敗したデータベースクエリまたはAPI呼び出しを監視
  • リソース使用率: ピーク生成期間中のCPUとメモリ使用量を測定

高度な最適化テクニック

条件付きコンテンツ公開

ユーザーエージェント、地理的位置、または認証ステータスに基づいてインテリジェントなフィルタリングを実装します:

// 条件付きセクションを持つNext.jsの例
export async function GET(request: NextRequest) {
  const userAgent = request.headers.get('user-agent') || '';
  const isGoogleBot = userAgent.includes('Googlebot');
  const isLLMCrawler = userAgent.includes('GPTBot') || userAgent.includes('Claude');
  
  // クローラータイプに基づいて異なるコンテンツ深度を公開
  const maxItems = isLLMCrawler ? 1000 : isGoogleBot ? 500 : 100;
  
  // 適切な制限でコンテンツを生成
}

階層的優先順位付け

優先度インジケーターを使用して、高価値ページを最初に提示するようコンテンツを構造化します:

## 高優先度コンテンツ

- [製品ローンチ2024](/launch) - 優先度: 高、更新日: 2024-01-15
- [ドキュメントホーム](/docs) - 優先度: 高、更新日: 2024-01-10

## 標準コンテンツ

- [ブログアーカイブ](/blog) - 優先度: 中

多言語サポート

国際サイトの場合、言語固有のllms.txtバリアントを生成します:

// WordPress多言語の例
function serve_dynamic_llms_txt() {
    $lang = isset($_GET['lang']) ? sanitize_text_field($_GET['lang']) : 'en';
    
    if ($lang !== 'en') {
        // ローカライズ版を生成
        $posts = get_posts(array(
            'lang' => $lang,
            'numberposts' => 50
        ));
    }
    
    echo "# llms.txt ({$lang})\n\n";
    // ... 残りの生成
}

セキュリティ考慮事項

動的生成は、対処すべき潜在的なセキュリティベクトルを導入します:

  • レート制限: リソース枯渇攻撃を防ぐためにリクエストスロットリングを実装(例: IPあたり1時間に60リクエスト)
  • 入力サニタイゼーション: インジェクション攻撃を防ぐためにすべての動的コンテンツを検証およびエスケープ
  • 認証バイパス防止: ページ自体が保護されている場合でも、llms.txtにプライベートコンテンツのURLを公開しない
  • 情報開示: 内部システムパス、APIエンドポイント、機密メタデータの公開を避ける
  • DDoS緩和: CDNレベルの保護を使用し、上流サービス障害のためのサーキットブレーカーを実装

メンテナンスと監視のベストプラクティス

長期的な信頼性を確保するための運用手順を確立します:

  1. CI/CDでの自動テスト: デプロイメントパイプラインにllms.txt検証を含める
  2. テンプレートのバージョン管理: 詳細なコミットメッセージで生成ロジックの変更を追跡
  3. アラートしきい値: 生成失敗、パフォーマンス低下、またはフォーマット違反の通知を設定
  4. 定期監査: 含まれるコンテンツ、リンク切れ、構造的正確性の月次レビュー
  5. ドキュメント: 一般的な問題のトラブルシューティングと生成ロジックの更新のためのランブックを維持

まとめ

動的llms.txt生成は、静的ファイルをサイトの現在の状態を正確に表す生きたドキュメントに変換します。WordPress、Next.js、Shopify向けのプラットフォーム固有のソリューションを実装することで、AIエージェントが常にコンテンツアーキテクチャに関する権威ある最新情報を受け取ることを保証します。動的生成への投資は、AI発見可能性の向上、メンテナンス負担の軽減、デジタル資産のセマンティック理解の強化を通じて配当をもたらします。LLM駆動の検索および発見ツールがますます普及するにつれて、動的llms.txtファイルは競争上の優位性から本格的なWebプロパティの基本要件へと移行するでしょう。