リッチリザルトテストとは、頁の構造化データから 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・image | headline・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 検査ツールで確かめるよう勧めています。
リッチリザルトテストの撃ち方と、結果の見方
- リッチリザルトテストを開き、確かめる頁の URL を全部入れる。出す前の物なら「コード」を選んで HTML を貼る
- ユーザー エージェントを選ぶ(既定はスマートフォン。パソコンも選べる)
- テストを撃つ。コードは直して何度でも撃ち直せる
- 結果の「検出された項目」を開き、型ごとに有効か、警告や無効が無いかを見る
| 結果の欄 | 出る事 | 見る所 |
|---|---|---|
| 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 の address | 1 本の文字列 | 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 などの中身が揃っているかを確かめます。
出典
- Search Console ヘルプ「リッチリザルト テスト」 https://support.google.com/webmasters/answer/7445569?hl=ja(2026-11-21 に確認)
- Google 検索セントラル「構造化データ マークアップをテストする」 https://developers.google.com/search/docs/appearance/structured-data?hl=ja(2026-11-21 に確認)
- Google 検索セントラル「構造化データの一般的なガイドライン」 https://developers.google.com/search/docs/appearance/structured-data/sd-policies?hl=ja(2026-11-21 に確認)
- Google 検索セントラル「Article(Article、NewsArticle、BlogPosting)の構造化データ」 https://developers.google.com/search/docs/appearance/structured-data/article?hl=ja(2026-11-21 に確認)
- Google 検索セントラル「パンくずリスト(BreadcrumbList)の構造化データ」 https://developers.google.com/search/docs/appearance/structured-data/breadcrumb?hl=ja(2026-11-21 に確認)
- Google 検索セントラル「組織(Organization)の構造化データ」 https://developers.google.com/search/docs/appearance/structured-data/organization?hl=ja(2026-11-21 に確認)
- Google 検索セントラル「ソフトウェア アプリ(SoftwareApplication)の構造化データ」 https://developers.google.com/search/docs/appearance/structured-data/software-app?hl=ja(2026-11-21 に確認)
- Schema.org「Schema Markup Validator」 https://validator.schema.org/(2026-11-21 に確認)
- W3C「JSON-LD 1.1」 https://www.w3.org/TR/json-ld11/(2026-11-21 に確認)
- 社の実測 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 つの型)