AI活用 FI WEB COLUMN

AIでホームページの構造化データを作るには?

コードはAIで下書きし、事実と公開結果は人が確かめる。

AIでJSON-LDの下書きを作り、人がページの事実、種類、項目、公開HTMLを確認する手順を解説します。入力資料、生成条件、検証ツール、公開後の保守までを整理します。

公開 更新 読む目安 約8分
WEBページと構造化データのコード、検証結果をモニターで照合するWEB技術者
AIで作ったコードをそのまま公開せず、ページ表示と検証結果を一つずつ見比べます。
最初に押さえたいこと

ページの事実から作り、公開HTMLまで照合する。

AIで構造化データを作るときは、先に公開ページの事実と使う種類を決め、AIには確認済みの値だけでJSON-LDの下書きを作らせます。そのまま公開せず、人が種類ごとの要件、表示本文との一致、URL・日付・画像を照合し、構文検査と公開URLの検証を行います。本文が変わった後も構造化データを更新する運用まで決めます。

01 / 事実と正本を整理

AIへ頼む前に、ページで確認できる事実を表にする

構造化データは、ページに書かれていない情報を検索やAIへ追加で知らせるための裏口ではありません。まず、ページの主題、運営者、サービス名、公開日、更新日、著者、画像、パンくずなど、閲覧者がページ上で確認できる事実を一覧にします。会社資料や担当者の記憶だけにある情報は、本文へ掲載するか、構造化データには使わないかを決めます。

見える事実から、公開HTMLまで照合する

ページで確認できる事実を起点にし、AIの下書き、担当者の照合、公開後の検証を分けて進めます。

見える事実:本文・URL・日付。AIの下書き:JSON-LD・対応表。人の検証:種類・値・公開結果。

一覧には、項目名、確定した値、掲載されているページ、確認した担当、確認日、情報の正本を記録します。AIへ渡す資料もこの表に限定し、「空欄を推測しない」「存在しない実績・評価・価格を足さない」「不明は不明と返す」と条件を付けます。顧客情報や非公開情報を外部のAIサービスへ入力できるかも先に確認します。

ノートパソコンとスマートフォンで会社ページの表示内容を照合するホームページ運営担当者
AIへ渡す前に、会社・サービスの名称やURLを利用者が見えるページで確かめます。

同じ会社名や住所でも、表記、URL、ロゴ、問い合わせ先がページごとに違うと、AIはもっともらしい一つの値へまとめることがあります。先にホームページの表示を統一し、構造化データだけを正しい状態にしないことが大切です。

  • ページ上で確認できる事実
  • 正本・担当・確認日
  • AIへ渡してよい情報
  • 推測・補完を禁止する条件
02 / 種類を選んで下書き

ページの役割に合う種類を選び、AIには下書きだけを任せる

次に、そのページが何を扱うかに合わせて構造化データの種類を選びます。会社の公式情報、記事、パンくず、商品、イベントなどでは、使う種類と必要な項目が異なります。検索結果へ表示したい見た目から逆算して、内容と合わない種類を当てはめてはいけません。Googleの対象機能を狙う場合は、schema.orgの一覧だけでなく、Google Search Centralにある該当種類の要件を確認します。

ページの事実整理、AIによるJSON-LD下書き、人による照合、公開HTML検証、保守の順で進める構造化データ制作図

AIはコードの下書きに使い、種類・項目・値・公開結果は人がページ本文と一次情報へ照合します。

図解を別タブで開く

AIへの依頼には、使う種類、確認済みの事実表、ページURL、実装方式、出力形式を明示します。JSON-LDだけをコードブロックで返す、空欄を作らない、確認できない項目は追加しない、URLは与えた値だけを使う、といった制約を付けます。出力と一緒に「どの入力値を、どのプロパティへ対応させたか」の対応表も作らせると、人が確認しやすくなります。

AIの出力は、構文が整っていても内容まで正しいとは限りません。存在しないsameAs、推測した価格、画像ではないURL、未来の日付、別ページの情報を混ぜることがあります。コードの見た目ではなく、一項目ずつ入力資料へ戻って確認します。

  1. ページの主題に合う種類
  2. Googleの種類別要件
  3. JSON-LDと対応表の出力
  4. 不明な項目を追加しない
03 / 人が項目と値を照合

人が、種類・項目・値をページ本文と照合する

確認は、種類、必要な項目、推奨項目、値の順に行います。種類がページの主な内容を表しているか、必須項目が欠けていないか、値の型が文字列・URL・日付・配列などの指定に合っているかを確認します。推奨項目は数を埋めるより、正確で完全な値だけを使う方を優先します。

Googleの一般ガイドラインでは、構造化データがページの主な内容を代表し、利用者に見える内容と一致することが求められます。本文にない評価、非表示のFAQ、申し込めない商品、終了したイベントを残していないかを確かめます。正しい構文でも、誤解を招く内容なら公開しません。

URL、canonical、画像、著者、公開日・更新日は特に差が出やすい項目です。相対URL、テスト用URL、旧ドメイン、アクセスできない画像が混ざっていないか、日付を作業日に機械的に置き換えていないかを確認します。サイト共通のOrganization情報を変更する場合は、TOPや会社情報など利用ページへの影響も見ます。

  • 種類とページ主題の一致
  • 必須・推奨項目と値の型
  • 見える本文との一致
  • URL・画像・日付の正確さ
04 / 公開URLを検証

構文だけで終わらせず、公開URLと生成HTMLを検証する

公開前は、JSONとして解析できるか、同じプロパティの重複や引用符の崩れがないかを検査します。Googleのリッチリザルト対象ならRich Results Testで種類、エラー、警告を確認します。対象外の種類は、ツールに表示されないこと自体を誤りとせず、生成されたHTMLにJSON-LDがあり、schema.orgの仕様と目的に合うかを別に確認します。

JavaScriptで動的に挿入する場合は、ソースファイルだけでなく、実際に描画されたDOMに構造化データが現れるかを確認します。GoogleはJavaScriptで追加された構造化データも処理できますが、表示本文と別の管理画面へ値を重複入力すると不一致の原因になります。可能ならページで使う同じデータから生成します。

モニターの公開ページと構造化データ検証結果、スマートフォン表示を照合するWEB技術者
公開URLの表示、JSON-LD、検証結果、スマートフォン表示を同じ版で確認します。

公開後は、URL入力で再検証し、HTTP応答、canonical、robots、noindex、JSON-LD、画像URLまで確認します。テストに合格してもリッチリザルトの表示は保証されません。検査結果は「構文が有効」「対象機能の条件を満たす」「実際に検索結果へ表示された」を分けて記録します。

  • JSON構文と重複の検査
  • 種類に合う検証手段
  • 描画後のHTMLとDOM
  • 公開URL・設定・画像の再確認
05 / 本文と一緒に保守

本文の更新と一緒に、構造化データも保守する

構造化データは公開時に一度入れて終わりではありません。会社情報、料金、イベント日、著者、画像、記事本文、FAQが変わったときは、対応する値も更新します。表示本文だけ直してJSON-LDが古いまま残ると、利用者に見える情報との不一致が生まれます。

更新ルールには、変更の起点、対象ページ、確認担当、公開前テスト、公開後確認、異常時の戻し方を含めます。テンプレート変更では代表ページだけでなく、同じテンプレートを使う全件を機械検査し、例外ページを人が確認します。Search Consoleのリッチリザルトレポートで、公開後に増えたエラーや警告も継続して見ます。

AIを使う価値は、項目候補やコード形式の整理を速くすることにあります。事実の責任、種類の判断、公開条件、検証結果は人が持ちます。構造化データを増やせば検索順位やAI回答への掲載が保証されるわけではなく、正確な本文、取得できるHTML、内部リンク、運営者情報と一緒に整えることが基本です。

  1. 本文変更と同時に更新
  2. 担当・検査・復旧のルール
  3. テンプレート全件と例外の確認
  4. 検索・AI掲載を保証しない

FAQ

よくある質問

ページURLをAIへ渡せば、構造化データを自動で作れますか?

下書きは作れますが、AIがページを取得できる範囲、情報の鮮度、非表示の条件を正確に判断できるとは限りません。確認済みの事実表と使う種類を渡し、生成後は各項目を本文と一次情報へ照合します。

JSON-LDなら、どのページにも同じコードを入れてよいですか?

共通のOrganization情報など再利用できる部分はありますが、Article、Product、Eventなどページ固有の種類と値を同じコードへ置き換えることはできません。各ページの主題と表示内容に合わせます。

推奨項目は多いほど効果がありますか?

項目数だけを増やす必要はありません。Google Search Centralも、不完全・不正確な値を広く入れるより、正確で完全な推奨項目を使うことを重視しています。確認できる値だけを設定します。

Rich Results Testに合格すれば、検索結果へ必ず表示されますか?

表示は保証されません。合格は主に構文や対象機能への適合を確認する結果です。ページ品質、検索状況、ガイドラインなどによって、通常の検索結果が選ばれることもあります。

参考にした一次情報

本記事の確認に用いた公式資料です。適用条件は、各参照先の説明もご確認ください。

編集・発信株式会社ファーストイノベーション

FI WEB|ホームページ制作・SEO・AIO

FROM CONTENTS TO WEBSITE

事業の魅力が伝わる、ホームページへ。

現在のページ、表示している会社・サービス情報、実装済みの構造化データを照合し、種類・値・公開HTML・更新方法まで一緒に整理します。