# JSON-LD 入門 — Web の意味を機械に渡す構造化データ > JSON-LD とは何か（Linked Data と RDF グラフ、@context / @id / @type の役割）を具体例で解説し、Web でどう使われているか——検索のリッチリザルト、Microdata / RDFa との比較、@id で結ぶ Site-wide / Page-level 設計、よくあるエラーと検証ツール——までを一気に押さえます。最後に、このサイト自身が JSON-LD をどう実装しているかを実例として開きます。 - 出典: SUZ-LAB（解説トピック） - URL: https://suz-lab.co.jp/topics/json-ld-structured-data - 公開: 2026-07-06 - 更新: 2026-07-06 - タグ: #JSON-LD #構造化データ #SEO #Schema.org #Next.js #Web --- Web には人間向けの見た目（HTML＋CSS）と、機械向けの意味（構造化データ）の 2 つの層がある。後者を担う事実上の標準が **JSON-LD**（JavaScript Object Notation for Linked Data）だ。検索エンジンのリッチリザルト、ナレッジグラフ、SNS のカード、AI エージェントのデータ取得—— どれも「そのページが何について書かれているか」を機械可読で受け取れることが前提になっている。この記事は、JSON-LD の**仕組み**（何を表しているのか）と、Web での**使われ方** （どこに置き、何を得るのか）を具体例で解説する。最後に、**このサイト自身**が JSON-LD をどう出しているかを開き、机上の理論ではなく動いている実装として見せる。 ## JSON-LD とは — 「JSON のまま」意味を足すセマンティック Web／Linked Data の狙いは、バラバラのサイトに散る情報を、標準化された識別子でつなぎ、機械がリンクをたどって新しいデータを発見できるようにすることだ。初期の XML ベースの記法は表現力は高かったが、開発者には重すぎて普及しなかった。そこで **今日の Web で当たり前になった JSON の書き味そのままに、高度な意味づけを載せられる** シリアライズ形式として設計されたのが JSON-LD で、2020 年 7 月に W3C 勧告「JSON-LD 1.1」が出ている。 JSON-LD が表すのは **方向を持つラベル付きの有向グラフ**だ。 - **ノード**（主語・目的語）＝リソース（組織・記事・人など） - **エッジ**（述語）＝リソース間の関係（`publisher`、`author` など）主語・述語・目的語をすべて **IRI**（国際化された URI）でラベル付けするので、名前の衝突なく、分散した Web スケールで情報を結合できる。JSON-LD ドキュメントは、このグラフを木構造の JSON にマッピングしたものだ、と捉えるとよい。 ### 最小の例 ```json ``` `@` で始まる **キーワード**が意味の骨格を決める。主要なものは次の通り。 | キーワード | 役割 | | --- | --- | | `@context` | 各キーを Schema.org 等の語彙（IRI）へ紐付ける「辞書」。外部ファイルも参照できる | | `@type` | オブジェクトの型（`Organization`・`TechArticle` など）や値のデータ型 | | `@id` | そのノードを一意に識別する URI。**別ブロックからの参照キーにもなる**（後述） | | `@graph` | 複数の独立ノードをまとめる入れ物。名前付きグラフの識別にも使う | | `@value` / `@language` | 値に言語やデータ型を紐付ける「値オブジェクト」を作る（BCP 47 準拠） | | `@vocab` / `@base` | 既定の語彙 URI と、相対 URI を解決する基準 IRI | `@type` の `type`、`@id` の `id` のように、`@context` でエイリアスを張ればアットマーク無しでも書ける。

W3C のベストプラクティスが繰り返し強調するのは「開発者フレンドリーな JSON」であること。その上で、RDF グラフに変換される都合から来る 2 つの落とし穴に注意する。 - **配列は既定で「順不同（Set）」**。JSON の配列は順序を持つが、RDF は順不同のトリプル集合として扱うため、変換時に順序が消える。順序が意味を持つなら `@context` で `"@container": "@list"` を宣言して `rdf:List` だと解釈させる。 - **数値の精度欠損**。多くの言語は数値を IEEE 754 倍精度で扱うので、大きな整数や精密な小数は往復で誤差が出る。金融・学術など厳密な値は、あえて文字列で包み `@type` で `xsd:decimal` / `xsd:integer` へ**型強制（Type Coercion）**するのが定石。 - **文字列ではなく「実体」で書く**。プロパティ値に名前の文字列を置くのではなく、`@type` と `@id` を持つオブジェクトにして実体化する。双方向・循環参照は、一方はネスト・逆方向は `@id` 参照だけ、にして無限ループを避ける。

## Web での使われ方① — 3 つの構造化データ方式 HTML に構造化データを埋める規格は歴史的に 3 つある。**JSON-LD が支配的**な理由は設計思想にある。 | 観点 | JSON-LD | Microdata | RDFa | | --- | --- | --- | --- | | 書き方 | `