SEO Drift Monitor (April 2026)

あなたのSEOのためのGit。ベースラインをキャプチャし、リグレッションを検出し、時系列で変更を追跡します。

---

コマンド

コマンド	目的
/seo drift baseline <url>	現在のSEO状態を「既知の良い状態」のスナップショットとしてキャプチャ
/seo drift compare <url>	現在のページ状態と保存されたベースラインを比較
/seo drift history <url>	変更履歴と過去の比較を表示

---

キャプチャ対象

すべてのベースラインは、これらのSEO重要要素を記録します:

要素	フィールド	ソース
Title タグ	title	parse_html.py
Meta description	meta_description	parse_html.py
Canonical URL	canonical	parse_html.py
Robots ディレクティブ	meta_robots	parse_html.py
H1 見出し	h1 (配列)	parse_html.py
H2 見出し	h2 (配列)	parse_html.py
H3 見出し	h3 (配列)	parse_html.py
JSON-LD スキーマ	schema (配列)	parse_html.py
Open Graph タグ	open_graph (辞書)	parse_html.py
Core Web Vitals	cwv (辞書)	pagespeed_check.py
HTTP ステータスコード	status_code	fetch_page.py
HTML コンテンツ ハッシュ	html_hash (SHA-256)	計算済み
スキーマ コンテンツ ハッシュ	schema_hash (SHA-256)	計算済み

---

比較の仕組み

比較エンジンは3つの重大度レベルにわたって17個のルールを適用します。完全なルールセット、閾値、推奨アクション、およびクロススキルリファレンスについては references/comparison-rules.md をロードしてください。

重大度レベル

レベル	意味	対応時間
CRITICAL	SEO を破壊する変更、トラフィック損失の可能性高い	直ちに
WARNING	潜在的な影響、調査が必要	1週間以内
INFO	認識目的のみ、意図的な可能性あり	都合がつき次第確認

---

ストレージ

すべてのデータはSQLiteでローカルに保存されます:

~/.cache/claude-seo/drift/baselines.db

テーブル

• baselines: すべてのSEO要素を含むキャプチャ済みスナップショット
• comparisons: トリガーされたルールと重大度を含む差分結果

URL正規化は一貫性のあるマッチングを保証します: スキーム/ホストを小文字に、デフォルトポート(80/443)を削除、クエリパラメータをソート、UTMパラメータを削除、末尾スラッシュを削除。

---

コマンド: baseline

ページの現在の状態をキャプチャして保存します。

ステップ:

1. URL を検証 (google_auth.validate_url() 経由SSRF保護)
2. scripts/fetch_page.py 経由でページをフェッチ
3. scripts/parse_html.py 経由でHTMLを解析
4. オプションで scripts/pagespeed_check.py 経由でCWVをフェッチ (--skip-cwv でスキップ可能)
5. HTMLボディとスキーマコンテンツをハッシュ (SHA-256)
6. スナップショットをSQLiteに保存

実行:

python scripts/drift_baseline.py <url>
python scripts/drift_baseline.py <url> --skip-cwv

出力: ベースラインID、タイムスタンプ、URL、およびキャプチャされた要素の概要を含むJSON。

---

コマンド: compare

現在のページ状態をフェッチして、最新のベースラインに対して差分を取ります。

ステップ:

1. URL を検証
2. SQLite から最新のベースラインをロード (または特定の --baseline-id)
3. 現在のページ状態をフェッチして解析
4. すべての17個の比較ルールを実行
5. 結果を重大度で分類
6. 比較結果を保存
7. JSON差分レポートを出力

実行:

python scripts/drift_compare.py <url>
python scripts/drift_compare.py <url> --baseline-id 5
python scripts/drift_compare.py <url> --skip-cwv

出力: トリガーされたすべてのルール、旧値/新値、重大度、およびアクションを含むJSON。

比較後、HTMLレポートを生成するオプションを提供します:

python scripts/drift_report.py <comparison_json_file> --output drift-report.html

---

コマンド: history

URL に関するすべてのベースラインと比較を表示します。

実行:

python scripts/drift_history.py <url>
python scripts/drift_history.py <url> --limit 10

出力: タイムスタンプと比較サマリーを含むベースラインの JSON配列 (最新が最初)。

---

クロススキル連携

ドリフトが検出された場合、適切な専門スキルを推奨します:

検出結果	推奨事項
スキーマが削除または変更された	/seo schema <url> を実行して完全な検証を行う
CWV リグレッション	/seo technical <url> を実行してパフォーマンス監査を行う
Title または meta description が変更された	/seo page <url> を実行してコンテンツ分析を行う
Canonical が変更または削除された	/seo technical <url> を実行してインデックス可能性チェックを行う
Noindex が追加された	/seo technical <url> を実行してクローラビリティ監査を行う
H1/見出し構造が変更された	/seo content <url> を実行してE-E-A-Tレビューを行う
OG タグが削除された	/seo page <url> を実行してソーシャルシェア分析を行う
ステータスコードがエラーに変更された	/seo technical <url> を実行して完全な診断を行う

---

エラーハンドリング

シナリオ	アクション
URL に到達不可	fetch_page.py からのエラーを報告。状態を推測しない。ユーザーにURL確認を提案。
URL のベースラインが存在しない	ユーザーに通知し、最初に baseline を実行することを提案。
SSRF ブロック (プライベートIP)	validate_url() 拒否を報告。バイパスしない。
SQLite データベースが見つからない	初回使用時に自動作成。エラーなし。
CWV フェッチが失敗 (APIキーなし)	CWV フィールドに null を保存。比較時にCWVルールをスキップ。
ページが4xx/5xx を返す	それでもベースラインとしてキャプチャ (ステータスコードは追跡対象フィールド)。
複数のベースラインが存在	--baseline-id が指定されない限り、最新のものを使用。

---

セキュリティ

• すべてのURL取得 は scripts/fetch_page.py を通じて行われ、SSRF保護を強制 (プライベートIP、ループバック、予約済み範囲、GCPメタデータエンドポイントをブロック)
• curl やsubprocess HTTP呼び出しなし -- プロジェクトの検証済みフェッチパイプラインのみ
• すべてのSQLiteクエリ はパラメータ化プレースホルダ (?) を使用、文字列補間はなし
• TLS は常に検証 -- パイプラインのどこにも verify=False はなし

---

典型的なワークフロー

デプロイ前後のチェック

/seo drift baseline https://example.com     # デプロイ前
# ... デプロイが実施される ...
/seo drift compare https://example.com      # デプロイ後

継続的なモニタリング

/seo drift baseline https://example.com     # 初期キャプチャ
# ... 数週間後 ...
/seo drift compare https://example.com      # ドリフトをチェック
/seo drift history https://example.com      # すべての変更を確認

トラフィック低下の調査

/seo drift compare https://example.com      # 何が変わった?
/seo drift history https://example.com      # いつ変わった?