リッチリザルトテストとは、頁の構造化データから Google のリッチリザルトが作れるかを確かめる、Google の道具です。

  • 構造化データとは何か、JSON-LD で Article・パンくずリスト(BreadcrumbList)・組織(Organization)をどう書くか
  • リッチリザルトテストの撃ち方と結果の見方、Schema Markup Validator との違い
  • 当社が記事を出すたびに撃って出た警告・無効と、それをどう直したかの記録

当社は AIエージェント の席に記事の頁を作らせ、出した後の頁を席自身にリッチリザルトテストで撃たせて、構造化データが通るかを確かめています。同じ頁の速さは Lighthouse の頁、索引に入ったかは URL 検査の頁に書きました。この頁は Google の公式の文書の手順に、撃って見た記録を並べた物です。

構造化データとは:JSON-LD で書く 3 つの型

構造化データは、頁の中身(記事の題・書いた日・パンくずリスト・運営する組織など)を、検索エンジンが読める決まった形で書き添える物です。書き方は JSON-LD・microdata・RDFa の 3 つがあり、Google は JSON-LD を勧めています。JSON-LD は、W3C の仕様で「Linked Data を表すための、JSON を元にした形式」と定められています(W3C JSON-LD 1.1・2026-11-21 に確認)。

このサイトの記事の頁が実際に持つ構造化データは、次の 3 つです(2026-11-21 に本番の頁 https://bluelamp.ai/ai-agent/vsce-publish の ld+json を読んで確かめた・社の実測 2026-11-21)。

型Google の必須の項目Google が勧める主な項目このサイトの記事で書いている項目
記事(Article)無しauthor・datePublished・dateModified・headline・imageheadline・description・image・datePublished・dateModified・author・publisher
パンくずリスト(BreadcrumbList)itemListElement、各 ListItem の position・name・item(最後の項目の item は省ける)。ListItem は 2 つ以上—ホーム → 記事 → その頁の 3 段
組織(Organization)無しname・url・logo・address(PostalAddress)など@id・name・logo・address など

出典: Google 検索セントラル「Article(Article、NewsArticle、BlogPosting)の構造化データ」「パンくずリスト(BreadcrumbList)の構造化データ」「組織(Organization)の構造化データ」(いずれも 2026-11-21 に確認)・このサイトの列は社の実測 2026-11-21。

構造化データ json-ld の書き方は、頁の HTML に <script type="application/ld+json"> の塊を置き、その中に JSON で書きます。次は記事とパンくずリストの書き方の例です(住所・名前は例の物)。

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@graph": [
    {
      "@type": "Article",
      "headline": "記事の題",
      "image": "https://example.com/og.png",
      "datePublished": "2026-11-21T00:00:00+09:00",
      "dateModified": "2026-11-21T00:00:00+09:00",
      "author": { "@type": "Organization", "name": "編集部", "url": "https://example.com/editorial" }
    },
    {
      "@type": "BreadcrumbList",
      "itemListElement": [
        { "@type": "ListItem", "position": 1, "name": "ホーム", "item": "https://example.com/" },
        { "@type": "ListItem", "position": 2, "name": "記事", "item": "https://example.com/articles" },
        { "@type": "ListItem", "position": 3, "name": "この頁" }
      ]
    }
  ]
}
</script>

日付は ISO 8601 の形で、時刻とタイムゾーンまで書くのを Google は勧めています。タイムゾーンが無いと、Googlebot の側のタイムゾーンで読まれます(Google 検索セントラル「Article の構造化データ」・2026-11-21 に確認)。

リッチリザルトテストと Schema Markup Validator の違い

構造化データ チェックの道具は、目的で選びます。以前の「構造化データ テストツール」は、Google 固有の検査を外して Schema.org の Schema Markup Validator(スキーマ マークアップ 検証ツール)へ移りました。

道具何を見るかGoogle 固有の警告向いている時
リッチリザルトテスト頁の構造化データから、Google のリッチリザルトが作られるか出るGoogle 検索での見え方を確かめたい
Schema Markup Validator(validator.schema.org)schema.org に基づく構造化データ全般出ないGoogle が扱わない型も含めて、書き方の誤りを見たい
Search Console の URL 検査索引に入った頁の状態—出した後の頁が索引に入ったかも見たい

出典: Google 検索セントラル「構造化データ マークアップをテストする」・「構造化データの一般的なガイドライン」・Schema.org「Schema Markup Validator」(いずれも 2026-11-21 に確認)。一般的なガイドラインは、マークアップが正しいかをリッチリザルトテストと URL 検査ツールで確かめるよう勧めています。

リッチリザルトテストの撃ち方と、結果の見方

  1. リッチリザルトテストを開き、確かめる頁の URL を全部入れる。出す前の物なら「コード」を選んで HTML を貼る
  2. ユーザー エージェントを選ぶ(既定はスマートフォン。パソコンも選べる)
  3. テストを撃つ。コードは直して何度でも撃ち直せる
  4. 結果の「検出された項目」を開き、型ごとに有効か、警告や無効が無いかを見る
結果の欄出る事見る所
URL のステータス有効なアイテムの数、警告あり、一部または全部が無効、クロールできない、構文の誤りなどまず頁として撃てたか
クロール取得できたか、使ったユーザー エージェント、robots.txt で許されたか撃てない時の原因
検出された項目見つかった型ごとに、良好・警告やエラーあり・読めない型を開いて、欠けている項目の名前を読む
リソースの警告画像や CSS などが読み込めない大事な物が robots.txt で止められていないか

出典: Search Console ヘルプ「リッチリザルト テスト」(2026-11-21 に確認)。テストは Google-InspectionTool として頁を取りに行くので、匿名で開ける頁でないと撃てません。プレビューが実際の検索結果とすべて同じになるとは限らない、とも書かれています。

リッチリザルトが表示されない・警告が出る時に見る所

まず、正しく書いてもリッチリザルトが出る保証は無い事を押さえます。Google は、必須の項目が欠けると対象から外し、勧める項目は多く入れるほど良いとしています。頁の上で読む人に見えない中身をマークアップしない事も決まりです(Google 検索セントラル「構造化データの一般的なガイドライン」・2026-11-21 に確認)。そのうえで、当社が実際に当たった物を並べます。

出た事根直し方出典
「組織」に重大でない問題 4 件(postalCode・streetAddress・addressLocality・addressCountry が無い)配信の時に頭へ足される Organization の address が 1 本の文字列だった住所を 5 欄の PostalAddress にした社の実測 2026-10-19・2026-10-24
任意の警告 2 件Article の dateModified が "2026-10-24" のように日付だけでタイムゾーンが無い/Organization の address に addressLocality が無いdateModified に時刻とタイムゾーンを付けた/住所を 5 欄にした社の実測 2026-10-24
記事の雛形の警告Article に image が無い・datePublished が日付だけ・パンくずリストの item が相対の住所本番の JSON-LD を取り出して 3 点とも確かめ、雛形の直しを頼んだ社の実測 2026-10-19
「ソフトウェア アプリ」が無効 2 件事業を SoftwareApplication で書いていて、評価(aggregateRating)と値段(offers)が無い推測で書き足さず、型を Service に替えた社の実測 2026-10-24
「エラーが発生しました」しか返らない対照の既に出した頁でも同じ=頁ではなく道具の側その日は別の確かめ方で代え、以後は画面ありのブラウザで撃つ社の実測 2026-10-19

出典: 表の右の列のとおり。Google のソフトウェア アプリの文書は、name・offers.price と、aggregateRating か review のどちらかを必須にしています(Google 検索セントラル「ソフトウェア アプリ(SoftwareApplication)の構造化データ」・2026-11-21 に確認)。

記録:配る時に足された住所の 1 本の文字列で、下書き 6 枚を止めた

2026-10-19、社の公式サイトの記事の下書き 6 枚を、リッチリザルトテスト(画面ありのブラウザ)で撃つと、「組織」2 件のうち 1 件に重大でない問題 4 件が出ました。postalCode・streetAddress・addressLocality・addressCountry が無い、という中身です(社の実測 2026-10-19)。

原因は記事のファイル自身ではありませんでした。配信の時に頁の頭へ足される会社の Organization の address が、郵便番号から番地までを 1 本につないだ文字列だったのです。版のファイルの大きさと、配られた頁の大きさの差を見て、足された塊を特定しました。記事の門(警告 0)にかかったので、6 枚とも出さずに止めました(社の実測 2026-10-19)。

項目直す前直した後(2026-10-24 公開の版)
Organization の address1 本の文字列5 欄の PostalAddress
Article の dateModified"2026-10-24" のように日付だけ(タイムゾーン無し)時刻とタイムゾーンつき
Article の datePublished無し足した
配る時の名札—直した
リッチリザルトテスト「組織」に重大でない問題 4 件・任意の警告 2 件同じ頁と束の 6 頁で問題 0
本文—変えていない(変えていない頁の内容の指紋も前後で同じ)

出典: 社の実測 2026-10-19・2026-10-24。

ここで分かったのは、構造化データは記事のファイルだけを見ても足りない、という事です。配信の途中で足される物があるなら、出した後の頁、または配られる形と同じ物を撃たないと、警告の出どころを見誤ります。

記録:記事の雛形の 3 点(image・日付・相対の住所)を確かめてから直しを頼んだ

同じ 2026-10-19、このサイト(ブルーランプのサイト)の記事の雛形では、次の 3 点が警告の根でした。本番の JSON-LD を取り出して 3 点とも確かめてから、雛形の直しを開発に頼みました(社の実測 2026-10-19)。

  • Article に image が無い
  • datePublished が日付だけ
  • 構造化データのパンくずリストの item が相対の住所

雛形の誤りは、その雛形で作るすべての頁に写ります。1 頁で見つけた警告は、頁を直すのではなく雛形まで遡って直すほうが早く済みます。

記録:評価と値段を推測で書き足さず、型を Service に替えた

2026-10-24、社のトップ頁では 2 つの事業を SoftwareApplication で書いていたため、評価(aggregateRating)や値段(offers)が無いとして、「ソフトウェア アプリ」が無効 2 件になっていました。評価や値段を推測で書き足すのではなく、型を Service に替えて検査の対象外にしました。直した後、リッチリザルトテストは組織 2 件有効・無効 0 で、JSON-LD の外は前後で一字一致でした(社の実測 2026-10-24)。

無効を消すために、頁に無い評価や値段を書くのは、見えない中身をマークアップしない決まりに反します。中身に合う型を選び直すのが筋です。

記録:テストが「エラーが発生しました」しか返さない日

2026-10-19 のある時、リッチリザルトテストが「エラーが発生しました」しか返さず、対照に撃った既に出した頁でも同じでした。頁ではなく道具の側で撃てなかった、と読みました。その日は、サイトの道具の構造化データの検査と、本番の ld+json の Article・author・publisher・image を直接読んで確かめる形で代えました(社の実測 2026-10-19)。以後、当社はテストを画面ありのブラウザで撃つ決まりにしています。頭なし(headless)のブラウザで当たった事は、Playwright MCP の頁に書きました。

出した後の頁で、3 種が有効・警告 0 かを見る

当社は記事を出すたびに、出した後の頁をリッチリザルトテストで撃ちます。ブルーランプの記事では「記事・パンくずリスト・組織」の 3 種が有効で警告 0 である事を、記事を出す門の 1 つにしています(社の実測 2026-11-14〜2026-11-21)。

見る事当社の決め2026-11-14〜11-21 に出した記事
撃つ頁出した後の頁—
撃つブラウザ画面ありのブラウザ—
有効であるべき型記事・パンくずリスト・組織の 3 種どれも 3 種有効
警告0どれも 0
例—2026-11-21 に /ai-agent/vsce-publish を撃って「3 件の有効なアイテム(記事・パンくずリスト・組織)」

出典: 社の実測 2026-11-14〜2026-11-21。

頁の中身を足す時は、構造化データも同じ直しで揃えます。2026-11-06 に頁へよくある質問を 1 問足した時は、FAQPage の構造化データ・最終更新の表示・Article の dateModified を同じ直しで揃えました。表示中の中身と構造化データを一致させるためです(社の実測 2026-11-06)。

よくある質問

構造化データ テストツールは、今はどこで使えますか?

Google の旧「構造化データ テストツール」は、Google 固有の検査を外して Schema.org の Schema Markup Validator(validator.schema.org)へ移りました。Google 検索での見え方を確かめるなら、リッチリザルトテストを使います(Google 検索セントラル「構造化データ マークアップをテストする」・2026-11-21 に確認)。

リッチリザルトテストで有効なのに、検索結果にリッチリザルトが表示されないのはなぜですか?

正しく書いても、リッチリザルトが出る保証は無いからです。Google は、読む人に最適だと判断した時に出すとしています(Google 検索セントラル「構造化データの一般的なガイドライン」・2026-11-21 に確認)。テストのプレビューも、実際の検索結果と同じになるとは限りません。

「重大でない問題」や警告は、直さなくてもよいですか?

警告は、勧められている項目が欠けている合図です。Google は勧める項目を多く入れるほど良いとしています。当社は記事を出す門を「警告 0」にしていて、住所が 1 本の文字列だった時は 6 枚とも出さずに止め、5 欄の PostalAddress に直してから出しました(社の実測 2026-10-19・2026-10-24)。

構造化データのパンくずリスト(BreadcrumbList)の item は、相対の住所でよいですか?

item は URL を書く項目です。当社の記事の雛形では、パンくずリストの item が相対の住所だった事が警告の根の 1 つで、本番の JSON-LD で確かめてから雛形の直しを頼みました(社の実測 2026-10-19)。最後の項目の item は省けて、省くとその頁自体の URL が使われます(Google 検索セントラル「パンくずリスト(BreadcrumbList)の構造化データ」・2026-11-21 に確認)。

構造化データの Organization は、全部の頁に要りますか?

Google は、ホームページや会社案内の頁など 1 つの頁に置けばよく、全部の頁に入れる必要は無いとしています(Google 検索セントラル「組織(Organization)の構造化データ」・2026-11-21 に確認)。全部の頁に入れるなら、どの頁でも address などの中身が揃っているかを確かめます。

出典

  1. Search Console ヘルプ「リッチリザルト テスト」 https://support.google.com/webmasters/answer/7445569?hl=ja(2026-11-21 に確認)
  2. Google 検索セントラル「構造化データ マークアップをテストする」 https://developers.google.com/search/docs/appearance/structured-data?hl=ja(2026-11-21 に確認)
  3. Google 検索セントラル「構造化データの一般的なガイドライン」 https://developers.google.com/search/docs/appearance/structured-data/sd-policies?hl=ja(2026-11-21 に確認)
  4. Google 検索セントラル「Article(Article、NewsArticle、BlogPosting)の構造化データ」 https://developers.google.com/search/docs/appearance/structured-data/article?hl=ja(2026-11-21 に確認)
  5. Google 検索セントラル「パンくずリスト(BreadcrumbList)の構造化データ」 https://developers.google.com/search/docs/appearance/structured-data/breadcrumb?hl=ja(2026-11-21 に確認)
  6. Google 検索セントラル「組織(Organization)の構造化データ」 https://developers.google.com/search/docs/appearance/structured-data/organization?hl=ja(2026-11-21 に確認)
  7. Google 検索セントラル「ソフトウェア アプリ(SoftwareApplication)の構造化データ」 https://developers.google.com/search/docs/appearance/structured-data/software-app?hl=ja(2026-11-21 に確認)
  8. Schema.org「Schema Markup Validator」 https://validator.schema.org/(2026-11-21 に確認)
  9. W3C「JSON-LD 1.1」 https://www.w3.org/TR/json-ld11/(2026-11-21 に確認)
  10. 社の実測 2026-10-19(下書き 6 枚で「組織」に重大でない問題 4 件・配信で足された address の特定・6 枚を止めた/記事の雛形の警告の根 3 点/テストが「エラーが発生しました」しか返さず対照の頁も同じ)・2026-10-24(住所を 5 欄の PostalAddress・dateModified に時刻とタイムゾーン・datePublished を足した版で問題 0、直す前の任意の警告 2 件/トップ頁の「ソフトウェア アプリ」無効 2 件を型を Service に替えて組織 2 件有効・無効 0)・2026-11-06(よくある質問を足した時に FAQPage・最終更新の表示・dateModified を揃えた)・2026-11-14〜2026-11-21(出した記事はどれも 3 種有効・警告 0)・2026-11-21(本番の頁の ld+json の 3 つの型)