audit-website

ウェブサイト監査スキル

squirrelscan cli を使用して、SEO、技術、コンテンツ、パフォーマンス、セキュリティの問題についてウェブサイトを監査します。

squirrelscan は、macOS、Windows、Linux で利用できる CLI ツール squirrel を提供します。ブラウザーや検索クローラーをエミュレートし、140 以上のルールに照らしてウェブサイトの構造とコンテンツを分析することで、詳細なウェブサイト監査を実施します。

問題の一覧と、その修正方法に関する提案が表示されます。

リンク

• 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 エージェントは 20 のカテゴリにわたる 140 以上のルールについてウェブサイトを監査できます。カテゴリには次のものがあります。

• 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
• リンク切れの検出
• 実行可能な改善案

使用する場面

次のような場合に、このスキルを使用します。

• ウェブサイトの健全性を分析する
• 技術的な SEO の問題をデバッグする
• 上記のすべての問題を修正する
• リンク切れをチェックする
• メタタグと構造化データを検証する
• サイト監査レポートを作成する
• 変更前後のサイトの健全性を比較する
• ウェブサイトのパフォーマンス、アクセシビリティ、SEO、セキュリティなどを改善する

前提条件

このスキルを使用するには、squirrel CLI がインストールされ、PATH から利用できる必要があります。

インストール

squirrel がまだインストールされていない場合は、次のコマンドでインストールできます。

curl -fsSL https://squirrelscan.com/install | bash

これにより、次の処理が行われます。

• 最新リリースのバイナリをダウンロードします
• ~/.local/share/squirrel/releases/{version}/ にインストールします
• ~/.local/bin/squirrel にシンボリックリンクを作成します
• ~/.squirrel/settings.json に設定を初期化します

~/.local/bin が PATH に含まれていない場合は、シェルの設定に追加してください。

export PATH="$HOME/.local/bin:$PATH"

Windows へのインストール

PowerShell を使ってインストールします。

irm https://squirrelscan.com/install.ps1 | iex

これにより、次の処理が行われます。

• 最新リリースのバイナリをダウンロードします
• %LOCALAPPDATA%\squirrel\ にインストールします
• squirrel を PATH に追加します

コマンドプロンプトを使用する場合は、PATH の変更を反映するためにターミナルを再起動する必要があることがあります。

インストールの確認

squirrel がインストールされ、利用可能であることを確認します。

squirrel --version

セットアップ

squirrel init を実行すると、現在のディレクトリに設定用の squirrel.toml ファイルが作成されます。

各プロジェクトには、データベース用の squirrel プロジェクト名が必要です。デフォルトでは監査するウェブサイトの名前が使われますが、プロジェクトの監査結果をすべて1つのデータベースにまとめられるよう、自分で設定することもできます。

次のように init 時に設定するか、

squirrel init --project-name my-project

または config で設定します。

squirrel config set project.name my-project

実行元のディレクトリに squirrel.toml がない場合は、squirrel init で作成し、「-n」パラメーターでプロジェクト名を指定してください（推測してください）。

プロジェクト名は、データベース内でプロジェクトを識別し、データベース名の生成に使われます。

プロジェクト名は ~/.squirrel/projects/ に保存されます。

使い方

はじめに

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

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

「audit」コマンドはこの3つのプロセスをまとめたもので、順番に実行します。

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

常に format オプションには llm を優先してください。LLM 向けに作られており、網羅的かつ簡潔な出力形式を提供します。

ユーザーが監査対象のウェブサイトを指定しない場合は、ローカルディレクトリや環境変数（リンクされている vercel プロジェクト、メモリ内の参照情報、コードなど）を確認して、候補を推測してください。

実行対象のディレクトリにローカル開発サーバーを起動または再起動する方法がある場合は、そのサーバーを対象に監査を実行してください。

監査候補のウェブサイトが複数見つかった場合は、どれを監査するかユーザーに選んでもらってください。

ローカルにもウェブ上にも監査対象のウェブサイトが見つからない場合は、監査したい URL をユーザーに尋ねてください。

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

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

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

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

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

環境で利用可能な場合は、完了後に生成コードに対して型チェックとフォーマットを実行してください（Python では ruff、TypeScript では biome と tsc など）。

基本的なワークフロー

監査プロセスは次の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

詳細オプション

監査するページ数を増やす：

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

共通オプション

Audit コマンドのオプション

オプション	エイリアス	説明	デフォルト
--format <fmt>	-f <fmt>	出力形式：console、text、json、html、markdown、llm	console
--max-pages <n>	-m <n>	クロールするページの最大数（最大500）	500
--refresh	-r	キャッシュを無視して、すべてのページを新たに取得する	false
--resume	-	中断したクロールを再開する	false
--verbose	-v	詳細出力	false
--debug	-	デバッグログ	false

Report コマンドのオプション

オプション	エイリアス	説明
--format <fmt>	-f <fmt>	出力形式：console、text、json、html、markdown、xml、llm

出力形式

コンソール出力（デフォルト）

audit コマンドはデフォルトで、色付きの出力と進捗インジケーターを含む、人が読みやすいコンソール出力を表示します。

LLM 形式

LLM に最適化された出力を取得するには、--format llm を指定して report コマンドを使用します。

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 をインストールします：curl -fsSL https://squirrelscan.com/install | bash
2. PATH に追加します：export PATH="$HOME/.local/bin:$PATH"
3. 確認します：squirrel --version

アクセス権が拒否された

squirrel が実行可能でない場合：

chmod +x ~/.local/bin/squirrel

クロールのタイムアウトまたは動作が遅い

非常に大規模なサイトでは、監査に数分かかる場合があります。進行状況を確認するには、--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