Claude CodeやCodexで、サイトに構造化データ(JSON-LD)を追加するにはどうすればよいですか?

エージェントには、各ページが表示しているのと同じデータから、テンプレートにJSON-LDを生成させてください。読者に見える型と値だけを使い、サーバー側で描画させます。そのルールをCLAUDE.mdまたはAGENTS.mdに書けば、新しいページすべてに適用されます。そのうえで、コードではなく、公開されたURLをGoogleのリッチリザルト テストで確認してください。

ファクト

エージェントにはどの種類の構造化データを追加させるべきですか?

各ページが表示している内容に合う種類だけを依頼してください:

ページ構造化データの種類主なプロパティ
トップページまたは会社概要Organization(またはLocalBusiness)name、url、logo、sameAs
ガイドやブログ記事Articleheadline、author、datePublished、dateModified、publisher
商品ページProductname、ページに表示されている価格を持つ 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. ページの種類を書き出す. トップページ、会社概要、ガイド、商品。それぞれに1つの構造化データの種類を決めます。
  2. エージェントにプロンプトを渡す. ページ自身のデータからテンプレートにJSON-LDを作らせ、値は捏造しないよう指示します。
  3. ルールを保存する. CLAUDE.md か AGENTS.md に追加し、今後のページがそれに従うようにします。
  4. 差分を確認してデプロイする. 値がページのデータから来ているか、テキストとしてハードコードされていないかを確認します。
  5. 公開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などのほかのエージェントでも同じように機能しますか?

はい。テンプレートを編集するエージェントなら、どれでも同じプロンプトに従えます。変わるのは指示ファイルの名前だけです。

続きを読む

最終確認日 .

Claude CodeやCodexで構造化データ(JSON-LD)を追加する