agent-readiness-mcp

agent-readiness-mcp — 無料の Agent Readiness Scanner

ASO スコアはいくつですか？

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

agent-readiness-mcp は、無料のオープンソース Agent Readiness MCP です。MCP サーバーとして、あらゆるウェブサイトをスキャンし、オープンな ASO framework に基づいて評価した Agent Readiness Report を生成します。ベータ版の npm パッケージは @forgemeshlabs/agent-readiness-mcp です。

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

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

=== Agent Readiness 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 カタログ（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（/.well-known/agent-card.json、必須フィールドを検証）、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/agent-readiness-mcp として公開されているため、クローンやビルドは不要です。

npm install -g @forgemeshlabs/agent-readiness-mcp

または、インストールせずに npx で実行できます（MCP クライアントにはこちらを推奨します）。

npx -y @forgemeshlabs/agent-readiness-mcp

Claude Code

claude mcp add aso -- npx -y @forgemeshlabs/agent-readiness-mcp

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

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

開発（ソースから）

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

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

ツール

ツール	機能
scan_site	サイト全体の 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 スコアはいくつ？」 · 「サイトをエージェント対応にするための修正計画を作成して」

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

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

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

このリポジトリには、Glama MCP レジストリの所有権およびインストールのメタデータを記載した glama.json が含まれています。

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

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

npx -y @forgemeshlabs/agent-readiness-mcp

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

Scan https://example.com for agent readiness.
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/agent-readiness-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 フレームワークでその解消方法を確認できます。