ウェブサイト監査スキル
squirrelscan CLI を使用して、ウェブサイトのSEO、技術、コンテンツ、パフォーマンス、セキュリティの問題を監査します。
squirrelscanは、macOS、Windows、Linuxで利用可能なCLIツール「squirrel」を提供します。ブラウザと検索クローラーをエミュレートし、230以上のルールに照らしてウェブサイトの構造とコンテンツを分析することで、広範なウェブサイト監査を実行します。
問題のリストとその修正方法に関する提案を提供します。
リンク
- squirrelscanのウェブサイトは https://squirrelscan.com
- ドキュメント(ルールリファレンスを含む)は docs.squirrelscan.com
以下のテンプレートを使用して、任意のルールのドキュメントを調べることができます:
https://docs.squirrelscan.com/rules/{rule_category}/{rule_id}
例:
https://docs.squirrelscan.com/rules/links/external-links
このスキルの機能
このスキルにより、AIエージェントは21カテゴリ、230以上のルールにわたってウェブサイトを監査できます。以下を含みます:
- SEOの問題: メタタグ、タイトル、説明、正規URL、Open Graphタグ
- 技術的な問題: 壊れたリンク、リダイレクトチェーン、ページ速度、モバイルフレンドリー性
- パフォーマンス: ページ読み込み時間、リソース使用量、キャッシュ
- コンテンツ品質: 見出し構造、画像のaltテキスト、コンテンツ分析
- セキュリティ: リークされたシークレット、HTTPSの使用、セキュリティヘッダー、混合コンテンツ
- アクセシビリティ: altテキスト、色のコントラスト、キーボードナビゲーション
- ユーザビリティ: フォーム検証、エラーハンドリング、ユーザーフロー
- リンク: 内部リンクと外部リンクの壊れチェック
- E-E-A-T: 専門性、経験、権威性、信頼性
- ユーザーエクスペリエンス: ユーザーフロー、エラーハンドリング、フォーム検証
- モバイル: モバイルフレンドリー性、レスポンシブデザイン、タッチフレンドリーな要素のチェック
- クローラビリティ: クローラビリティ、robots.txt、sitemap.xmlなどのチェック
- スキーマ: Schema.orgマークアップ、構造化データ、リッチスニペット
- 法的: 法的要件、プライバシーポリシー、利用規約への準拠
- ソーシャル: Open Graph、Twitter Cards、スキーマ、スニペットなどの検証
- URL構造: 長さ、ハイフン、キーワード
- キーワード: キーワードスタッフィング
- コンテンツ: コンテンツ構造、見出し
- 画像: altテキスト、色のコントラスト、画像サイズ、画像形式
- ローカルSEO: NAPの一貫性、ジオメタデータ
- 動画: VideoObjectスキーマ、アクセシビリティ
など
監査はウェブサイトをクロールし、各ページを監査ルールに照らして分析し、包括的なレポートを返します:
- 全体的なヘルススコア(0~100)
- カテゴリ別内訳(コアSEO、テクニカルSEO、コンテンツ、セキュリティ)
- 影響を受けるURLを含む具体的な問題
- 壊れたリンクの検出
- 実行可能な推奨事項
- ルールにはエラー、警告、通知のレベルがあり、1~10のランクが付与されます
使用タイミング
以下の場合にこのスキルを使用します:
- ウェブサイトの健全性を分析する
- テクニカルSEOの問題をデバッグする
- 上記のすべての問題を修正する
- 壊れたリンクをチェックする
- メタタグと構造化データを検証する
- サイト監査レポートを生成する
- 変更前後のサイトの健全性を比較する
- ウェブサイトのパフォーマンス、アクセシビリティ、SEO、セキュリティなどを改善する
ウェブサイトの健全性を維持し、良好なパフォーマンスを確保するために、可能な限り頻繁に再監査する必要があります。
前提条件
このスキルには、squirrel CLIがインストールされ、PATHに含まれている必要があります。
インストール: squirrelscan.com/download
確認:
squirrel --version
セットアップ
squirrel init を実行して、カレントディレクトリに squirrel.toml 設定ファイルを作成します。存在しない場合は作成し、プロジェクト名を指定します:
squirrel init -n my-project
# 既存の設定を上書きする場合
squirrel init -n my-project --force
使い方
はじめに
実行できる3つのプロセスがあり、これらはすべてローカルプロジェクトデータベースにキャッシュされます:
- crawl - クロールを実行、リフレッシュ、または再開するサブコマンド
- analyze - クロール結果を分析するサブコマンド
- report - 希望する形式(llm、text、console、htmlなど)でレポートを生成するサブコマンド
'audit' コマンドはこれら3つのプロセスのラッパーであり、順次実行します:
squirrel audit https://example.com --format llm
常に format オプションの llm を優先してください。これはあなたのために作られたもので、網羅的かつコンパクトな出力形式を提供します。
最初のスキャンはサーフェススキャンにすべきです。これはウェブサイトの簡単で浅いスキャンであり、構造、コンテンツ、テクノロジースタックなどの基本情報を収集します。このスキャンは迅速に行え、ウェブサイトのパフォーマンスに影響を与えません。
2回目のスキャンはディープスキャンにすべきです。これはウェブサイトの詳細なスキャンであり、セキュリティ、パフォーマンス、アクセシビリティなどの詳細情報を収集します。このスキャンは時間がかかり、ウェブサイトのパフォーマンスに影響を与える可能性があります。
ユーザーが監査するウェブサイトを提供しない場合は、どのURLを監査したいか尋ねてください。
ライブウェブサイトを監査することを優先してください。ライブサイトでのみ、ウェブサイトの真の表現、パフォーマンス、レンダリングの問題を得ることができます。
ローカルサイトとライブサイトの両方を監査する必要がある場合は、ユーザーにどちらを監査するか選択するよう促し、ライブサイトを選択することを提案してください。
監査からの修正を、ライブサイトからローカルコードに適用できます。
スコープタスクを計画する際は、サブエージェントが同時に実行して修正を高速化できるようにします。
修正を実装する際は、サブエージェントを活用して修正の実装を高速化します。
修正を適用した後、コードがまだビルドされ、プロジェクトの既存のチェックに合格することを確認します。
基本ワークフロー
監査プロセスは2つのステップで構成されます:
- 監査を実行(データベースに保存、コンソール出力を表示)
- 希望する形式でレポートをエクスポート
# ステップ1: 監査を実行(デフォルト: コンソール出力)
squirrel audit https://example.com
# ステップ2: LLM形式でエクスポート
squirrel report <audit-id> --format llm
回帰差分
監査間の回帰を検出する必要がある場合は、diffモードを使用します:
# 現在のレポートをベースラインの監査IDと比較
squirrel report --diff <audit-id> --format llm
# 最新のドメインレポートをベースラインドメインと比較
squirrel report --regression-since example.com --format llm
diffモードは console、text、json、llm、markdown をサポートしています。html と xml はサポートされていません。
監査の実行
監査を実行する場合:
- レポートを提示 - ユーザーに監査結果とスコアを表示する
- 修正案を提案 - 修正可能な問題をリストアップし、変更を行う前にユーザーに確認を求める
- 承認された修正を並列化 - サブエージェントを使用してバルクコンテンツ編集(altテキスト、見出し、説明文)を行う
- 反復 - 修正バッチ → 再監査 → 結果提示 → 次のバッチを提案
- 判断のための一時停止 - 壊れたリンク、構造変更、あいまいなものはユーザーレビュー用にフラグを立てる
- Before/Afterを表示 - 各修正バッチ後にスコア比較を提示する
-
反復ループ: 問題のバッチを修正した後、再監査し、以下のいずれかが達成されるまで修正を続けます:
- スコアが目標(通常85以上)に達する、または
- 人間の判断が必要な問題のみが残っている場合(例:「このリンクは削除すべきですか?」)
-
すべての修正を同等に扱う: コード変更とコンテンツ変更は同じくらい重要です。
-
コンテンツ修正を並列化: 複数のファイルに影響する問題の場合:
- サブエージェントを生成して並行して修正
- 例: 7つのファイルにaltテキストが必要 → 1~2のエージェントを生成してすべて修正
- 例: 30のファイルに見出しの問題がある → エージェントを生成してバッチ編集
-
完了基準:
- ✅ すべてのエラーが修正された
- ✅ すべての警告が修正された(または人間のレビューが必要として文書化された)
- ✅ 再監査で改善が確認された
- ✅ Before/Afterの比較がユーザーに表示された
修正が適用された後、ユーザーに変更を確認するかどうかを尋ねます。
スコア目標
| 開始スコア | 目標スコア | 期待される作業 |
|---|---|---|
| < 50 (Fグレード) | 75以上 (Cグレード) | 大規模な修正 |
| 50-70 (Dグレード) | 85以上 (Bグレード) | 中程度の修正 |
| 70-85 (Cグレード) | 90以上 (Aグレード) | 微調整 |
| > 85 (B+グレード) | 95以上 | 微調整 |
サイトは、スコアが95以上(Aグレード)で、カバレッジがFULL(--coverage full)に設定されている場合のみ、COMPLETEかつFIXEDと見なされます。
問題カテゴリ
| カテゴリ | 修正アプローチ | 並列化可能 |
|---|---|---|
| メタタグ/タイトル | ページコンポーネントまたはメタデータを編集 | いいえ |
| 構造化データ | ページテンプレートにJSON-LDを追加 | いいえ |
| H1/見出しの欠落 | ページコンポーネント + コンテンツファイルを編集 | はい(コンテンツ) |
| 画像のaltテキスト | コンテンツファイルを編集 | はい |
| 見出し階層 | コンテンツファイルを編集 | はい |
| 短い説明文 | コンテンツのフロントマターを編集 | はい |
| HTTP→HTTPSリンク | コンテンツ内を検索して置換 | はい |
| 壊れたリンク | 手動レビュー(ユーザーにフラグ) | いいえ |
並列化可能な修正の場合: 特定のファイル割り当てでサブエージェントを生成します。
コンテンツファイルの修正
多くの問題はコンテンツファイルの編集を必要とします。これらはコード修正と同様に重要です:
- 画像のaltテキスト: 画像に説明的なaltテキストを追加
- 見出し階層: スキップされた見出しレベルを修正
- メタ説明文: フロントマターの短い説明文を拡張
- HTTPリンク: 安全でないリンクをHTTPSに更新
サブエージェントを使用した修正の並列化
ユーザーが修正のバッチを承認した場合、サブエージェントを使用してそれらを並行して適用できます:
- 最初にユーザーに確認 — サブエージェントを生成する前に、適用する修正を常に確認する
- 同じ修正タイプの場合、サブエージェントごとに3〜5ファイルをグループ化
- 独立したファイルのみを並列化(共有コンポーネントや設定は不可)
- 同時実行のために1つのメッセージで複数のサブエージェントを生成
高度なオプション
より多くのページを監査:
squirrel audit https://example.com --max-pages 200
強制的に新しいクロールを実行(キャッシュを無視):
squirrel audit https://example.com --refresh
中断されたクロールを再開:
squirrel audit https://example.com --resume
デバッグ用の冗長出力:
squirrel audit https://example.com --verbose
共通オプション
監査コマンドオプション
| オプション | エイリアス | 説明 | デフォルト |
|---|---|---|---|
--format <fmt> | -f <fmt> | 出力形式: console, text, json, html, markdown, llm | console |
--coverage <mode> | -C <mode> | カバレッジモード: quick, surface, full | surface |
--max-pages <n> | -m <n> | クロールする最大ページ数(最大5000) | カバレッジによって異なる |
--output <path> | -o <path> | 出力ファイルパス | - |
--refresh | -r | キャッシュを無視し、すべてのページを新たに取得 | false |
--resume | - | 中断されたクロールを再開 | false |
--verbose | -v | 冗長出力 | false |
--debug | - | デバッグログ | false |
--trace | - | パフォーマンストレースを有効化 | false |
--project-name <name> | -n <name> | プロジェクト名を上書き | 設定ファイルから |
カバレッジモード
監査のニーズに基づいてカバレッジモードを選択します:
| モード | デフォルトページ数 | 動作 | ユースケース |
|---|---|---|---|
quick | 25 | シード + サイトマップのみ、リンク探索なし | CIチェック、高速ヘルスチェック |
surface | 100 | URLパターンごとに1サンプル | 一般的な監査(デフォルト) |
full | 500 | 制限まで全てをクロール | 詳細分析 |
Surfaceモードはスマートです - /blog/{slug} や /products/{id} などのURLパターンを検出し、パターンごとに1サンプルのみクロールします。これにより、多くの類似ページを持つサイト(ブログ、eコマース)で効率的です。
# クイックヘルスチェック(25ページ、リンク探索なし)
squirrel audit https://example.com -C quick --format llm
# デフォルトのサーフェス監査(100ページ、パターンサンプリング)
squirrel audit https://example.com --format llm
# フル包括監査(500ページ)
squirrel audit https://example.com -C full --format llm
# 任意のモードでページ制限を上書き
squirrel audit https://example.com -C surface -m 200 --format llm
各モードを使用するタイミング:
quick: CIパイプライン、毎日のヘルスチェック、監視surface: ほとんどの監査 - ユニークなテンプレートを効率的にカバーfull: ローンチ前、包括的分析、詳細調査
レポートコマンドオプション
| オプション | エイリアス | 説明 |
|---|---|---|
--list | -l | 最近の監査を一覧表示 |
--severity <level> | - | 重大度でフィルター: error, warning, all |
--category <cats> | - | カテゴリでフィルター(カンマ区切り) |
--format <fmt> | -f <fmt> | 出力形式: console, text, json, html, markdown, xml, llm |
--output <path> | -o <path> | 出力ファイルパス |
--input <path> | -i <path> | JSONファイルから読み込み(フォールバックモード) |
設定サブコマンド
| コマンド | 説明 |
|---|---|
config show | 現在の設定を表示 |
config set <key> <value> | 設定値を設定 |
config path | 設定ファイルのパスを表示 |
config validate | 設定ファイルを検証 |
その他のコマンド
| コマンド | 説明 |
|---|---|
squirrel feedback | squirrelscanチームにフィードバックを送信 |
squirrel skills install | Claude Codeスキルをインストール |
squirrel skills update | Claude Codeスキルを更新 |
自己管理コマンド
squirrel self 以下の自己管理コマンド:
| コマンド | 説明 |
|---|---|
self install | ローカルインストールをブートストラップ |
self update | 更新を確認して適用 |
self completion | シェル補完を生成 |
self doctor | ヘルスチェックを実行 |
self version | バージョン情報を表示 |
self settings | CLI設定を管理 |
self uninstall | システムからsquirrelを削除 |
出力形式
コンソール出力(デフォルト)
audit コマンドはデフォルトで人間が読めるコンソール出力を、色付き出力と進捗インジケーターとともに表示します。
LLM形式
LLM最適化出力を得るには、report コマンドを --format llm とともに使用します:
squirrel report <audit-id> --format llm
LLM形式はコンパクトなXML/テキストハイブリッドで、トークン効率に最適化されています(冗長なXMLよりも40%小さい):
- 概要: 全体的なヘルススコアと主要な指標
- カテゴリ別の問題: 監査ルールカテゴリごとにグループ化(コアSEO、テクニカル、コンテンツ、セキュリティ)
- 壊れたリンク: 壊れたリンクのリスト
...