SEO監査スキル
SEOmator CLIを使用して、WebサイトのSEO、技術面、コンテンツ、パフォーマンス、セキュリティ、JavaScriptレンダリング、AI対応状況を監査します。
SEOmatorは、251ルール・20カテゴリにわたってWebサイトの構造とコンテンツを分析し、包括的なWebサイト監査を提供します。
問題の重大度、影響を受けるURL、および実行可能な修正提案のリストを出力します。
リンク
- SEOmator npmパッケージ: npmjs.com/package/@seomator/seo-audit
- GitHubリポジトリ: github.com/seo-skills/seo-audit-skill
- Web UI: seomator.com/free-seo-audit-tool
このスキルが行うこと
このスキルにより、AIエージェントは20カテゴリ、251ルールにわたってWebサイトを監査できます。主なカテゴリは以下の通りです:
- コアSEO (19ルール): 正規URL、インデックス指示、タイトルの一意性、正規URLの競合/ループ
- パフォーマンス (22ルール): LCP、CLS、FCP、TTFB、INP、圧縮、キャッシュ、ミニフィケーション、HTTP/2
- リンク (19ルール): 壊れたリンク、リダイレクトチェーン、アンカーテキスト、孤立ページ、localhost/フラグメントリンク
- 画像 (14ルール): Altテキスト、寸法、遅延読み込み、モダンフォーマット、altテキスト長、背景画像
- セキュリティ (16ルール): HTTPS、HSTS、CSP、外部リンクの安全性、漏洩したシークレット、SSL有効期限/プロトコル
- 技術SEO (13ルール): robots.txt、sitemap.xml、URL構造、404ページ、ソフト404、エラーコード
- クローラビリティ (18ルール): Sitemapの競合、インデックス可能性シグナル、正規URLチェーン、ページネーション問題
- 構造化データ (13ルール): Schema.orgマークアップ、Article、Organization、FAQ、Product、Breadcrumb
- JavaScriptレンダリング (13ルール): レンダリングされたDOMチェック、生DOMとレンダリング後の不一致、SSR検出
- アクセシビリティ (12ルール): ARIAラベル、色のコントラスト、フォームラベル、ランドマーク、タッチターゲット
- コンテンツ (17ルール): 単語数、可読性、キーワード密度、重複検出、ピクセル幅
- ソーシャル (9ルール): Open Graphタグ、Twitterカード、共有ボタン、プロフィールリンク
- E-E-A-T (14ルール): 著者情報、引用、信頼シグナル、概要/お問い合わせページ、YMYL検出
- URL構造 (14ルール): キーワードスラッグ、ストップワード、大文字、アンダースコア、セッションID、トラッキングパラメータ
- リダイレクト (8ルール): リダイレクトループ、タイプ(301/302)、メタリフレッシュ、JavaScriptリダイレクト、壊れたリダイレクト
- モバイル (5ルール): フォントサイズ、横スクロール、侵入型インタースティシャル、ビューポート問題
- 国際化 (10ルール): lang属性、hreflang検証(戻りリンク、競合、不一致)
- HTML検証 (9ルール): ドキュメントタイプ、charset、head構造、Lorem ipsum、複数のタイトル/説明
- AI/GEO対応 (5ルール): セマンティックHTML、AIボットアクセス、llms.txt、スキーマのドリフト
- 法的コンプライアンス (1ルール): Cookie同意
監査はWebサイトをクロールし、各ページを監査ルールに対して分析し、以下を含む包括的なレポートを返します:
- 総合ヘルススコア(0-100)と文字グレード(A-F)
- カテゴリ別の合格/警告/不合格の内訳
- 特定された問題と、問題ごとにグループ化された影響を受けるURL
- 実行可能な修正の推奨事項
使用すべきタイミング
以下の場合にこのスキルを使用します:
- WebサイトのSEO健全性を分析する
- 技術的なSEO問題をデバッグする
- 壊れたリンクやリダイレクトチェーンを確認する
- メタタグ、正規URL、構造化データを検証する
- セキュリティヘッダー、SSL、HTTPSを監査する
- アクセシビリティコンプライアンスを確認する
- JavaScriptレンダリングとSSR互換性を分析する
- AI/GEO対応状況(セマンティックHTML、llms.txt、ボットアクセス)を評価する
- ページ間の重複コンテンツを検出する
- hreflangと国際化設定を検証する
- HTML文書構造と検証を確認する
- 複数の形式でサイト監査レポートを生成する
- 変更前後のサイト健全性を比較する
前提条件
このスキルを使用するには、SEOmator CLIがインストールされている必要があります。
インストール
npm install -g @seomator/seo-audit
インストールの確認
seomatorがインストールされ、システムが準備できていることを確認します:
seomator self doctor
これにより以下をチェックします:
- Node.jsバージョン(18以上推奨)
- npmの利用可能性
- Core Web VitalsとJSレンダリング用のChrome/Chromium
- ~/.seomatorへの書き込み権限
- ローカル設定ファイルの存在
セットアップ
seomator initを実行すると、カレントディレクトリにseomator.toml設定ファイルが作成されます。
seomator init # 対話型セットアップ
seomator init -y # デフォルト設定を使用
seomator init --preset blog # ブログ最適化設定
seomator init --preset ecommerce # ECサイト設定
seomator init --preset ci # 最小限のCI設定
ディレクトリにseomator.tomlが存在しない場合は、監査を実行する前に seomator init で作成してください。
使用方法
AIエージェントのベストプラクティス
--format llmを常に優先してください - これはAIエージェント向けに特別に設計されたトークン最適化されたXML出力を提供します(JSONよりも50~70%縮小)。
監査時の注意点:
- 精度の高いパフォーマンスとレンダリングデータを得るには、ローカル開発サーバーよりも本番Webサイトを優先してください
- Core Web VitalsとJSレンダリングチェックが不要な場合は、
--no-cwvを使用して監査を高速化します - 複数の修正を実装する場合は、並行タスクとして範囲を分割します
- 修正実装後は型チェック/フォーマット(tsc、eslint、prettierなど)を実行します
Webサイトの特定
ユーザーが監査するWebサイトを指定しない場合:
- ローカル開発サーバーの設定(package.jsonのscripts、.envファイル)を確認します
- Vercel/Netlifyのプロジェクトリンクを探します
- 環境変数でデプロイメントURLを確認します
- 監査するURLをユーザーに尋ねます
ローカルサイトと本番サイトの両方が利用可能な場合は、正確な結果を得るために本番サイトの監査を提案します。
基本的なワークフロー
# LLM出力を使用した迅速な単一ページ監査
seomator audit https://example.com --format llm --no-cwv
# マルチページクロール(最大50ページ)
seomator audit https://example.com --crawl -m 50 --format llm --no-cwv
# Core Web Vitals + JSレンダリング分析を含む完全監査
seomator audit https://example.com --crawl -m 20 --format llm
高度なオプション
キャッシュを無視して強制的に新規クロール:
seomator audit https://example.com --refresh --format llm
中断されたクロールを再開:
seomator audit https://example.com --resume --format llm
特定のカテゴリのみを監査:
seomator audit https://example.com -c core,security,js --format llm --no-cwv
共有用のHTMLレポートを保存:
seomator audit https://example.com --format html -o report.html
デバッグ用の詳細出力:
seomator audit https://example.com --format llm -v
コマンドリファレンス
監査コマンドオプション
| オプション | エイリアス | 説明 | デフォルト |
|---|---|---|---|
--format <fmt> | -f | 出力形式: console, json, html, markdown, llm | console |
--max-pages <n> | -m | クロールする最大ページ数 | 10 |
--crawl | マルチページクロールを有効化 | false | |
--categories <list> | -c | 監査するカテゴリのカンマ区切りリスト | すべて |
--refresh | -r | キャッシュを無視して新規取得 | false |
--resume | 中断されたクロールを再開 | false | |
--no-cwv | Core Web Vitals + JSレンダリングをスキップ | false | |
--verbose | -v | 進捗を表示 | false |
--output <path> | -o | 出力ファイルパス | |
--config <path> | 設定ファイルパス | ||
--save | ~/.seomatorに保存 | false |
その他のコマンド
seomator init # 設定ファイルを作成
seomator self doctor # システムセットアップを確認
seomator config --list # すべての設定値を表示
seomator report --list # 過去のレポートを一覧表示
seomator db stats # データベース統計を表示
出力形式
| 形式 | フラグ | 最適な用途 |
|---|---|---|
| console | --format console | 人間向けターミナル出力(デフォルト) |
| json | --format json | CI/CD、プログラム処理 |
| html | --format html | スタンドアロンレポート、共有 |
| markdown | --format markdown | ドキュメント、GitHub |
| llm | --format llm | AIエージェント(推奨) |
--format llm出力は、トークン効率のために最適化されたコンパクトなXML形式です:
- JSON出力と比較して50~70%縮小
- 問題は重大度順にソート(クリティカルが最初)
- 各問題に修正提案が含まれます
- AIツールへのパイプラインに適したクリーンなstdout
使用例
例1: LLM出力を使用した迅速な監査
# ユーザー: 「example.comのSEO問題を確認して」
seomator audit https://example.com --format llm --no-cwv
例2: 大規模サイトの詳細クロール
# ユーザー: 「最大100ページまで詳細に監査して」
seomator audit https://example.com --crawl -m 100 --format llm --no-cwv
例3: 変更後の新規監査
# ユーザー: 「キャッシュされた結果は無視して、サイトを再監査して」
seomator audit https://example.com --refresh --format llm --no-cwv
例4: 共有可能なレポートの生成
# ユーザー: 「共有できるHTMLレポートを作成して」
seomator audit https://example.com --crawl -m 20 --format html -o seo-report.html
例5: 特定領域にフォーカス
# ユーザー: 「JavaScriptレンダリングとリダイレクトだけ確認して」
seomator audit https://example.com -c js,redirect --format llm
結果の評価
スコア範囲
| スコア | グレード | 意味 |
|---|---|---|
| 90-100 | A | 優秀 - 軽微な最適化のみ |
| 80-89 | B | 良好 - 警告に対処すべき |
| 70-79 | C | 改善が必要 - 優先的な修正が必要 |
| 50-69 | D | 不良 - 複数のクリティカルな問題 |
| 0-49 | F | 重大 - 解決すべき主要な問題 |
優先順位(カテゴリの重み順)
最大の効果を得るために、以下の順序で問題を修正してください:
- コア (12%) - メタタグ、正規URL、H1、インデックス
- パフォーマンス (12%) - Core Web Vitals + 最適化
- リンク (8%) - 内部リンク構造
- 画像 (8%) - パフォーマンス + アクセシビリティ
- セキュリティ (8%) - 信頼シグナル、SSL
- 技術SEO (7%) - クローリングの基盤
- クローラビリティ (5%) - インデックス可能性、ページネーション
- 構造化データ (5%) - リッチスニペット
- JavaScriptレンダリング (5%) - レンダリングされたDOM、SSR
- コンテンツ (5%) - テキスト品質 + 重複
- アクセシビリティ (4%) - WCAG準拠
- ソーシャル (3%) - ソーシャルシェア
- E-E-A-T (3%) - 信頼性、専門性
- URL構造 (3%) - URLの衛生
- リダイレクト (3%) - リダイレクトチェーン
- モバイル (2%) - ビューポート、フォント
- 国際化 (2%) - hreflang
- HTML検証 (2%) - 文書構造
- AI/GEO対応 (2%) - セマンティックHTML、AIボット
- 法的コンプライアンス (1%) - Cookie同意
重大度別の修正
- 不合格 (status: "fail") - 直ちに修正が必要
- 警告 (status: "warn") - 近いうちに修正すべき
- 合格 (status: "pass") - アクション不要
出力サマリー
修正を実装した後、ユーザーに行ったすべての変更のサマリーを提供します。
範囲を計画する際は、実装を高速化するためにサブエージェントとして並行実行できるようにタスクを整理します。
トラブルシューティング
seomatorコマンドが見つからない
このエラーが表示された場合、seomatorがインストールされていないか、PATHに含まれていません。
解決策:
npm install -g @seomator/seo-audit
Core Web Vitalsが測定されない
CWVメトリクスが欠落している場合、Chrome/Chromiumが利用できない可能性があります。
解決策:
- Chrome、Chromium、またはEdgeをインストールします
seomator self doctorを実行してブラウザ検出を確認します- CWVが不要な場合は
--no-cwvを使用してスキップします
クロールのタイムアウトまたはパフォーマンス低下
大規模なサイトの場合、監査に数分かかる場合があります。
解決策:
--verboseを使用して進捗を確認します-m 20でページ数を制限して結果を高速化します--no-cwvを使用してブラウザベースの測定をスキップします
無効なURL
URLにプロトコルが含まれていることを確認してください:
# 間違い
seomator audit example.com
# 正しい
seomator audit https://example.com
仕組み
- 取得: ページのHTMLをダウンロードし、応答時間を計測します
- 解析: DOM、メタタグ、リンク、画像、構造化データを抽出します
- 拡充: 監査ごとにrobots.txtとsitemap.xmlを1回取得します
- レンダリング(CWV有効時): Playwrightを介してレンダリングされたDOMをキャプチャし、JSレンダリング分析を行います
- クロール(有効時): リンク先のページを発見して取得します
- 分析: 各ページに対して251の監査ルールを実行します
- スコアリング: カテゴリ別および総合的な重み付けスコアを計算します
- レポート: 要求された形式で出力を生成します
結果は~/.seomator/に保存され、後でseomator reportで取得できます。
リソース
- 全ルールリファレンス: すべての251ルールについては
docs/SEO-AUDIT-RULES.mdを参照 - ストレージアーキテクチャ: データベースの詳細については
docs/STORAGE-ARCHITECTURE.mdを参照 - CLIヘルプ:
seomator --helpおよびseomator <command> --help