構造化データチェック

Q: JSON-LDのscriptはページのどこに置きますか？

HTMLのどこでもかまいません。 <head> でも <body> でも大丈夫です。一つのページに複数のブロックを置くことも、 @graph の下に複数のアイテムを並べた一つのブロックにすることもできます。

ページのアドレスを入力してください。JSON-LDブロックを読み取り、構文エラーがあれば指摘し、各アイテムの構造を示して、検索エンジンが求めるプロパティと照らし合わせます。マイクロデータとRDFaの型も一覧にします。

機械向けに書かれた、ページのもう一つの写し

人に商品ページを見せれば、どの数字が価格でどれが在庫数か、すぐにわかります。プログラムにはただの文字列にしか見えません。構造化データは、その推測の手間を省きます。見えるページの横に、同じ事実をラベル付きの項目として載せるのです。項目名には schema.org の共通語彙を使います。これは Product で、name はこれ、offers には USD で49.00の price がある、という具合です。

書き方は3通りあります。JSON-LDはすべてを一つのscriptタグにまとめ、レイアウトから切り離します。Googleが推奨しているのはこの形式です。マイクロデータとRDFaは、ラベルを属性としてHTMLタグに散りばめます。

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "How tides work",
  "datePublished": "2026-03-14T09:30:00+00:00",
  "author": { "@type": "Person", "name": "Jane Doe" }
}
</script>

検索エンジンはこれらの項目を使って、レビューの星、価格、レシピの写真、イベントの日付などを添えた、より豊かな検索結果を表示します。これをリッチリザルトと呼びます。

このチェックが読み取るもの

当サーバーはページを一度だけ、最大3 MBまでダウンロードし、スクリプトは実行しません。そのあと4つの段階で処理します。

構文。各JSON-LDブロックを厳密なJSONリーダーに通します。最初の不具合で、その行、文字位置、考えられる原因を示します。閉じ括弧の前のカンマ、テキスト内のエスケープされていない引用符、ワープロから貼り付けた全角風の引用符、HTMLコメント、生の改行などです。不具合が一つあるだけで、パーサーはブロック全体を捨ててしまいます。
アイテム。@graph のリストを展開し、すべてのアイテムを型とプロパティの構造付きで個別に表示します。@id で別のアイテムを指すプロパティは、参照先がページ内にあればたどります。
プロパティ。リッチリザルトにつながる型については、Googleのドキュメントから取った必須・推奨プロパティの一覧とアイテムを照らし合わせます。
値。すべてのアイテムで、アドレスは絶対パスであること、日付と期間はISO 8601に従うこと、@context はschema.orgであること、各 @id の参照先が存在することを確認します。

マイクロデータ（itemscope、itemtype）とRDFa（typeof）は、型ごとに数えて名前を示します。そのプロパティは検証しません。

照合する型と、それぞれに必要なもの

型	必須	知っておきたいこと
Article, NewsArticle, BlogPosting	なし	推奨：`headline`、`image`、`datePublished`、`dateModified`、`name` と `url` を持つアイテムとしての `author`。
Product	`name`、および `offers`、`review`、`aggregateRating` のいずれか	オファーには `price` が、評価には `ratingValue` と件数が必要です。
BreadcrumbList	`position`、`name`、`item` を持つ `itemListElement`	2025年以降、Googleはパンくずをパソコンの検索結果にのみ表示しています。
FAQPage	`mainEntity`：承認済みの回答を持つ質問	2023年8月以降、Googleが表示するのは著名な政府機関と医療系のサイトだけです。
HowTo	`name`、`step`	廃止：Googleは2023年にこの結果の表示をやめました。
LocalBusiness	`name`、`address`	自社について自ら掲載したレビューの星は表示されません。
Event	`name`、`startDate`、住所付きの `location`
Recipe	`name`、`image`	時間は期間で書きます：`PT45M`。
VideoObject	`name`、`thumbnailUrl`、`uploadDate`
JobPosting	`title`、`description`、`datePosted`、`hiringOrganization`、`jobLocation`	リモートの求人では、勤務地の代わりに `jobLocationType` と `applicantLocationRequirements` を使います。
SoftwareApplication, WebApplication	`name`、価格付きの `offers`、評価、またはレビュー	無料のプログラムは価格0とします。
WebSite	`name`、`url`	サイト名の表示に使われます。検索ボックスのアクションは2024年末に廃止されました。
Organization, Person	なし	推奨：`name`、`url`、`logo`、組織なら `sameAs`。

その他の型も構造を示して値をチェックしますが、必須プロパティの一覧とは照合しません。

レポートで見つかった問題の直し方

構文の不具合: 手で編集したブロックは、カンマと引用符で壊れます。ブロックをJSONエンコーダー（PHPなら json_encode、JavaScriptなら JSON.stringify）で生成すれば、この種の不具合はまとめて消えます。CMSでは、JSON-LDはコード用の欄に貼り付けてください。ビジュアルエディターは引用符を飾り文字に変えてしまうので、決して使わないでください。
必須プロパティがない: 訪問者がページで目にする値を使って追加してください。検索エンジンは両者を比べます。ページに表示されていないものを記述したマークアップは、手動による対策の対象になることがあります。
相対アドレス: /img/cover.jpg ではなく、https://www.example.com/img/cover.jpg と省略せずに書いてください。
ISO 8601ではない日付: 年を先頭に、次に T、そのあとに時刻とUTCからの時差を書きます：2026-03-14T09:30:00+00:00。日付だけの 2026-03-14 も有効です。
行き先のない参照: "author": {"@id": "…/#jane"} が機能するのは、まったく同じ @id を持つアイテムが同じページにある場合だけです。そのアイテムを追加するか、著者をその場に直接書いてください。

このチェックでわからないこと

配信されたままのHTMLを読み取ります。あとからJavaScriptやタグマネージャーで追加された構造化データはここでは見えませんが、Googleはレンダリング後にそれを読むことがあります。画像はダウンロードしないため、壊れた画像や小さすぎる画像は見逃されます。プロパティの一覧は一般的なリッチリザルトの種類を対象にしています。すべての型やすべての任意項目を網羅しているわけではありません。

これはGoogleのリッチリザルトテストではありません。問題のないレポートでも、リッチリザルトが表示される保証にはなりません。正しいマークアップは、ページを表示の対象にするだけです。星や価格が実際に出るかどうかは、検索エンジン、検索語句、ページの品質、そして変わり続けるポリシーによって決まります。ページがインデックスされたら、Search Consoleで確認してください。

よくある質問

JSON-LD、マイクロデータ、RDFaの違いは何ですか？

どれも同じschema.orgの語彙を、3つの異なる構文で記述します。JSON-LDはレイアウトから切り離された一つのscriptタグに収まります。マイクロデータとRDFaは、見えるテキストを囲むHTMLタグに属性を加えます。Googleは3つとも読み取りますが、最も保守しやすいJSON-LDを推奨しています。

構造化データで検索順位は上がりますか？

直接には上がりません。検索エンジンがページを理解する助けになり、より豊かな検索結果の対象になるので、クリックが増えることはあります。それだけでページの順位が上がることはありません。

FAQのマークアップがGoogleに表示されないのはなぜですか？

2023年8月以降、GoogleがFAQのリッチリザルトを表示するのは、著名で信頼性の高い政府機関と医療系のサイトだけです。それ以外のサイトでは、正しい FAQPage マークアップは読み取られますが、検索結果に目に見える効果はありません。ハウツーの結果は同じ年に完全に廃止されました。

JSON-LDの構文エラーはどうやって見つけますか？

このチェックにページをかけてください。JSONパーサーが止まる行と文字位置、考えられる原因を示します。最も多いのは、閉じの } や ] の前のカンマ、\" と書くべきテキスト内のダブルクォート、テキストエディターが残した飾り引用符です。

構造化データは正しいのに、リッチリザルトが出ないのはなぜですか？

正しいマークアップは候補に入るための条件にすぎません。ページがインデックスされていること、マークアップが訪問者の見る内容と一致していること、その種類の結果に十分な信頼がサイトにあることが必要です。また、一部の種類は特定のサイトに限られているか、すでに廃止されています。新しいマークアップが反映されるまで、数日から数週間かかることもあります。

JSON-LDのscriptはページのどこに置きますか？

HTMLのどこでもかまいません。<head> でも <body> でも大丈夫です。一つのページに複数のブロックを置くことも、@graph の下に複数のアイテムを並べた一つのブロックにすることもできます。