ウェブサイト監査スキル

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 タグ
• 技術的な問題: 壊れたリンク、リダイレクト チェーン、ページ速度、モバイル フレンドリー性
• パフォーマンス: ページロード時間、リソース使用量、キャッシング
• コンテンツの品質: 見出し構造、画像の代替テキスト、コンテンツ分析
• セキュリティ: 漏洩したシークレット、HTTPS 使用、セキュリティ ヘッダー、混合コンテンツ
• アクセシビリティ: 代替テキスト、色コントラスト、キーボード ナビゲーション
• ユーザビリティ: フォーム検証、エラー処理、ユーザー フロー
• リンク: 壊れた内部リンクと外部リンクのチェック
• E-E-A-T: 専門知識、経験、権威、信頼性
• ユーザー エクスペリエンス: ユーザー フロー、エラー処理、フォーム検証
• モバイル: モバイル フレンドリー性、レスポンシブ デザイン、タッチ フレンドリーな要素のチェック
• クローラビリティ: クローラビリティ、robots.txt、sitemap.xml などのチェック
• スキーマ: Schema.org マークアップ、構造化データ、リッチ スニペット
• 法律: 法的要件への準拠、プライバシー ポリシー、サービス利用規約
• ソーシャル: Open Graph、Twitter カード、スキーマとスニペットの検証など
• URL 構造: 長さ、ハイフン、キーワード
• キーワード: キーワード スタッフィング
• コンテンツ: コンテンツ構造、見出し
• 画像: 代替テキスト、色コントラスト、画像サイズ、画像形式
• ローカル 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. 監査を実行 (データベースに保存し、コンソール出力を表示)
2. 目的の形式でレポートをエクスポート

# ステップ 1: 監査を実行 (デフォルト: コンソール出力)
squirrel audit https://example.com

# ステップ 2: LLM 形式でエクスポート
squirrel report <audit-id> --format llm

リグレッション Diff

監査間のリグレッションを検出する必要がある場合は、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 はサポートされていません。

監査の実行

監査を実行する場合:

1. レポートを表示 - ユーザーに監査結果とスコアを表示する
2. 修正を提案 - 修正できる問題をリストアップし、変更を加える前にユーザーに確認を求める
3. 承認された修正を並列化 - 代替テキスト、見出し、説明のバルク編集にサブエージェントを使用する
4. 反復 - 修正バッチ → 再監査 → 結果を提示 → 次のバッチを提案 → 繰り返す
5. 判断のために一時停止 - 壊れたリンク、構造的な変更、曖昧な点はすべてユーザーのレビュー用にフラグを立てるべきです
6. 変更前後を表示 - 各修正バッチの後、スコア比較を提示する

• 反復ループ: 問題のバッチを修正した後、以下のいずれかまで再監査して修正を続けます:

  • スコアがターゲットに達する (通常は 85+)、または
  • ユーザーの判断が必要な問題のみが残る (例: 「このリンクを削除する必要があるか?」)

• すべての修正を平等に扱う: コードの変更とコンテンツの変更は同等の重要性があります。

• コンテンツ修正を並列化: 複数のファイルに影響する問題の場合:

  • サブエージェントを生成して並列で修正する
  • 例: 7 ファイルに代替テキストが必要 → 1-2 のエージェントを生成してすべてを修正
  • 例: 30 ファイルに見出しの問題がある → エージェントを生成してバッチ編集する

• 完了基準:

  • ✅ すべてのエラーが修正されている
  • ✅ すべての警告が修正されている (またはユーザーレビューが必要として文書化されている)
  • ✅ 再監査が改善を確認している
  • ✅ 変更前後の比較がユーザーに表示されている

修正を適用した後、ユーザーに変更を確認したいかどうかを尋ねます。

スコア目標

開始スコア	目標スコア	予想される作業
< 50 (Grade F)	75+ (Grade C)	大幅な修正
50-70 (Grade D)	85+ (Grade B)	中程度の修正
70-85 (Grade C)	90+ (Grade A)	ポーリッシング
> 85 (Grade B+)	95+	微調整

サイトは、スコアが 95 以上 (Grade A) で、カバレッジが FULL (--coverage full) に設定されている場合にのみ、完全に修正されたもの と見なされます。

問題カテゴリ

カテゴリ	修正アプローチ	並列化可能
メタタグ/タイトル	ページ コンポーネントまたはメタデータを編集	いいえ
構造化データ	ページ テンプレートに JSON-LD を追加	いいえ
見出し 1 または見出しがない	ページ コンポーネント + コンテンツ ファイルを編集	はい (コンテンツ)
画像の代替テキスト	コンテンツ ファイルを編集	はい
見出し階層	コンテンツ ファイルを編集	はい
短い説明	コンテンツの frontmatter を編集	はい
HTTP→HTTPS リンク	コンテンツ内で検索と置換	はい
壊れたリンク	手動レビュー (ユーザーにフラグを立てる)	いいえ

並列化可能な修正の場合: 特定のファイル割り当てを含むサブエージェントを生成します。

コンテンツ ファイルの修正

多くの問題には、コンテンツ ファイルの編集が必要です。これはコードの修正と同等の重要性があります:

• 画像の代替テキスト: 画像に説明的な代替テキストを追加する
• 見出し階層: スキップされた見出しレベルを修正する
• メタ説明: frontmatter の短い説明を拡張する
• 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 スキルを更新

Self コマンド

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 より 40% 小さい) コンパクト XML/テキスト ハイブリッドです:

• 概要: 全体的なヘルス スコアと主要メトリクス
• カテゴリ別の問題: 監査ルール カテゴリ別 (コア SEO、技術的、コンテンツ、セキュリティ) でグループ化
• 壊れたリンク: 壊れた外部および内部リンクのリスト
• 推奨事項: 修正の提案を含む優先度付きのアクション アイテム

詳細な形式の仕様については、OUTPUT-FORMAT.md を参照してください。

例

例 1: LLM 出力を使用したクイック サイト監査

# ユーザーが質問: "squirrelscan.com の SEO 問題をチェック"
squirrel audit https://squirrelscan.com --format llm

例 2: 大規模サイト向けディープ監査

# ユーザーが質問: "最大 500 ページでブログを徹底的に監査"
squirrel audit https://myblog.com --max-pages 500 --format llm

例 3: 変更後の新規監査

# ユーザーが質問: "サイトを再監査し、キャッシュされた結果を無視"
squirrel audit https://example.com --refresh --format llm

例 4: 2 ステップ ワークフロー (以前の監査を再利用)

# 最初に監査を実行
squirrel audit https://example.com
# 出力から監査 ID を メモ (例: "a1b2c3d4")

# 後で別の形式でエクスポート
squirrel report a1b2c3d4 --format llm

出力

完了時に、ユーザーに行ったすべての変更のサマリーを提供します。

トラブルシューティング

squirrel コマンドが見つからない

このエラーが表示される場合は、squirrel がインストールされていないか、PATH に含まれていません。

解決方法:

1. squirrel をインストール: squirrelscan.com/download
2. ~/.local/bin が PATH に含まれていることを確認
3. 確認: squirrel --version

権限が拒否されました

squirrel が実行可能でない場合は、バイナリが実行権限を持っていることを確認します。squirrelscan.com/download から再インストールすると、これが修正されます。

クロール タイムアウトまたはパフォーマンスが低い

非常に大規模なサイトの場合、監査に数分かかる場合があります。--verbose を使用して進捗を確認してください:

squirrel audit https://example.com --format llm --verbose

無効な URL

URL にプロトコル (http:// または https://) が含まれていることを確認してください:

# ✗ 間違い
squirrel audit example.com

# ✓ 正しい
squirrel audit https://example.com

仕組み

1. クロール: ベース URL から開始してページを発見し取得
2. 分析: 各ページで監査ルールを実行
3. 外部リンク: 外部リンクの可用性をチェック
4. レポート: 調査結果を含む LLM 最適化レポートを生成

監査はローカル データベースに保存され、後で squirrel report コマンドで取得できます。

追加リソース

• 出力形式リファレンス: OUTPUT-FORMAT.md
• squirrelscan ドキュメント: https://docs.squirrelscan.com
• CLI ヘルプ: squirrel audit --help