構造化データ(JSON-LD)の解析エラー

構造化データが構文エラーで壊れていると、検索エンジンはその内容を一切読めません。リッチリザルト(星評価・FAQ表示など)の資格を失うだけでなく、「実装したつもりで何も伝わっていない」状態になります。

公開日: 2026年8月16日 / 最終更新日: 2026年9月6日

カテゴリ: 構造化データ / 影響度: 中 / 想定工数: 1時間 / ルールID: structured_data_parse_error

この問題の意味

構造化データ(JSON-LD)は、ページの内容を機械可読な形式で検索エンジンに伝える記述です。scriptタグ内にJSON形式で書きますが、JSONは構文に厳格で、カンマ1つの欠落でも全体が読めなくなります。

壊れたJSON-LDは「無いもの」として扱われます。エラーが出るわけではなく、静かに無視されるため、気づきにくい問題です。

よくある原因

Smash SEOの検出条件

各ページのscriptタグ内のJSON-LDを実際に解析し、JSONとして解析できなかったものを解析エラーとして検出します。あわせて、解析はできたが@typeの指定がないもの(何のデータか宣言されていない状態)も別途報告します。

つまりこの検出は「Googleのクローラーが読もうとして失敗するのと同じ経験」をシミュレートしたものです。

直し方

典型的な壊れ方: 引用符のエスケープ漏れ

// NG: タイトル内の引用符で構文が壊れる
{"@type": "Article", "headline": "自称"最速"のサイト改善"}

// OK: エスケープされている
{"@type": "Article", "headline": "自称\"最速\"のサイト改善"}

修正後の確認方法

よくある質問

構造化データを入れるとリッチリザルトは必ず出ますか?

出ません。構造化データは資格を得るための条件であり、表示するかはGoogleがページごとに判断します。ただし壊れていれば資格すらないため、正しく実装する価値はあります。

JSON-LDとmicrodataのどちらで書くべきですか?

Googleが推奨しているのはJSON-LDです。HTMLの構造と分離して書けるため、保守も容易です。

関連記事

この問題が自分のサイトで起きているかは、URLを入力するだけで確認できます。 無料で診断するルール一覧料金プラン