JSON-LDとは？HTML共有・AI生成サイトでの意味をやさしく解説

ひとことで言うと

JSON-LD（JavaScript Object Notation for Linked Data）は、Schema.orgが定めた語彙を使ってページの種類・名前・作者・日付などを記述するデータ形式です。<script type="application/ld+json">タグの中にJSONオブジェクトを書くだけで機能するため、既存のHTMLタグに属性を追加する必要がありません。GoogleはJSON-LDを最も推奨する実装方式として公式ドキュメントに明記しています。

最小構成は「@contextにhttps://schema.org、@typeにWebPage、nameにページタイトル」の3行程度です。AIツールで生成したHTMLには既にこのブロックが含まれている場合があり、その中身が正確かどうかをリッチリザルトテストで確認するのが最初のステップになります。

• 相手がログインなしで開ける状態か確認する
• PCとスマホで最低1回ずつ表示を確認する
• 内部情報・個人情報・不要な外部送信が残っていないか見る
• レビュー期限と修正時の差し替え方を決めておく

HTML共有で関係する場面

Claudeやv0などのAIツールで生成したLPや提案資料HTMLを、ギガサイト便のようなサービスでURLとして外部共有する場合、JSON-LDに記述した「datePublished（公開日）」「author（作成者）」「description（概要）」がGoogleのインデックスに取り込まれます。後日Googleで社名や製品名を検索したときに正しい情報が表示されるかどうかに直結します。

メール本文にHTMLファイルを添付するのではなくURLで共有する方式では、受け取った側のブラウザがページをそのままレンダリングします。このとき<title>タグと並んでJSON-LDのnameフィールドがブラウザのタブ名に影響するブラウザはまれですが、Slackのリンクプレビューはdescriptionフィールドを参照するため、JSON-LDのdescriptionとOGPのog:descriptionを一致させておくのが安全です。

よくある誤解

「JSON-LDはJavaScriptなので動的サイトにしか使えない」という誤解があります。実際には静的HTMLファイルに直接埋め込むテキストデータであり、JavaScriptエンジンで実行される処理ではありません。サーバーもNode.jsも不要で、メモ帳で編集したHTMLに貼り付けても同様に機能します。

「JSON-LDを書くとページ速度が落ちる」という心配もよく聞きますが、<script type="application/ld+json">はブラウザがJSとして評価・実行しないため、レンダリングをブロックしません。数百バイト〜数キロバイトのテキストが増えるだけで、PageSpeedスコアへの実質的な影響はほぼゼロです。

安全に使うための注意点

JSON-LDの中に内部システムURLやAPIエンドポイントを記述しないよう注意してください。たとえばSameAs（同一エンティティの別URL）に社内Confluenceや認証が必要なダッシュボードURLを書くと、ソースを見た外部の人にURLが漏れます。公開可能なプロフィールページや公式SNSアカウントのURLのみ記載しましょう。

AIツールが自動生成したJSON-LDには、@typeがWebPageだけで具体的なスキーマ型（Article、ProductなどE）が設定されていないことがあります。型が曖昧だとGoogleがリッチリザルトを表示しません。公開前にSearch Consoleのリッチリザルトテストで「検出された構造化データ」を確認し、意図した@typeが認識されているか検証してください。