JSON-LD 構造化データチェック（必須・推奨項目の不足を確認）

JSON-LD structured data check for common rich result types

ページや HTML ファイルから JSON-LD を取り出し、文法エラーの位置と原因、Product・Article・パンくず・Organization などで不足している必須・推奨項目を一覧にします。

Claude Hermes Agent Codex CursorMIT（改変・再配布・商用利用可）Python

できること

ページに埋め込まれた構造化データ（JSON-LD）を取り出して点検します。

<script type="application/ld+json"> をすべて抽出し、JSON の文法エラーを行・列つきで報告（末尾のカンマ、全角の引用符などの原因も推定）
@graph・配列・入れ子・@id 参照をたどり、各データの種類を判定
同梱の対応表にもとづき、Product、Article（NewsArticle・BlogPosting）、BreadcrumbList、FAQPage、Organization、SoftwareApplication で不足している必須・推奨項目を指摘。Offer・評価・レビュー・パンくずの各項目など入れ子の中身も確認
日付の形式、URL が絶対パスか、価格が数値か（「¥1,000」は不可）、通貨コード、在庫状況の値なども確認
エージェントが修正済みの JSON-LD を提案

使い方

python scripts/jsonld_check.py https://example.com/products/1 --out jsonld.json
python scripts/jsonld_check.py ./dist --quiet-recommended

必要な環境

Python 3（標準ライブラリのみ）
URL を調べる場合は対象サイトへのネットワーク接続

注意点

読むのは JSON-LD だけです（Microdata・RDFa は対象外）。JavaScript で後から挿入されるデータは、元の HTML には現れません。
Google は 2026 年に FAQ のリッチリザルトを終了しています。FAQPage は構造の確認のみ行い、その旨を表示します。
正しく書けていても、リッチリザルトの表示は保証されません。最終確認には Google のリッチリザルトテストを使ってください。
対応表は 2026 年 11 月時点の Google のドキュメントをもとにまとめたものです。

English description

Extracts JSON-LD from pages or HTML files, pinpoints syntax errors, and lists missing required and recommended properties for Product, Article, BreadcrumbList, Organization and more.

What it does

Extracts and checks the JSON-LD structured data embedded in pages.

Finds every <script type="application/ld+json"> block and reports JSON syntax errors with line and column, plus the likely cause (trailing comma, typographic quotes and so on)
Walks @graph, arrays, nested objects and @id references to find each entity
Uses a bundled rule table to list missing required and recommended properties for Product, Article (NewsArticle, BlogPosting), BreadcrumbList, FAQPage, Organization and SoftwareApplication, including nested Offer, rating, review and breadcrumb items
Checks value formats: ISO 8601 dates, absolute URLs, plain numeric prices, currency codes, availability values
The agent then proposes corrected JSON-LD

How to use

python scripts/jsonld_check.py https://example.com/products/1 --out jsonld.json
python scripts/jsonld_check.py ./dist --quiet-recommended

Requirements

Python 3 (standard library only)
Network access when checking live URLs

Caveats

Only JSON-LD is read (not Microdata or RDFa). Markup injected by JavaScript does not appear in raw HTML.
Google retired FAQ rich results in 2026; FAQPage is checked for structure only and flagged as such.
Valid markup does not guarantee a rich result. Confirm with Google's Rich Results Test.
The rule table summarizes Google's documentation as of November 2026.

インストール方法

ダウンロードしたZIPを展開します（中に json-ld-structured-data-check/ フォルダと SKILL.md があります）。
フォルダごと、使うエージェントのスキル置き場にコピーします。
- Claude：~/.claude/skills/（プロジェクト単位なら .claude/skills/）
- Hermes Agent：~/.hermes/skills/
- Codex：~/.agents/skills/／Cursor：~/.cursor/skills/
- Claude アプリ（claude.ai）：「カスタマイズ → スキル」からZIPをアップロード
エージェントを再起動し、スキル一覧に表示されることを確認します。

Windows・Mac 別、エージェント別のインストール手順