agent-readiness-mcp

agent-readiness-mcp — 免费的 Agent Readiness 扫描器

你的 ASO 得分是多少？

SEO 让搜索引擎能够找到你。**ASO（Agent Signal Optimization，Agent 信号优化）**让日益成为网络下一批访客的 AI Agent 能够发现你、信任你并向你付费。

agent-readiness-mcp 是免费的开源 Agent Readiness MCP——一个 MCP 服务，可扫描任意网站，并根据开放的 ASO 框架生成 Agent Readiness 报告。Beta npm 软件包为 @forgemeshlabs/agent-readiness-mcp。

此版本遵循 Google 当前关于 Agent 就绪度的指导，但不会夸大其适用范围：Google Search 表示，传统 SEO 基础仍适用于生成式 AI 搜索，Google Search 本身会忽略 llms.txt，而浏览器 Agent 则受益于清晰的 DOM、屏幕截图和无障碍树信号。扫描器保留了 llms.txt 检查，因为非 Google Agent 会使用它；此外还增加了浏览器 Agent 用户体验检查，涵盖语义化控件、关联标签、ARIA/role 回退方案和隐藏覆盖层风险。

Beta 版。 实验性的 ASO 扫描器，用于评估 Agent 是否能够发现、信任、理解和使用网站/API/工具。ASO 评分仍处于实验阶段，并会随着 Agent 标准的成熟而不断演进。

=== 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 项信号

通过一次扫描找出发现、信任、互操作性和商业化方面的差距，涵盖所有新兴 Agent 标准：

支柱 / 类别	检查项
发现	robots.txt、sitemap.xml、Link 标头、DNS-AID（_agent.<domain>）、/.well-known/ai
内容	Markdown 内容协商、llms.txt、LLM 可读文档（/index.md、llms-full.txt）
Bot 访问	明确的 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、适用于 Agent 的浏览器用户体验、OpenAPI、agent.json、security.txt、状态端点、版本控制、跨文件身份与信号一致性

每项检查都会返回通过 / 部分通过 / 未通过，并提供具体证据和修复建议。检查结果汇总到六大 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 扫描 → Agent 就绪度报告：ASO 分数、级别、支柱细分、全部 34 项检查及其证据和建议
get_fix_plan	按优先级排列的修复计划，包含可直接粘贴的模板（robots.txt AI 规则、llms.txt、agent.json、A2A Agent 卡片、MCP 服务卡片、x402 清单、pricing.json、security.txt、状态端点）
check_signal	运行一项指定检查（例如 a2a-agent-card、llms-txt、x402）
list_checks	所有检查的目录及规范链接
get_aso_framework	ASO 评分标准：支柱、权重、级别、认证门槛

使用 scan_site 获取完整基线，使用 check_signal 检查单项指定信号，使用 get_fix_plan 获取可复制粘贴的修复方案，使用 list_checks 查找有效的信号 ID，使用 get_aso_framework 了解评分模型而不扫描网站。

试试看：“扫描 example.com，检查其 Agent 就绪度” · “我的 ASO 分数是多少？” · “给我一份修复计划，让我的网站适配 Agent。”

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 发行版本。它是通过 Glama Dockerfile 管理页面创建的容器化构建，而不是 GitHub 发行版本。此仓库包含生产环境用的 Dockerfile 和 GLAMA.md，其中列出了在 Glama 中使用的构建规范值：

构建步骤：

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 则让服务做好准备，以便 Agent 能够选择、调用、支付并重复使用服务。

级别	名称	分数
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 映射形式也包含在内。如果某个主机名解析到任何私有地址，扫描就会被拒绝。
• 固定 IP 传输 — 每个请求都连接到经过验证的确切公网 IP，同时 TLS 仍会验证原始主机名。这堵住了先验证、后连接期间的 DNS 重绑定漏洞。
• 手动验证重定向 — 禁用自动跟随重定向；每一跳都会依据同一规则重新验证，最多允许 5 次重定向。重定向到内部地址的公网 URL 无法绕过防护。
• 不可信的远程内容 — 默认不会将解析出的清单包含在工具输出中（设置 include_artifacts: true 可选择启用，届时会明确标记为不可信）；内嵌文本摘录会清理控制字符并限制长度。所有返回的远程内容都应视为数据，而非指令。
• 限制明确 — 仅支持 GET，UA 为 ASO-Scanner/1.0，最多 6 个并发请求，超时为 10s，响应正文上限为 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 搜索不会使用 llms.txt 或特殊 AI Markdown 文件来影响排名，也不会据此判断在 AI Overviews/AI Mode 中的可见性。ASO 仍会检查这些内容，因为其他 Agent 和 MCP 客户端可能会使用它们。
• Google/web.dev 面向 Agent 的网站指南关注浏览器 Agent 的易用性：稳定的布局、语义化 HTML、与输入项关联的标签、有意义的角色/名称/状态，以及避免使用隐藏覆盖层。
• UCP、AP2、A2A、MCP、x402、DNS-AID、Content Signals 和 Web Bot Auth 是新兴的非 SEO 协议。扫描器将它们视为 Agent 就绪度信号，而非 Google 搜索排名因素。

主要参考资料：

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

许可证

MIT — 所有人均可免费使用。如果扫描器发现了不足，ASO 框架会告诉你如何弥补。