aso-score-mcp

aso-score-mcp — 無料の ASO スコアスキャナー

あなたの ASO スコアは？

SEO によって、検索エンジンから見つけてもらえるようになりました。**ASO（Agent Signal Optimization）**は、ウェブの次の訪問者となりつつある AI エージェントに、あなたを発見し、信頼し、利用してもらえるようにします。

aso-score-mcp は無料のオープンソース ASO Score MCP です。MCP サーバーとして、あらゆるウェブサイトをスキャンし、オープンな ASO フレームワークに基づいて採点した ASO Score Report を生成します。ベータ版の npm パッケージは @forgemeshlabs/aso-score-mcp です。

このリリースでは、Google の現在のエージェント対応に関するガイダンスを誇張せずに反映しています。Google Search によると、生成 AI 検索にも従来の SEO の基本が引き続き適用され、llms.txt は Google Search 自体には無視されます。また、ブラウザーエージェントは、整理された DOM、スクリーンショット、アクセシビリティツリーのシグナルを活用できます。スキャナーは、Google 以外のエージェントが利用するため llms.txt を引き続き確認し、セマンティックなコントロール、ラベルとの関連付け、ARIA／role によるフォールバック、非表示オーバーレイのリスクを対象とするブラウザーエージェントの UX チェックを追加しています。

ベータ版です。 エージェントがウェブサイト／API／ツールを発見し、信頼し、理解して利用できるかを評価するための実験的な ASO スキャナーです。ASO の採点は実験段階であり、エージェントの標準の成熟に合わせて進化します。

=== ASO Score Report: https://example.com ===
ASO Score: 70/100
Agent Readiness: Ready
Level: ASO-4 Trustable — Agents can verify trust, reputation, and operational signals.

Discoverability  20/20    Identity  15/20    Trust   11/15
Commerce          5/15    Reputation 4/15    Memory  15/15

チェック項目 — 6 つの柱にわたる 34 のシグナル

発見可能性、信頼性、相互運用性、コマースの課題を見つけましょう。新たに登場しているエージェント標準をすべて、1 回のスキャンで確認できます。

柱／カテゴリ	チェック項目
発見	robots.txt、sitemap.xml、Link ヘッダー、DNS-AID（_agent.<domain>）、/.well-known/ai
コンテンツ	Markdown コンテンツネゴシエーション、llms.txt、LLM が読み取り可能なドキュメント（/index.md、llms-full.txt）
ボットアクセス	明示的な AI クローラーのルール（GPTBot、ClaudeBot、Google-Extended、PerplexityBot…）、Content Signals、Web Bot Auth
相互運用性	API Catalog（RFC 9727）、OAuth ディスカバリー（RFC 8414）、OAuth Protected Resource（RFC 9728）、auth.md、MCP Server Card（/.well-known/mcp/server-card.json）、Google A2A Agent Card（必須フィールドを検証）、Agent Skills、WebMCP
コマース	x402、MPP、UCP、ACP、機械可読な価格情報
アイデンティティと信頼	HTTPS の強制、JSON-LD／schema.org、エージェントに使いやすいブラウザー UX、OpenAPI、agent.json、security.txt、ステータスエンドポイント、バージョニング、ファイル間のアイデンティティとシグナルの整合性

各チェックは、具体的な証拠と修正の推奨事項を添えて、合格／一部合格／不合格を返します。結果は 6 つの ASO の柱（発見可能性 20、アイデンティティ 20、信頼 15、コマース 15、評判 15、メモリー 15）に集約され、ASO スコアと成熟度レベルが算出されます。

インストール

Node.js ≥ 20 が必要です。npm では @forgemeshlabs/aso-score-mcp として公開されています。クローンやビルドは不要です。

npm install -g @forgemeshlabs/aso-score-mcp

または、インストールを省略して npx で実行できます（MCP クライアントにおすすめです）。

npx -y @forgemeshlabs/aso-score-mcp

Claude Code

claude mcp add aso -- npx -y @forgemeshlabs/aso-score-mcp

Claude Desktop／Cursor／Windsurf（任意の MCP クライアント）

{
  "mcpServers": {
    "aso": {
      "command": "npx",
      "args": ["-y", "@forgemeshlabs/aso-score-mcp"]
    }
  }
}

開発（ソースから）

スキャナー自体を開発する場合にのみ必要です。

git clone https://github.com/forgemeshlabs/aso-score-mcp
cd aso-score-mcp
npm install && npm run build
claude mcp add aso -- node /path/to/aso-score-mcp/dist/index.js

ツール

ツール	機能
scan_site	ASO を全面スキャン → ASO スコアレポート：ASO スコア、レベル、柱ごとの内訳、証拠と推奨事項を含む全 34 項目のチェック
get_fix_plan	優先順位付きの修正プラン。すぐに貼り付けて使えるテンプレート付き（robots.txt の AI ルール、llms.txt、agent.json、A2A エージェントカード、MCP サーバーカード、x402 マニフェスト、pricing.json、security.txt、ステータスエンドポイント）
check_signal	指定したチェック項目を 1 つ実行（例：a2a-agent-card、llms-txt、x402）
list_checks	仕様へのリンク付きで、すべてのチェック項目を一覧表示
get_aso_framework	ASO の評価基準：柱、重み、レベル、認定基準値

全体のベースラインを確認するには scan_site、指定したシグナルを 1 つ確認するには check_signal、コピーして使える修正案を取得するには get_fix_plan、有効なシグナル ID を確認するには list_checks、サイトをスキャンせずに評価モデルを説明するには get_aso_framework を使ってください。

お試しください：「example.com の ASO スコアをスキャンして」 · 「私の ASO スコアは？」 · 「サイトをエージェント対応にする修正プランを作成して」

CLI のスモークテスト（ソースをチェックアウトした状態から）

npm run smoke -- https://your-site.com

Glama／レジストリのメタデータ

このリポジトリには、Glama MCP レジストリの所有権とインストール用メタデータを設定する glama.json が含まれています。

• パッケージ： @forgemeshlabs/aso-score-mcp
• 現在のリリース： v0.2.5
• トランスポート： ローカル stdio
• 認証： ローカルで stdio を使用する場合、認証は不要です。スキャナーは API キー、トークン、Cookie、サードパーティの認証情報を要求しません。
• HTTP デプロイ： この npm パッケージでは有効になっていません。このスキャナーを HTTP 経由で公開デプロイする場合は、外部に公開する前に認証、クライアントごとのレート制限、リクエストログ、エグレスポリシーを追加する必要があります。

推奨する Glama／MCP インストールコマンド：

npx -y @forgemeshlabs/aso-score-mcp

MCP クライアントにサーバーを接続した後の使用例：

Scan https://example.com for ASO score.
Give me the ASO fix plan for example.com.
Check only the llms-txt signal for example.com.
List the ASO scanner checks.

リリースの検証：

• Git タグ：v0.2.5
• npm パッケージ：@forgemeshlabs/aso-score-mcp
• MCP サーバーのバージョン：0.2.6（起動時に package.json から読み取ります）

Glama のリリースビルド

Glama でインストール可能にするには、Glama リリースが必要です。これは GitHub リリースではなく、Glama の Dockerfile 管理ページから作成するコンテナ化ビルドです。このリポジトリには本番環境用の Dockerfile と、Glama で使用するビルド仕様値を記載した GLAMA.md が含まれています。

ビルド手順：

npm ci
npm run build
npm prune --omit=dev

ランタイムコマンド：

node dist/index.js

Glama の CMD arguments フィールドには、次の値を入力してください。

["node", "dist/index.js"]

CMD arguments を [] のままにしないでください。Glama はこのフィールドを Dockerfile の CMD とは別に検証します。

ASO フレームワーク

SEO は人々向けにページの検索順位を上げます。ASO はエージェントによるサービスの選択、呼び出し、支払い、継続利用に備えます。

レベル	名称	スコア
ASO-0	不可視	0–9
ASO-1	発見可能	10–29
ASO-2	理解可能	30–49
ASO-3	呼び出し可能	50–69
ASO-4	信頼可能	70–89
ASO-5	自律型コマース対応	90–100

このスキャナーのスコアは、方向性を示す自己評価です。ASO 認定（ASO-3 以上）には、検証済みの証拠が必要です。監査、認定、フレームワーク全体については、評価基準とagentsignaloptimization.comをご覧ください。

セキュリティ

このスキャナーは、指定された URL に外向きのリクエストを送信するため、SSRF 攻撃への耐性を備えています。

• スキームの許可リスト — http／https のみを許可し、file:、ftp:、gopher:、data: などは拒否します。
• プライベート宛てのブロック — DNS 解決後、ループバック、プライベート（RFC 1918）、リンクローカル、CGNAT、予約済み、マルチキャスト、およびクラウドメタデータアドレス（169.254.169.254）へのリクエストを拒否します。IPv6 のループバック／ULA／リンクローカルと IPv4 マップ形式も対象です。ホスト名がプライベートアドレスを 1 つでも解決する場合、スキャンを拒否します。
• IP 固定の通信 — 各リクエストは、検証済みの正確なパブリック IP に接続し、TLS では元のホスト名を引き続き検証します。これにより、検証後に接続するまでの間に発生する DNS リバインディングの隙を塞ぎます。
• リダイレクトの手動検証 — 自動リダイレクト追従は無効にし、各リダイレクト先を同じルールで再検証します。リダイレクトは最大 5 回です。パブリック URL が 30x リダイレクトで内部アドレスに誘導されても、すり抜けることはありません。
• 信頼できないリモートコンテンツ — 解析されたマニフェストは、デフォルトではツールの出力から除外されます（含めるには include_artifacts: true を指定します。その場合も、信頼できないコンテンツであることを明示します）。埋め込みテキストの抜粋は制御文字をサニタイズし、長さを制限します。返されたリモートコンテンツは指示ではなく、データとして扱ってください。
• 制限付き — GET のみ、UA は ASO-Scanner/1.0、同時実行数は最大 6、タイムアウトは 10 秒、本文サイズは最大 512KB です。認証は行わず、POST も行わず、既知のパス以外をクロールすることもありません。
• セキュリティ強化のテスト済み — npm test では、安全でない URL の拒否、プライベート IP 範囲、アーティファクトのサニタイズ、リダイレクトのブロック、リダイレクト回数の上限、およびテスト専用のループバック例外をテストします。

デプロイ: stdio（ローカル、ユーザーごと）が安全なデフォルトです。パブリックな HTTP デプロイはネットワークへの外向き通信を行うツールであり、公開する前に認証、クライアントごとのレート制限、リクエストログの記録、および外向き通信ポリシーを必ず追加してください。

• 評判に関するシグナル（引用、レビュー、成功率）はクローラーでは自動検証できません。監査で検証されるまで manual として報告され、スコアは 0 になります。そのため、自動検証可能な最高スコアは 89/100 です。これは意図的に誠実な設計であり、バグではありません。
• 新興仕様（MCP Server Cards SEP-1649/SEP-2127、DNS-AID、Web Bot Auth、UCP/ACP/MPP）は急速に進化しています。パスの更新に関する PR を歓迎します。

ソースとの整合性

このパッケージでは、Google 検索のガイダンスと、より幅広い ASO ガイダンスを意図的に分けています。

• Google 検索の生成 AI 機能は、引き続き検索の中核となるランキングシステムと品質システムに依存しています。基礎となる SEO、クロール可能性、有用なコンテンツ、技術的な明確さが引き続き優先事項です。
• Google 検索は、ランキングや AI Overviews／AI Mode での表示に llms.txt や特別な AI 用 Markdown ファイルを使用しません。他のエージェントや MCP クライアントが利用できるため、ASO では引き続きこれらを確認します。
• Google／web.dev のエージェントに優しいサイトに関するガイダンスは、ブラウザーエージェントの使いやすさに重点を置いています。安定したレイアウト、セマンティック HTML、入力欄と関連付けられたラベル、意味のあるロール／名前／状態、および隠れたオーバーレイの回避などです。
• UCP、AP2、A2A、MCP、x402、DNS-AID、Content Signals、Web Bot Auth は、新興の非 SEO プロトコルです。スキャナーはこれらをエージェント対応のシグナルとして扱い、Google 検索のランキング要因としては扱いません。

主な参考資料：

• https://developers.google.com/search/docs/fundamentals/ai-optimization-guide
• https://web.dev/articles/ai-agent-site-ux
• https://ucp.dev

ライセンス

MIT — 誰でも無料で利用できます。スキャナーで不足が見つかった場合は、ASO フレームワークでその解消方法を確認できます。