1段階目では、マークアップがSchema.orgとして正しいかを確認します。タイプが存在するか、そのタイプでプロパティが使えるか（継承されたプロパティも含む）、値が期待される型に合っているかを調べます。2段階目では、Googleのリッチリザルトについて、必須プロパティなど手元で確認できる条件を調べます。2段階目に通っても、Googleがリッチリザルトを表示する保証はありません。
エンティティは@idの参照でつながります。チェッカーは、@idを持つエンティティ、リンクされているエンティティ、孤立しているエンティティ、どこも指していない参照を洗い出します。孤立したエンティティは有用な検出結果です。検索エンジンがページの他の部分と結びつけられないためです。
schema-buildは、ページのタイプに合わせて、つながった@graphの下書きを作ります。使うのはページ上で確認できる事実だけです。判断に使った手がかりと、タイプの推定にどのくらい自信があるかも表示します。推定が不確かなときは--typeでタイプを自分で指定し、公開する前に下書きを確認します。
schema-checkはページの構造化データを読み取り、すべてのタイプとプロパティを、同梱のSchema.orgボキャブラリーに照らして確認します。
@idを持つエンティティ、リンクされているエンティティ、孤立しているエンティティ、どこも指していない@id参照を洗い出します。
schema-buildは、ページ上で確認できる事実だけを使って、つながった@graphを提案し、まだ不足している推奨フィールドを一覧にします。
| チェック項目 | 意味 | 重要度 | 根拠 |
|---|---|---|---|
SCHEMA_VALIDATION_ERROR | ページの構造化データに、Schema.orgボキャブラリーに照らした検証エラーがある | Important | ページごとの検証エラー数 |
STRUCTURED_DATA_PARSE_ERROR | JSON-LDブロックはあるが有効なJSONとして解析できず、検索エンジンに無視される | Important | 検出したブロック数と解析できたブロック数 |
STRUCTURED_DATA_MISSING | ページにSchema.orgのマークアップがない | Tip | 構造化データのブロックが0件のページ |
STRUCTURED_DATA_SCHEMA_ERRORSTRUCTURED_DATA_SCHEMA_WARNINGSTRUCTURED_DATA_RICH_RESULT_REQUIRED_MISSINGseohead schema-check --url https://example.com/product先にインストールします: インストールガイド。どのコマンドも、AIエージェント向けのMCPツールとして実行できます。