Claude CodeやCodexで、サイトに構造化データ(JSON-LD)を追加するにはどうすればよいですか?
エージェントには、各ページが表示しているのと同じデータから、テンプレートにJSON-LDを生成させてください。読者に見える型と値だけを使い、サーバー側で描画させます。そのルールをCLAUDE.mdまたはAGENTS.mdに書けば、新しいページすべてに適用されます。そのうえで、コードではなく、公開されたURLをGoogleのリッチリザルト テストで確認してください。
ファクト
- Googleは、サイトの構成が許すなら、サポートする3つの構造化データ形式のうち JSON-LD を推奨しています。 (Google Search Central:構造化データのマークアップ入門)
- Googleのガイドラインは、読者に見えないコンテンツをマークアップしないよう求めています。必須のプロパティがない項目は、リッチリザルトの対象になりません。 (Google Search Central:構造化データの一般ガイドライン)
- Googleは、AI による概要やAI モードに表示されるために特別な schema.org のマークアップは不要だとし、構造化データは見えているテキストと一致させるべきだとしています。 (Google Search Central: AI features and your website)
- Organization のマークアップはトップページか会社概要の1ページに置きます。必須のプロパティはなく、ロゴは少なくとも112×112ピクセル必要です。 (Google Search Central:Organization の構造化データ)
- Claude Codeは、毎回のセッションでプロジェクトの CLAUDE.md を読み込みます。これに加えて、最大200行または25KBまでの自動メモリがあります。 (Claude Code ドキュメント:Claude がプロジェクトを記憶する仕組み)
- Codexは、作業を始める前に AGENTS.md を読みます。既定では、結合された指示ファイルは32 KiBまでです。 (OpenAI Codex ドキュメント:AGENTS.md によるカスタム指示)
エージェントにはどの種類の構造化データを追加させるべきですか?
各ページが表示している内容に合う種類だけを依頼してください:
| ページ | 構造化データの種類 | 主なプロパティ |
|---|---|---|
| トップページまたは会社概要 | Organization(またはLocalBusiness) | name、url、logo、sameAs |
| ガイドやブログ記事 | Article | headline、author、datePublished、dateModified、publisher |
| 商品ページ | Product | name、ページに表示されている価格を持つ offers |
| 見えている質問と回答があるページ | FAQPage | ページに印刷されている質問だけ |
Claude CodeやCodexには、どのようなプロンプトを渡せばよいですか?
すべてのテンプレートに適用できる、1つのルールセットを渡してください。作り出された値を禁止する条件もつけます:
Add JSON-LD structured data to this site. - Build it in the page templates from the same data the page renders. Never hardcode a value the page does not show. - Organization (name, url, logo, sameAs) on the home page only. - Article on guides and blog posts: headline, author, datePublished, dateModified (the real last change), publisher = the Organization. - Product, LocalBusiness or FAQPage only where that content is visible. - If a value is unknown, leave the property out. Do not invent it. - Render it on the server, in a <script type="application/ld+json">. - List every page you changed and the types each one now carries.
新しいページにも構造化データが付くように、ルールはどこに書けばよいですか?
エージェントが自動で読み込む指示ファイルに書いてください。Claude Codeは、各セッションの開始時に ./CLAUDE.md または ./.claude/CLAUDE.md を読みます。/init で最初のバージョンを作れます。Codexは、作業を始める前にプロジェクトのルートにある AGENTS.md を読みます。そこに短いルールを書いておけば、エージェントが次に書くページも前のページと一貫します。
エージェントが何も作り上げていないことを、どう確認しますか?
公開されたURLをリッチリザルト テストで確認し、各値を読者に見えているページと照らし合わせてください。URLのテストはページのJavaScriptを実行しますが、貼り付けたコードでは実行されません。そのうえで、Search Consoleの URL検査 で、Googleがマークアップを見つけたことを確認します。テストが通るのは構文だけです。値を確かめるのは、あなたの仕事です。
構造化データを付ければ、ChatGPTやGoogleのAIにサイトを引用させられますか?
それだけでは無理です。Googleは、AI による概要とAI モードには特別なスキーマは不要だとしており、有効なマークアップがリッチリザルトになることも保証していません。正しいJSON-LDは、検索エンジンが自分が何者で、そのページが何であるかを読み取るのに役立ちます。引用されるのは、やはりページ上の回答です。
ステップごとの手順
- ページの種類を書き出す. トップページ、会社概要、ガイド、商品。それぞれに1つの構造化データの種類を決めます。
- エージェントにプロンプトを渡す. ページ自身のデータからテンプレートにJSON-LDを作らせ、値は捏造しないよう指示します。
- ルールを保存する. CLAUDE.md か AGENTS.md に追加し、今後のページがそれに従うようにします。
- 差分を確認してデプロイする. 値がページのデータから来ているか、テキストとしてハードコードされていないかを確認します。
- 公開URLをテストする. 公開されたページでリッチリザルト テストを実行し、続けて Search Console の URL検査 を行います。
よくある間違い
- 評価、価格、著者など、ページに表示されていない値をエージェントに埋めさせること。
- ページに印刷されていない質問に対して FAQPage のマークアップを付けること。
- 公開されたURLではなく、貼り付けたコードをテストすること。JavaScriptが描画する内容を見逃します。
- dateModified を、内容が変わったときではなく、ビルドのたびに設定すること。
easyIndex での解決方法
easyIndexはサイトを一切変更しません。ページと構造化データを書くのはコーディングエージェントです。easyIndexは、送信時に各ページを監査し、公開後に公開中のサイトで再確認します。JSON-LDがあるか、実際の更新日が入っているかも含めてです。ステップは、エージェントの報告ではなく、その証拠によって完了します。
よくある質問
JSON-LD、Microdata、RDFaのどれがよいですか?
JSON-LDです。Googleは3つすべてをサポートし、サイトの構成が許すならJSON-LDを推奨しています。
エージェントは、JavaScriptでJSON-LDを挿入してもよいですか?
Googleは描画後に存在するJSON-LDも処理しますが、JavaScriptを実行しないクローラーのためには、サーバーで描画されたマークアップのほうが安全です。
Organizationは、すべてのページに付けるべきですか?
Googleは、トップページまたは組織について書かれた1ページに付けることを求めています。他のページは、publisher としてそれを参照できます。
Cursorなどのほかのエージェントでも同じように機能しますか?
はい。テンプレートを編集するエージェントなら、どれでも同じプロンプトに従えます。変わるのは指示ファイルの名前だけです。
続きを読む
- 構造化データ(スキーマ)は AI に自社サイトを引用してもらうのに役立ちますか?
- AGENTS.md や CLAUDE.md には、どの SEO ルールを書けばよいですか?
- Claude Code で技術 SEO と AI 可視性の監査を行うには、どうすればよいですか?
- ChatGPT や Claude は、JavaScript で作られた私のサイトを読めますか?
- Claude Code や Codex で GEO を行うには、どうすればよいですか?
- easyIndex はどのように機能しますか。何が必要で、結果が出るまでどのくらいですか?
最終確認日 .