ルールはコードではなく、単純なデータです。各ルールには、kind（text、attribute、structured、presence、count）、セレクター、演算子（equals、contains、matches、exists）を指定します。演算子matchesは、正規表現ではなく、範囲を限定したグロブパターンです。scan-extractは、保存したページ本文に対してルールを実行します。通信も書き込みもないため、ルールを直して、再クロールなしでもう一度実行できます。貼り付けたHTMLでCSS、XPath、正規表現の抽出を試すには、custom-extract-sampleを使います。
scan-content-searchは、生のHTML、headのマークアップ、本文テキスト、CSSセレクターに一致したマークアップから、文字列や正規表現を探します。GTMスニペットなどのマーカーがあるページを探すときに使います。一致した結果は新しいローカルパッケージに書き出されるため、結果を保管できます。
保存済みスキャンには、本文保持の上限内で、ページ本文がまるごと保存されます。以降のルールと検索は、稼働中のサイトではなく、このコピーに対して実行します。
ルールをJSONで書きます。kindはtext、attribute、structured、presence、count、演算子はequals、contains、matches（グロブ）、existsです。--inputかMCPツールでseohead scan-extractに渡します。何も取得せず、結果も保存しません。
scan-content-searchは、生のHTML、headのマークアップ、本文テキスト、CSSセレクターから、リテラルの文字列や正規表現を探し、ローカルパッケージを書き出します。結果はscan-content-search-pageで100行ずつ読みます。
| チェック項目 | 意味 | 重要度 | 根拠 |
|---|---|---|---|
TITLE_MISSING | title要素がありません。titleセレクターにkind textのルールを使うと、保存済みスキャン全体で同じ抜けを見つけられます。 | Critical | ページのURL。title要素がないか、空です |
CANONICAL_MISSING | インデックス可能なページに、canonical URLがありません。link[rel=canonical]にpresenceルールを使うと、canonicalがないページを一覧にできます。 | Important | ページのURL。canonicalリンクが見つかりません |
SCHEMA_VALIDATION_ERROR | 構造化データの検証エラーです。JSONポインターを指定したstructuredルールを使うと、エラーの原因になったJSON-LDの値を読めます。 | Important | ページのURLと、検証に失敗した構造化データの項目 |
STRUCTURED_DATA_MISSING | あるはずのページに、構造化データがありません。JSON-LDブロックにpresenceルールを使うと、構造化データのないページを確認できます。 | Tip | ページのURL。構造化データが見つかりません |
LOREM_IPSUM_PLACEHOLDER | ページのコンテンツ領域に、Lorem Ipsumのダミーテキストがあります。ダミーの文言でコンテンツ検索を行うと、スキャン全体から見つけられます。 | Important | ページのURLと、ダミーテキストに一致した件数 |
seohead scan-content-search --scan ./scans/audit.sqlite --query gtm.js先にインストールします: インストールガイド。どのコマンドも、AIエージェント向けのMCPツールとして実行できます。