aso-score-mcp

aso-score-mcp — 免费的 ASO 评分扫描器

你的 ASO 评分是多少？

SEO 让搜索引擎发现你。**ASO（Agent Signal Optimization，Agent 信号优化）**让正在成为网络新访客的 AI Agent 能够发现你、信任你并为你付费。

aso-score-mcp 是免费的开源 ASO Score MCP——一个 MCP 服务，可扫描任意网站，并依据开放的 ASO 框架生成 ASO 评分报告。Beta npm 包为 @forgemeshlabs/aso-score-mcp。

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

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

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

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

支柱 / 类别	检查项
可发现性	robots.txt、sitemap.xml、Link 标头、DNS-AID（_agent.<domain>）、/.well-known/ai
内容	Markdown 内容协商、llms.txt、适合大模型阅读的文档（/index.md、llms-full.txt）
机器人访问	明确的 AI 爬虫规则（GPTBot、ClaudeBot、Google-Extended、PerplexityBot…）、Content Signals、Web Bot Auth
互操作性	API Catalog（RFC 9727）、OAuth 发现（RFC 8414）、OAuth 受保护资源（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、适合 Agent 使用的浏览器体验、OpenAPI、agent.json、security.txt、状态端点、版本管理、跨文件身份与信号一致性

每项检查都会返回通过 / 部分通过 / 未通过，并提供具体证据和修复建议。结果汇总到六大 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 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 并获取 ASO 评分” · “我的 ASO 评分是多少？” · “给我一份修复计划，让我的网站适合 Agent 使用。”

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 部署。公开部署此扫描器的任何 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 发布版本。它是通过 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 框架会告诉你如何弥补。