HN 日本語サマリー

← 一覧へ戻る
Web開発

パーソナルウェブサイトのためのJSON-LD解説

JSON-LD explained for personal websites (hawksley.dev)

195 pointsby ethanhawksley57 コメント

要約

この記事では、パーソナルウェブサイトに構造化データを追加するためのJSON-LDについて解説しています。JSON-LDは、Webクローラーがサイトのセマンティック構造を理解するのを助け、検索ランキングの向上やリッチなリンクプレビュー表示に寄与します。実装方法、`@context`や`@graph`といった基本的な要素、そして`WebSite`、`WebPage`、`Person`などの主要なノードタイプについて具体例を交えて説明しています。

全文翻訳

パーソナルウェブサイトのためのJSON-LD解説

更新: ポジティブなフィードバックをありがとうございます!この記事を、現在のベストプラクティスに合わせて更新していく生きたドキュメントにしました。私の目標は、一般的なSEOスパムブログに見られるような無駄を省き、実用的な情報を提供することです。

JSON-LD(JSON Linked Data)は、ウェブページに構造化データを追加するためのフォーマットです。ウェブクローラーがサイトのセマンティック構造を理解するのを助け、リッチ検索結果の対象となったり、検索ランキングが向上したりする可能性があります。

私がこの記事を最初に書いたのは、このサイトを構築した最初の投稿から4ヶ月後で、WakaTimeのログは約100時間でした。それ以来、サイトは多くの洗練を経ており、各ページに専用のJSON-LDが追加されています。

JSON-LDの基本

ページにJSON-LDを追加するには、<head>セクションのどこかに以下を追加します。

<script type="application/ld+json">
  {
    "@context": "https://schema.org",
    "@graph": [
      {
        "@type": "WebSite",
        "@id": "https://hawksley.dev/#website",
        "url": "https://hawksley.dev/",
        "name": "Ethan Hawksley"
      },
      // ここにさらにノードを挿入します。
    ]
  }
</script>

各部分が何をするのか見ていきましょう。

<script type="application/ld+json">

これは、MIMEタイプ application/ld+json を持つ新しいスクリプトを宣言します。このタイプが指定されているため、ブラウザのJSエンジンはこれを実行しません。Googlebotのような専門的なクローラーは、これらの要素を探し出し、内容を解析します。

{
  "@context": "https://schema.org"
}

ここでJSONオブジェクトが初期化され、プロパティ @context が https://schema.org に設定されます。JSON-LDでは、データの構造は適切なコンテキストを割り当てることによって決定されます。ウェブクローラーはSchema.org (新しいタブで開く)で標準化されており、JSONの有効なキーと値のペアをすべて定義しています。

JSON-LDが従うスキーマを定義したので、ウェブページを記述できます!

{
  "@graph": [
    {
      "@type": "WebSite",
      "@id": "https://hawksley.dev/#website",
      "url": "https://hawksley.dev/",
      "name": "Ethan Hawksley"
    }
    // ここにさらにノードを挿入します。
  ]
}

JSON-LDドキュメントは、ラベル付き有向グラフと考えることができ、@graph の下に格納されます。グラフは複数のノードを含み、それらは有向アークで互いに接続されています。

ノードは以下を持ちます:

  • @type - ノードが何であるかを記述します(例: WebSite または SoftwareApplication)。
  • @id - ノードの一意な識別子で、通常は末尾に一意のハッシュ値が付いたURLです。
  • プロパティ - ノードの属性を記述するキー/値のペア。

上記の例では、タイプは WebSite、IDは https://hawksley.dev/#website で、url と name という2つのプロパティを持っています。

ウェブクローラーは、IDが共有されている限り、複数のページにわたるノードのプロパティをマージできます。しかし、LLMのような単一のページしか読まないスクレイパーは、プロパティをマージしません。JSON-LDがページ間で再利用される場合、このバランスを考慮することが重要です。IDはURLにハッシュ(例: #website)を付けたものにし、ノードを一意に識別するのがベストプラクティスです。

Schema.orgコンテキストは多くのノードタイプを定義していますが、このガイドではSEOに顕著な影響を与えるノードのみを扱います。さらに興味がある場合は、セマンティックウェブを調べてみてください。楽しい探求の旅になるでしょう。

次に、私たちのサイトの各ページに含めるべきノードを見ていきましょう。各タイプについて、このサイトからのJSON-LDを含めましたので、コピー&ペーストしてご自身のサイトに合わせて編集できます。

WebSite

先ほど WebSite の抜粋を見ましたね!ここでは完全版を示します。

{
  "@type": "WebSite",
  "@id": "https://hawksley.dev/#website",
  "url": "https://hawksley.dev/",
  "name": "Ethan Hawksley",
  "alternateName": ["hawksley.dev", "Hawksley"]
}

WebSite はサイトに関するメタデータを説明します。クローラーにサイトの表示方法に関するヒントを提供します。

[画像: hawksley.dev を示すGoogle検索結果、サイト名「Ethan Hawksley」が強調表示されている]

ここでは、Googleがnameフィールドをドメインの代表として解釈し、結果を適切に表示していることがわかります。

他のノードがしばしば WebSite を参照するため、一般的に各ページに含めるのが良いでしょう。

WebPage

WebPage は現在のページを記述しますが、BlogPosting(後述)のような他のタイプと区別することが重要です。WebPage は物理的なページ自体、つまりHTMLを表します。ページの内容を含みます。

{
  "@type": "WebPage",
  "@id": "https://hawksley.dev/blog/hack-club-campfire#webpage",
  "url": "https://hawksley.dev/blog/hack-club-campfire",
  "isPartOf": {
    "@id": "https://hawksley.dev/#website"
  },
  "name": "Winning the Hack Club Campfire Hackathon",
  "mainEntity": {
    "@id": "https://hawksley.dev/blog/hack-club-campfire#blogposting"
  },
  "breadcrumb": {
    "@id": "https://hawksley.dev/blog/hack-club-campfire#breadcrumb"
  },
  "primaryImageOfPage": "https://hawksley.dev/og/blog/hack-club-campfire.jpg"
}

WebPage にはより具体的なサブタイプがあります。この記事では ProfilePage と CollectionPage を扱います。より一般的なものは、Schema.org の WebPage の定義 (新しいタブで開く) の下部で見つけることができます。

Person

パーソナルウェブサイトのすべてのページに含めるべきもう一つのノードは Person です。これはあなたの人物像を記述し、Googleはコンテンツ品質の指標の一部としてこれを使用します。LLMクローラーも、回答で引用する人物を決定するためにこれを使用するようになっています。

WebSite とは異なり、これはすべてのサイトのページに含めるべきほど重要なコンテキストです。

{
  "@type": "Person",
  "@id": "https://hawksley.dev/#person",
  "url": "https://hawksley.dev/",
  "name": "Ethan Hawksley",
  "description": "Ethan Hawksley is a British computer science student at the University of Warwick and author of The Second Maintainer: Inside the XZ Utils Backdoor.",
  "jobTitle": "Author",
  "nationality": {
    "@type": "Country",
    "name": "United Kingdom"
  },
  "affiliation": {
    "@type": "CollegeOrUniversity",
    "url": "https://warwick.ac.uk",
    "name": "University of Warwick",
    "sameAs": "https://en.wikipedia.org/wiki/University_of_Warwick"
  },
  "alumniOf": [
    {
      "@type": "HighSchool",
      "url": "https://www.alcestergs.co.uk",
      "name": "Alcester Grammar School",
      "sameAs": "https://en.wikipedia.org/wiki/Alcester_Grammar_School"
    },
    {
      "@type": "HighSchool",
      "url": "https://www.brookeweston.org",
      "name": "Brooke Weston Academy",
      "sameAs": "https://en.wikipedia.org/wiki/Brooke_Weston_Academy"
    }
  ],
  "image": "https://hawksley.dev/ethan-hawksley.jpg",
  "sameAs": [
    "https://github.com/ethanhawksley",
    "https://www.linkedin.com/in/ethanhawksley",
    "https://lobste.rs/~ethanhawksley",
    "https://news.ycombinator.com/user?id=ethanhawksley"
    // etc. etc.
  ]
}

ふう!Person には多くのプロパティがあります。記述的である方が、そうでないよりも役立つと私は考えています。最も重要なプロパティを見てみましょう:

  • url - ルートページを指し、ノードをアンカーします。
  • name - あなたの名前を明確に記述します。
  • image - できればあなたの写真、またはあなたが所属するロゴ。あなた自身の代表的な画像にリンクします。
  • sameAs - 曖昧さの解消に非常に役立ちます。特に名前が一般的な場合。他のプロフィールが何であるかをクローラーに明確に伝え、複数のページにわたるあなたの知識グラフ表現を構築できるようにします。執筆時点では、/g/11m62cgdtf (新しいタブで開く) が私のGoogle知識グラフIDです。

Person の他のプロパティは詳細を追加するのに役立ちますが、必須ではありません。必要に応じて、わずかな影響で削除できます。

ProfilePage

ProfilePage は、予想されるように、人物に関するサイト上のページを記述します。例えば、私はこのノードをホームページで使用しています。なぜなら、そこで自分自身について話しているからです。あなたのサイトでは、「About」ページに配置する方が適切かもしれません。

{
  "@type": "ProfilePage",
  "@id": "https://hawksley.dev/#webpage",
  "url": "https://hawksley.dev/",
  "isPartOf": {
    "@id": "https://hawksley.dev/#website"
  },
  "name": "About Ethan Hawksley",
  "mainEntity": {
    "@id": "https://hawksley.dev/#person"
  },
  "dateCreated": "2024-09-10T00:00:00.000Z",
  "dateModified": "2026-09-16T00:00:00.000Z",
  "primaryImageOfPage": "https://hawksley.dev/ethan-hawksley.jpg"
}

isPartOf を使用して、より広範な WebSite ノードにリンクし、2つのノード間の関係を作成することが重要です。mainEntity も同様で、ページが誰についてのものであるかをクローラーに知らせます。

dateCreated と dateModified を含めることは、クローラーにとって良い鮮度シグナルですが、サイトにそれらがすぐに利用できない場合は、あまり心配しないでください。

BreadcrumbList

BreadcrumbList は非常に有用で、階層の2層目にあるすべてのページに含めるべきです。例えば、私はブログ投稿(/blog/POST_ID)には含めますが、ブログインデックス(/blog)やホームページ(/)には含めません。

A BreadcrumbList は、ページへの概念的なパスを記述しますが、必ずしもURLバーのパスと一致する必要はありません。

{
  "@type": "BreadcrumbList",
  "@id": "https://hawksley.dev/blog/hack-club-shipwrecked#breadcrumb",
  "itemListElement": [
    {
      "@type": "ListItem",
      "position": 1,
      "name": "Blog",
      "item": "https://hawksley.dev/blog"
    },
    {
      "@type": "ListItem",
      "position": 2,
      "name": "The Shipwrecked Hackathon by Hack Club",
      "item": "https://hawksley.dev/blog/hack-club-shipwrecked"
    }
  ]
}

BreadcrumbList はページのパスを記述します。これを含めることで、検索エンジンが特定のページのパスをどのように表示するかを制御できます。

[画像: The Shipwrecked Hackathon by Hack Club の Google検索結果、パンくずリストが強調表示されている]

ここでは、私のブログ投稿の検索結果にパス https://hawksley.dev › Blog が含まれています。あなたのサイトがすでに短いパスを使用している場合、このノードはわずかな利点であり、省略できます。しかし、パスが長い場合は、BreadcrumbList はそれらを短縮するのに役立ちます。

CollectionPage

CollectionPage ノードは WebPage のサブタイプで、主にリストを含むページに使用できます。例えば、私の /elsewhere ページは他のすべてのプロフィールをリストし、/blog ページはすべてのブログ投稿をリストします。

{
  "@type": "CollectionPage",
  "@id": "https://hawksley.dev/elsewhere#webpage",
  "url": "https://hawksley.dev/elsewhere",
  "isPartOf": {
    "@id": "https://hawksley.dev/#website"
  },
  "name": "Elsewhere",
  "primaryImageOfPage": "https://hawksley.dev/ethan-hawksley.jpg"
}

これらのプロパティのほとんどはすでに紹介済みなので、ほとんど自明です。

Blog

ブログのインデックス、またはインデックスがない場合はホームページに Blog ノードを追加する必要があります。これは、WebSite と公開する個々のブログ投稿との間の踏み台として機能します。

{
  "@type": "Blog",
  "@id": "https://hawksley.dev/blog#blog",
  "url": "https://hawksley.dev/blog",
  "isPartOf": {
    "@id": "https://hawksley.dev/#website"
  },
  "mainEntityOfPage": {
    "@id": "https://hawksley.dev/blog#webpage"
  },
  "name": "Ethan Hawksley's Blog",
  "publisher": {
    "@id": "https://hawksley.dev/#person"
  }
}

[画像: publisher プロパティの定義、利用可能なタイプには Organization と Person が含まれる]

JSON-LDについて事前に調査したことがある場合、publisher プロパティが Organization ではなく Person に設定されていることに驚くかもしれません。以前は必須でしたが、Googleのドキュメントはその後緩和され、Person も完全に有効であり、パーソナルウェブサイトにとってはより正確であると言えます。

BlogPosting

最後に扱うノードは BlogPosting です。公開されたすべてのブログ投稿に含めるべきで、クローラーに追加情報を提供することで、検索結果でのより正確な配置やリッチな詳細を含む、より正確な表現が可能になります。

{
  "@type": "BlogPosting",
  "@id": "https://hawksley.dev/blog/need-for-post-quantum-cryptography#blogposting",
  "url": "https://hawksley.dev/blog/need-for-post-quantum-cryptography",
  "isPartOf": {
    "@id": "https://hawksley.dev/blog#blog"
  },
  "mainEntityOfPage": {
    "@id": "https://hawksley.dev/blog/need-for-post-quantum-cryptography#webpage"
  },
  "headline": "The Need for Post-Quantum Cryptography",
  "datePublished": "2026-04-13T00:00:00.000Z",
  "dateModified": "2026-04-17T00:00:00.000Z",
  "author": {
    "@id": "https://hawksley.dev/#person"
  },
  "publisher": {
    "@id": "https://hawksley.dev/#person"
  },
  "license": "https://creativecommons.org/licenses/by/4.0/",
  "image": "https://hawksley.dev/og/blog/need-for-post-quantum-cryptography.jpg"
}

これはパーソナルサイトなので、author と publisher が同じ Person ノードを指していても問題ありません。image プロパティは、投稿がすでにリンクプレビューに使用しているOG画像と一致させるべきです。

結論

これで、パーソナルサイトに必要なJSON-LDはすべて揃いました!この記事は、ご自身のパーソナルサイトにコピー&ペーストして実装しやすいように構成しました。ビルドステップのない静的サイトを運営している場合でも、少なくとも WebSite、ProfilePage、Person をサイトのルートページに追加することでメリットが得られます。

ご質問があれば、メールでご連絡ください。できる限りお手伝いします。