トラブルシューティング

Kashiwazaki SEO LLMs.txt Generator の使用中に発生しうる問題と対処法、動作要件、技術仕様について解説します。

よくある問題と対処法

/llms.txt にアクセスすると404エラーになる

考えられる原因 対処法
リライトルールが生成されていない WordPress管理画面の 設定 > パーマリンク を開いて「変更を保存」をクリックしてください。リライトルールが再生成されます。
プラグインが有効化されていない 管理画面の「プラグイン」一覧で、本プラグインが有効になっていることを確認してください。
.htaccessの書き込み権限がない サーバーの .htaccess ファイルにWordPressが書き込めることを確認してください。Nginx環境の場合は、リライトルールを手動で設定する必要があります。

llms.txtの内容が空になる

考えられる原因 対処法
含有する投稿タイプが選択されていない 設定画面で少なくとも1つの投稿タイプ（post、pageなど）を含有対象に設定してください。
公開済みの投稿が存在しない 選択した投稿タイプに公開ステータスの投稿があることを確認してください。
キャッシュが古い状態になっている 設定画面の「キャッシュクリア」ボタンをクリックして、キャッシュを再生成してください。

link rel="alternate" メタタグが出力されない

考えられる原因 対処法
テーマが wp_head() を呼び出していない テーマの header.php に <?php wp_head(); ?> が記述されていることを確認してください。
他のプラグインとの競合 他のプラグインを一時的に無効化し、メタタグが出力されるか確認してください。

AJAX操作でエラーが発生する

考えられる原因 対処法
nonce検証の失敗 ページを再読み込みしてから再度操作してください。セッションが切れている可能性があります。
権限が不足している 管理者（manage_options権限を持つユーザー）でログインしていることを確認してください。
ヒント

問題が解決しない場合は、一度プラグインを無効化してから再有効化してみてください。設定値はデータベースに保持されるため、再有効化後も設定は維持されます。

動作要件

項目 要件
WordPress 5.0 以上
PHP 7.4 以上
対応ブラウザ Chrome、Firefox、Safari、Edge（最新版）

技術仕様

アーキテクチャ

Kashiwazaki SEO LLMs.txt Generator は以下のコンポーネントで構成されています。

フロントエンド出力

バックエンド

llms.txt生成フロー

1

AIクローラーまたはブラウザが /llms.txt または /llms-full.txt にリクエストを送信します。

2

WordPressのリライトルールがリクエストをプラグインのハンドラーに転送します。

3

プラグインがYAMLヘッダー（ライセンス、レート制限、リトライポリシー、許可ボットリスト）を生成します。

4

設定に基づいて投稿タイプごとのコンテンツ情報を収集し、テキスト形式で出力します。

補足

カスタムテーブルやCronイベントは使用しないため、プラグインの削除時にデータベースに不要なデータが残ることはありません。wp_options の設定値のみが削除対象です。