個人サイト向けJSON-LD解説ガイド
原題: JSON-LD Explained for Personal Websites
なぜ重要か
検索エンジン最適化やLLMによるコンテンツ理解向上に欠かせないJSON-LD実装方法を実践的に解説。個人サイト運営者の検索可視性向上に貢献する知見。
個人ウェブサイト運営者向けにJSON-LD（JSON Linked Data）の実装方法を解説した技術記事。Schema.orgに準拠した構造化データをHTMLのheadセクションに追加することで、検索エンジンのクローラーがサイト構造を理解しやすくなり、検索順位向上やリッチプレビュー表示につながる可能性があると説明している。
記事は個人サイト構築後の改善事例を基に、JSON-LDの基礎から実装方法まで詳しく解説している。JSON-LDは「application/ld+json」というMIMEタイプで指定されたスクリプトタグ内に記述され、ブラウザのJavaScriptエンジンは実行しないが、Googlebotなどのクローラーがこれをパースして処理する仕組みになっている。
実装の基本構造として、@contextプロパティをhttps://schema.orgに設定することで、有効なキー・バリューペアが定義される。JSONドキュメントは@graphの下に複数のノードを持つラベル付き有向グラフとして構成され、各ノードは@type（WebSiteやSoftwareApplicationなど）、@id（通常はURLとハッシュ値の組み合わせ）、およびプロパティで構成される。
クローラーは複数ページ間で同じIDを持つノードのプロパティをマージできるが、単一ページのみを読み取るLLMなどのスクレーパーはマージしない。このバランスを考慮することが重要とされている。IDはURLの後にハッシュ（#website等）を付けることがベストプラクティスとして推奨されている。
記事では、SEOへの実質的な影響がある特定のノードタイプのみを対象にしており、WebSiteノードの完全な実装例を示している。このノードではurl、name、alternateNameなどのプロパティを含める。著者は約100時間のコーディングを経て、このサイト改善を実施したと述べている。