squirrelscan

squirrelscan

コーディングエージェント向けのウェブサイト QA ツール

squirrelscan は、SEO、パフォーマンス、セキュリティ、アクセシビリティ、エージェントの使いやすさなど、ウェブサイトのさまざまな問題を監査し、コーディングエージェントに的確な修正方法を提示するオープンソースの CLI ツールです。CLI から、コーディングエージェント内から、クラウド上から、または MCP 経由で実行できます。

コーディングエージェントと、決定論的で拡張可能な監査ツールを組み合わせましょう。

_{リリース済みの CLI（サインアウト状態のため無料）と Claude Code を使い、小さなテストサイトで実際に実行した例です。エージェントの作業時間を約 2 分短縮しました。エージェントが考える様子を眺めたい人はいませんから。}

機能

• コーディングエージェント向けに構築 - Claude Code、Cursor、Codex、およびあらゆるコーディングエージェント向けのスキルにより、監査、修正、再監査のループを実行できます。CLI、ホスト型またはローカルの MCP サーバー、あるいは API 経由で接続できます。
• あなたとコーディングエージェントのための充実した修正情報 - すべての指摘事項に修正方法が記載されており、エージェントが適用できる LLM 向けに最適化された形式で出力されます。また、すべてのルールに専用のドキュメントページがあります。サインインすると、レポートには最初に修正すべき項目についての編集者による要約と、サイトで使用されているテクノロジースタックも追加されます。
• 300 以上のルール、22 のカテゴリ - SEO、アクセシビリティ、パフォーマンス、セキュリティ、コンテンツなどを対象に監査します。
• エージェントエクスペリエンス - AI エージェントがサイトをどれだけ読み取り、発見し、操作できるかを監査します。llms.txt、AGENTS.md、Markdown レスポンス、AI クローラーに提供される内容を確認します。
• リンクチェックと監視 - クラウドリンクチェッカーの Perch は、リンク切れとアクセス拒否を区別し、報告前に障害を確認します。Pro および Team では、定期監査によってリンク切れが発生した際にメールで通知されます。
• セキュリティとサイトの完全性 - フィッシングキット、埋め込みページ、漏えいした認証情報、欠落しているセキュリティヘッダーを検出します。
• エンティティマップ - サイトの JSON-LD をひとつのグラフにまとめます。サイト全体でひとつのアイデンティティか、ページごとに新しいアイデンティティが作られているかを確認できます。
• クラウドでのブラウザーレンダリング - サインインすると、ページがクラウド上の実際のブラウザーでレンダリングされるため、シングルページアプリや JavaScript を多用するサイトも、訪問者に表示されるとおりに監査できます。ページごとの追加料金はかかりません。
• クラウド監査 - AI によるページ分析、定期監査、ウェブサイトごとの課題トラッカー、共有可能なレポートを利用できます。
• スマートクローリング - 高速かつメモリ効率に優れ、ETag、Last-Modified、コンテンツハッシュを使った差分クロールに対応し、チェックポイントから再開できます。
• クロール履歴と変更 - サイトの変化を追跡し、クロールを比較して、リグレッションを発見できます。
• 開発者ファーストの CLI - 単一バイナリで依存関係は不要。シェル補完と自己更新に対応しています。
• 複数の出力形式 - コンソール、JSON、HTML、Markdown、Text、LLM、XML。

ルールカテゴリ

各カテゴリのルール数ではなく、通常、失敗による損失が大きい順に並んでいます。

カテゴリ	ルール数	対象範囲
クロール可能性	20	検索エンジンやエージェントがサイトにアクセスし、インデックスに登録できるかどうかを確認します。robots.txt、サイトマップの有効性と網羅性、インデックス登録可否の競合、リダイレクトチェーンと canonical チェーン、ソフト 404 が対象です
コア SEO	14	ページごとの基本項目を確認します。タイトル、メタディスクリプション、H1、canonical、文字コード、DOCTYPE、robots メタタグ、Open Graph と Twitter カードに加え、サイト全体での canonical 形式のばらつきが対象です
エージェントエクスペリエンス	17	AI エージェントがサイトを読み取り、見つけ、操作できる状態かどうかを確認します。GPTBot と Claude-User にブラウザーと同じコンテンツが提供されるか、AGENTS.md、llms.txt、Markdown レスポンス、API と MCP の検出可能性、ライセンスと noai シグナル、クロールごとの課金、レスポンスのトークン量が対象です
サイトの完全性	9	サイトが侵害された兆候を確認します。挿入された誘導ページ、フィッシングキットの特徴、難読化されたスクリプト、ブランドのなりすまし、クローキング、既知の悪意ある URL が対象です
セキュリティ	22	通信とヘッダーの適切さを確認します。HTTPS と HSTS、CSP、Cookie フラグ、混在コンテンツ、サブリソース整合性、漏えいしたシークレット、Web ストレージ内のトークン、保護されていないフォームや格下げされたフォーム、GraphQL のイントロスペクションの公開、GET によるミューテーションが対象です
リンク	13	内部リンクと外部リンクの健全性を確認します。壊れたリンクやリンク切れ、リンク先がなくなったページ内アンカー、リダイレクトチェーン、アンカーテキストの品質、孤立ページや行き止まりページ、サイト全体の共通部分からしかリンクされていないページ、HTTPS からの格下げが対象です
コンテンツ	25	テキストの品質と信頼性を確認します。よくあるスペルミス、重複するタイトルと説明文、タイトルテンプレートの一貫性、読みやすさ、単語数、鮮度、見出し階層、キーワードの詰め込み、非表示テキスト、プレースホルダーのメディアや連絡先情報、文字エンコーディングの破損が対象です
パフォーマンス	30	Core Web Vitals と配信状況を確認します。LCP、CLS、INP のヒント、TTFB、圧縮、キャッシュ、レンダリングを妨げるリソース、DOM サイズ、フォント配信、古い形式や圧縮されていない JS／CSS が対象です
信頼性	5	読み込みに失敗するスクリプト、スタイルシート、フォントを確認します（デプロイ後に 404 や 500 を返すファーストパーティのバンドル、サードパーティやフォントの読み込み失敗など）。送信内容が失われるフォームも対象です
画像	16	代替テキスト、最新の形式、レスポンシブな srcset、固有の寸法とアスペクト比の不一致、スクロールせずに見える範囲より上と下での遅延読み込み、ファイルサイズが対象です
構造化データ	26	JSON-LD の有効性と、Article、Product、FAQ、Review、Breadcrumb、Organization、LocalBusiness、Video、サイト内検索のリッチリザルトへの適格性を確認します。ページの分類タイプに応じて記述すべきマークアップに加え、エンティティマップに関するサイト全体の 13 項目のチェックも対象です。サイトが自らについて単一のアイデンティティを宣言しているか、ページごとに新しいアイデンティティを宣言しているか、また、そのページに関係のない評価マークアップがないかを確認します
アクセシビリティ	61	WCAG の対応状況を確認します。ARIA ロールと名前、フォームラベルと autocomplete トークン、色のコントラスト、見出しの順序、ランドマーク、表とリスト、フォーカスの可視性、タッチターゲット、字幕が対象です
モバイル	8	ビューポート設定、タップターゲットのサイズ、読みやすいフォントサイズ、横スクロール、ズームのブロック、フォーカス時にページがズームするほど小さいフォームフィールド、煩わしいインタースティシャル、Web アプリマニフェストとそのアイコンが対象です
ソーシャルメディア	5	Open Graph と Twitter Card の完全性、画像サイズ、canonical URL の一致、ソーシャルプロフィールへのリンク、ページ間で食い違うサイト共通部分のアセットが対象です
URL 構造	9	長さ、大文字と小文字、ハイフンの使用、ストップワード、クエリパラメーター、特殊文字、末尾のスラッシュの一貫性、サイト全体の規則の一貫性が対象です
E-E-A-T	15	経験、専門性、権威性、信頼性のシグナルを確認します。著者の署名と資格、会社概要ページと問い合わせページ、引用、編集方針、免責事項、YMYL の検出が対象です
法令遵守	4	プライバシーポリシー、利用規約、実際に機能する Cookie 同意の仕組み、サブプロセッサーの開示が対象です
国際化	2	hreflang の正確性と、ドキュメントの言語宣言が対象です
ローカル SEO	3	クロールしたすべてのページにおける NAP（名称、住所、電話番号）の一貫性、位置情報メタデータ、サービス提供地域のある事業者が対象です
動画	3	VideoObject マークアップ、字幕とアクセシビリティ、サムネイルが対象です
アナリティクス	2	Google Tag Manager の設置と同意モードの連携が対象です
ブロック	3	広告ブロッカーやプライバシーフィルターによって、多数の訪問者から取り除かれるコンテンツ、リンク、トラッカーが対象です
合計：22 カテゴリーに300以上のルール

詳しくはルールリファレンスをご覧ください。

CLI

インストール

コーディングエージェントに貼り付けてください（Claude Code、Codex、Cursor、opencode など）：

Fetch and follow the setup instructions for squirrelscan at https://docs.squirrelscan.com/agent-setup/prompt.md

エージェントが CLI をインストールし、MCP に接続して、最初の監査を実行します。事前に実行内容の詳細を確認できます。

macOS / Linux：

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

Windows：

iwr -useb https://install.squirrelscan.com/install.ps1 | iex

Homebrew（macOS）：

brew install --cask squirrelscan/tap/squirrel

この cask は、初回使用時に通常のインストーラーを実行するランチャーをインストールします。その後 CLI は squirrel self update で自動更新され、brew upgrade の影響は受けません。

npm（すべてのプラットフォーム）：

npm install -g squirrelscan

npx（インストールせずに実行）：

npx squirrelscan audit example.com

クイックスタート

# Audit a website
squirrel audit example.com

# Generate HTML report
squirrel audit example.com -f html -o report.html

# Pipe to Claude for AI analysis
squirrel audit example.com --format llm | claude

# Quick audit for a fast first look (other levels: surface, full)
squirrel audit example.com --level quick

# run only agent experience and performance rules
squirrel audit example.com --rule-include ax,performance

# login for cloud audits and cloud rendering
squirrel auth login

レポート

ヘルススコアとグレード、スコアに応じて色分けされた SEO、パフォーマンス、セキュリティ、エージェントエクスペリエンス（AX）のグループ別スコア、問題のランキング、各問題に対するコピー可能な修正プロンプトが表示されます。修正手順は埋め込まれているため、レポートをウェブに公開してチームメンバーやコーディングエージェントと共有できます。

レポートの例を見る、またはレポートの読み方をご覧ください。

コーディングエージェントに追加する

squirrelscan は、MCP サーバー（mcp.squirrelscan.com でホスト）、スキル（自律的な監査と修正のワークフロー）、Claude Code と Cursor 向けのプラグインとして提供されています。Cursor は上のバッジからワンクリックでインストールできます。それ以外は、コピーして貼り付けるだけです。

Cursor

上の Add to Cursor バッジをクリックするか、手動で ~/.cursor/mcp.json に追加します：

{
  "mcpServers": {
    "squirrelscan": { "url": "https://mcp.squirrelscan.com/mcp" }
  }
}

スキル：squirrel skills install

Claude Code

プラグインをインストールします（スキルと MCP サーバーが同梱されています）：

/plugin marketplace add squirrelscan/skills
/plugin install squirrelscan@squirrelscan

または、MCP サーバーのみを追加します：

claude mcp add --transport http squirrelscan https://mcp.squirrelscan.com/mcp

OpenAI Codex

サーバーを ~/.codex/config.toml に追加します：

[mcp_servers.squirrelscan]
url = "https://mcp.squirrelscan.com/mcp"

Codex は ~/.agents/skills から Agent Skills を読み込むため、スキルも利用できます：squirrel skills install

opencode

サーバーを opencode.json に追加します：

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "squirrelscan": {
      "type": "remote",
      "url": "https://mcp.squirrelscan.com/mcp",
      "enabled": true
    }
  }
}

任意の MCP クライアント

squirrelscan は MCP Registry に com.squirrelscan/squirrelscan として登録されています。任意のクライアントからリモートサーバーに接続してください：

https://mcp.squirrelscan.com/mcp

認証はユーザーごとの OAuth です（または squirrelscan API キーを Bearer トークンとして渡してください）。スキルは Agent Skills standard に準拠しています：squirrel skills install を実行すると、~/.agents/skills/ と ~/.claude/skills/ にインストールされます。

スキル

2つのスキルがエージェントのワークフローを支えます。これらは squirrelscan/skills にあり、MCP サーバーとともにスキルを同梱する Claude Code、Cursor、Agent Plugins のパッケージも含まれています。squirrel skills install はスキルをダウンロードして検証します。また、v0.0.99 以降は squirrel の自動更新によって最新の状態に保たれます。以前に npx skills でインストールしたものは、以降こちらで管理されます。

• squirrelscan - CLI の操作：インストール、ログイン、キー、クレジット、監査の実行、レポートの公開、エンティティマップ、MCP のセットアップ、設定、トラブルシューティング。
• audit-website - 修正の全サイクル：監査、問題とソースファイルの対応付け、まとめて修正、サイトのスコアが良くなるまで再監査。

squirrel skills install

次に、エージェントで：

Use the audit-website skill to audit this site and fix all issues but only crawl 10 pages

出力形式

形式	フラグ	用途
コンソール	(default)	人が読みやすいターミナル出力
JSON	-f json	CI/CD、プログラムによる処理
HTML	-f html	共有用の視覚的なレポート
Markdown	-f markdown	ドキュメント、GitHub
テキスト	-f text	LLM にパイプで渡すためのクリーンな出力
LLM	-f llm	LLM に最適化された出力
XML	-f xml	XML 出力

ソースコードと開発

ローカル CLI、クローラー、監査エンジン、ルール、レポート生成ツール、CLI 向けクラウドクライアント、ドキュメントサイトはすべて、このリポジトリでオープンソースとして公開されています。ホスト型 API、ウェブサイト、ダッシュボード、クラウドワーカーの実装は、別の非公開サービスです。

前提条件：Bun 1.4.4 と Git。

git clone https://github.com/squirrelscan/squirrelscan.git
cd squirrelscan
bun install --frozen-lockfile
bun run dev -- audit https://example.com --max-pages 10

プルリクエストで使用されるものと同じチェックを実行します。

bun run format:check
bun run lint
bun run typecheck
bun test
bun run build
bun run docs:check
bun run docs:build

プルリクエストを作成する前に、CONTRIBUTING.md をご確認ください。貢献には Developer Certificate of Origin への署名（git commit -s）が必要です。

テレメトリー

テレメトリーはデフォルトで有効になっており、意図的に最小限の情報のみを収集します。収集されるのはイベント名、CLI のバージョン、ランダムなインストール ID、範囲を限定したエラーカテゴリです。API キー、URL、レポートの内容、生のエラーメッセージは送信されません。squirrel auth login の実行後は、テレメトリーのリクエストにログインセッション（ログイン時に発行される90日間有効なサインイントークンであり、API キーではありません）が含まれ、イベントがアカウントに紐付けられます。サインアウト中は匿名で送信されます。テレメトリーがオフの場合、情報は一切送信されません。

次のコマンドで永続的に無効にできます。

squirrel self settings set telemetry false

または、NO_TELEMETRY（空の値、0、false を含め、値が定義されていれば何でも構いません）もしくは DO_NOT_TRACK=1（または true）を定義すると、実行ごとにすべてのテレメトリーとインストール登録を無効にできます。プロジェクトでは、.squirrel/settings.json に "telemetry": false を指定して無効にできます。

NO_TELEMETRY=1 squirrel audit https://example.com

リンク

• ウェブサイト
• ドキュメント
• よくある質問
• コーディングエージェントとの連携
• フィードバックを共有
• バグ、問題、機能リクエスト
• Twitter/X

エージェントが見逃した問題を squirrelscan が見つけた場合は、GitHub でスターを付けると、ほかの開発者が見つけやすくなります。

ライセンス

CLI とリポジトリの内容は、MIT License の下でライセンスされています。squirrelscan の名称とロゴは、TRADEMARKS.md の対象です。