audit-website

（中文）Website Audit Skill

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
# overwrite existing config
squirrel init -n my-project --force

使用方法

はじめに

実行できるプロセスは3つあり、すべてローカルプロジェクトのデータベースにキャッシュされます。

• crawl - クロールまたは更新を実行する、あるいはクロールを続行するサブコマンド
• analyze - クロール結果を分析するサブコマンド
• report - 希望する形式（llm、text、console、html など）でレポートを生成するサブコマンド

「audit」コマンドは、これら3つのプロセスを順番に実行するラッパーです。

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

必ずフォーマットオプション「llm」を優先してください。これはあなた向けに作られており、網羅的かつ簡潔な出力形式を提供します。

最初のスキャンは表層スキャンにしてください。ウェブサイトの構造、コンテンツ、技術スタックなどの基本情報を収集するための、迅速で浅いスキャンです。このスキャンは短時間で実行でき、ウェブサイトのパフォーマンスに影響を与えません。

2回目のスキャンは詳細スキャンにしてください。ウェブサイトのセキュリティ、パフォーマンス、アクセシビリティなどについて、より多くの情報を収集するための、徹底的で詳細なスキャンです。このスキャンは時間がかかる場合があり、ウェブサイトのパフォーマンスに影響を与える可能性があります。

ユーザーが監査対象のウェブサイトを指定しない場合は、監査したい URL を尋ねてください。

ウェブサイトを監査する場合は、ライブサイトを優先してください。ウェブサイトの実態やパフォーマンス、レンダリング上の問題を正確に把握できるのはライブサイトだけです。

ローカルサイトとライブサイトの両方が監査対象となる場合は、どちらを監査するかユーザーに尋ね、ライブサイトを選ぶよう提案してください。

監査で見つかった問題への修正を、ライブサイトに対してローカルコードから適用できます。

タスクの範囲を計画する際は、修正を高速化するため、サブエージェントとして並行して実行できるようにしてください。

修正を実装する際は、実装を高速化するためにサブエージェントを活用してください。

修正を適用した後は、コードが引き続きビルドでき、プロジェクトに既存のチェックがあればそれらに合格することを確認してください。

基本的なワークフロー

監査プロセスは2つのステップで構成されます。

1. 監査を実行する（データベースに保存し、コンソールに出力を表示します）
2. レポートをエクスポートする（希望する形式で出力します）

# Step 1: Run audit (default: console output)
squirrel audit https://example.com

# Step 2: Export as LLM format
squirrel report <audit-id> --format llm

リグレッション差分

監査間のリグレッションを検出するには、差分モードを使用してください。

# Compare current report against a baseline audit ID
squirrel report --diff <audit-id> --format llm

# Compare latest domain report against a baseline domain
squirrel report --regression-since example.com --format llm

差分モードでは、console、text、json、llm、markdown をサポートしています。html と xml はサポートしていません。

監査の実行

監査を実行する際は、次の手順に従ってください。

1. レポートを提示する - 監査結果とスコアをユーザーに示します
2. 修正を提案する - 修正可能な問題を列挙し、変更を加える前にユーザーの承認を得ます
3. 承認済みの修正を並行して行う - 代替テキスト、見出し、説明など、コンテンツの一括編集にはサブエージェントを使用します
4. 繰り返す - 修正のまとまりごとに、修正 → 再監査 → 結果の提示 → 次の修正の提案を行います
5. 判断を仰ぐ - リンク切れ、構造上の変更、その他判断が曖昧なものは、ユーザーによる確認が必要な項目として指摘します
6. 修正前後を示す - 修正のまとまりごとに、スコアの比較を提示します

• 反復ループ：問題のまとまりを修正した後、次のいずれかに該当するまで再監査と修正を続けます。

  • スコアが目標（通常は85以上）に達する
  • 人の判断が必要な問題だけが残る（例：「このリンクを削除すべきか？」）

• すべての修正を等しく扱う：コードの変更とコンテンツの変更は、どちらも同じくらい重要です。

• コンテンツの修正を並行して行う：複数のファイルに影響する問題については、次のようにします。

  • サブエージェントを起動し、並行して修正します
  • 例：7つのファイルに代替テキストが必要な場合 → 1～2つのエージェントを起動してすべて修正します
  • 例：30個のファイルに見出しの問題がある場合 → エージェントを起動して一括編集します

• 完了条件：

  • ✅ すべてのエラーを修正済み
  • ✅ すべての警告を修正済み（または人による確認が必要なものとして記録済み）
  • ✅ 再監査で改善を確認済み
  • ✅ 修正前後の比較をユーザーに提示済み

修正を適用した後、変更内容を確認するかユーザーに尋ねてください。

スコア目標

開始スコア	目標スコア	想定される作業
< 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／見出しの欠落	ページコンポーネントとコンテンツファイルを編集	はい（コンテンツ）
画像の代替テキスト	コンテンツファイルを編集	はい
見出しの階層	コンテンツファイルを編集	はい
短い説明	コンテンツの frontmatter を編集	はい
HTTP→HTTPS リンク	コンテンツ内で検索して置換	はい
リンク切れ	手動で確認（ユーザーに報告）	いいえ

並列化可能な修正の場合：担当ファイルを指定してサブエージェントを起動します。

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

多くの問題では、コンテンツファイルの編集が必要です。これらもコードの修正と同じくらい重要です。

• 画像の代替テキスト：画像に説明的な代替テキストを追加します
• 見出しの階層：見出しレベルの飛び越しを修正します
• メタディスクリプション：frontmatter の短い説明を長くします
• HTTP リンク：安全でないリンクを HTTPS に更新します

サブエージェントによる修正の並列化

ユーザーが修正の一括適用を承認した場合、サブエージェントを使って並行して適用できます。

• まずユーザーに確認する — サブエージェントを起動する前に、適用する修正を必ず確認します
• 同じ修正タイプごとに、サブエージェント1つあたり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 コマースのように、類似したページが多数あるサイトを効率よく監査できます。

# Quick health check (25 pages, no link discovery)
squirrel audit https://example.com -C quick --format llm

# Default surface audit (100 pages, pattern sampling)
squirrel audit https://example.com --format llm

# Full comprehensive audit (500 pages)
squirrel audit https://example.com -C full --format llm

# Override page limit for any mode
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 サブコマンド

コマンド	説明
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／テキストのハイブリッド形式です（冗長な XML より 40% 小さくなります）：

• 概要：全体的な健全性スコアと主要な指標
• カテゴリ別の問題：監査ルールのカテゴリ（コア SEO、技術、コンテンツ、セキュリティ）ごとにグループ化されています
• リンク切れ：リンク切れしている外部リンクと内部リンクの一覧
• 推奨事項：修正案を添えた優先順位付きの対応項目

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

例

例 1：LLM 出力でサイトをすばやく監査する

# User asks: "Check squirrelscan.com for SEO issues"
squirrel audit https://squirrelscan.com --format llm

例 2：大規模サイトを詳細に監査する

# User asks: "Do a thorough audit of my blog with up to 500 pages"
squirrel audit https://myblog.com --max-pages 500 --format llm

例 3：変更後に新たに監査する

# User asks: "Re-audit the site and ignore cached results"
squirrel audit https://example.com --refresh --format llm

例 4：2 段階のワークフロー（前回の監査を再利用）

# First run an audit
squirrel audit https://example.com
# Note the audit ID from output (e.g., "a1b2c3d4")

# Later, export in different format
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://）が含まれていることを確認してください：

# ✗ Wrong
squirrel audit example.com

# ✓ Correct
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