Docs

AGENTS.md や CLAUDE.md には、どの SEO ルールを書けばよいですか？

新しいページごとに、確認できる短いルールを書きます。質問は一つ、H1 も一つ。タイトルと説明文は一意にし、正規 URL と hreflang を設定します。本文はサーバー側で描画し、JSON-LD は表示された本文と一致させます。ルールはエージェントを導くもので、公開されたページが正しいことは証明しません。

ファクト

ルールはどちらのファイルに書くべきですか？ AGENTS.md か CLAUDE.md か？

同じリポジトリで複数のコーディングエージェントが作業する場合は AGENTS.md を使ってください。Codex と Cursor はそれを読み、Claude Code もそれを読むか取り込みます。Claude だけに向けたメモは CLAUDE.md に残し、共通のルールも Claude が読めるように取り込みの行を入れてください。

# CLAUDE.md
@AGENTS.md

どのルールをコピーすればよいですか？

これらのルールは短く、具体的で、確認できるものです。エージェントの公式ドキュメントが勧める形式でもあります。ファイルのセクションとして貼り付けてください。

## SEO rules for new pages

- Only add new content pages. Never change the home page or a page that already works.
- One question per page. The H1 is that question; the first paragraph answers it.
- Unique <title> (up to 60 characters) and meta description (70 to 165).
- Self-referencing rel="canonical" on every page.
- Each language version links the others with hreflang; canonical stays in its own language.
- The text is in the server-rendered HTML, not loaded only by JavaScript.
- JSON-LD describes only what the page visibly says.
- Every number or date in a fact links to the source that states it. Invent nothing.
- Add the page to the sitemap and link to it from a related page.
- A page is done when it is checked on the live URL, not when the build passes.

それぞれのルールの理由は？

各ルールは、ページが失敗する既知のパターンに対応しています。

ルール理由
すべてのページに正規 URLGoogle は rel=canonical を強いシグナルとして扱い、サイトマップは弱いシグナルとしてしか扱いません
言語間の hreflangGoogle は、言語版に hreflang の代替を使い、同じ言語の正規 URL を用います
サーバー側で描画された本文JavaScript を実行しないクローラーには、そうしないと空のページに見えます
JSON-LD を表示されている本文と一致させるGoogle の構造化データのガイドラインは、非表示の内容のマークアップを禁止しています
機能しているページには触れない書き換えによって、そのページがすでに得ている訪問を失うことがあります

ルールでは何を保証できませんか？

ルールは、公開された結果を保証できません。Claude Code の公式ドキュメントも、このファイルは強制される設定ではなく文脈だと述べています。デプロイの失敗、誤った正規 URL、空に描画されるページは、公開中の URL でだけ分かります。そのため、各ページをそこで確認し、Search Console でインデックス登録を見てください。

ステップごとの手順

  1. ファイルを選ぶ. リポジトリのルートに AGENTS.md を置きます。CLAUDE.md を使う場合は、@AGENTS.md を追加します。
  2. ルールを貼り付ける. ルールのブロックをコピーし、パスと言語を御社のサイトに合わせて調整します。
  3. 短く保つ. 200 行を大きく下回るようにします。一つのフォルダだけのルールは、入れ子のファイルに移します。
  4. 公開中の状態を確認する. デプロイのたびに新しい URL を開き、タイトル、正規 URL、本文、JSON-LD を確認します。

よくある間違い

  • 「SEO のベストプラクティスに従う」といった曖昧なルールを書き、エージェントが確認できないこと。
  • CLAUDE.md と AGENTS.md の両方を置き、取り込みをしないため Claude Code が共通のルールを読まないこと。
  • 長い SEO マニュアルを貼り付け、重要なルールを埋もれさせること。
  • ルールのファイルを、公開されたページが正しいという証拠だと考えること。

easyIndex での解決方法

easyIndex は、ページのルールを MCP 経由で一ステップずつコーディングエージェントに渡します。提出されたページを監査し、公開後は公開中のサイトで確認します。ステップは、エージェントの報告ではなく、easyIndex が確認した証拠によってのみ完了します。

御社のサイトやリポジトリを変更することはありません。Claude Code、Codex、Cursor、その他の MCP クライアントと連携し、7日間の無料トライアルの後、1サイトあたり月額 US$30です。

よくある質問

Claude Code は AGENTS.md を読みますか？

はい。v2.1.277 以降で、CLAUDE.md がない場合に読みます。CLAUDE.md がある場合は、@AGENTS.md という行を追加すると取り込まれます。

これらのルールで、ChatGPT に御社のサイトが引用されますか？

どのルールもそれを約束できません。ルールはページを分かりやすく、クロールできるものにします。引用するかどうかは ChatGPT が決めます。

ルールに llms.txt も加えるべきですか？

任意です。まずはサーバー側で描画されたページ、正規 URL、サイトマップが大切です。

サブフォルダに独自のルールを持たせられますか？

はい。エージェントはディレクトリ ツリーの中で最も近い AGENTS.md を読むため、入れ子のファイルにそのフォルダ用のルールを書けます。

続きを読む

最終確認日 .

AGENTS.md や CLAUDE.md に書く SEO ルール