用途
aso-audit-mcp 是一个免费、开源的 ASO（Agent Signal Optimization，智能体信号优化）扫描器，以 MCP 服务器形式提供。它的目标是评估网站、API 和产品界面是否具备让 AI 智能体发现、信任、理解和使用的能力。项目将 ASO 类比为面向智能体的 SEO：SEO 让页面被人和搜索引擎看到，ASO 则让服务能被 AI 智能体选择、调用、支付和重复使用。
主要能力
扫描器覆盖 6 大支柱、共 34 项信号，检查发现性、信任、互操作性和商业能力方面的缺口，涵盖各类新兴智能体标准。每项检查返回 pass / partial / fail 三种结果，并附带具体证据和修复建议。结果汇总为六个 ASO 支柱得分：Discoverability 20、Identity 20、Trust 15、Commerce 15、Reputation 15、Memory 15，最终形成 ASO 评分和成熟度等级。
检查内容包括 robots.txt 中的 AI 规则、llms.txt、agent cards、MCP server cards 与 OAuth 元数据等。项目说明其跟踪 Google 当前的智能体就绪指南，但不过度解读：Google Search 表示传统 SEO 基础仍然适用于生成式 AI 搜索，llms.txt 被 Google Search 本身忽略，而浏览器智能体受益于干净的 DOM、截图和无障碍树信号。扫描器保留 llms.txt 检查是因为非 Google 的智能体使用它，并新增了浏览器智能体 UX 检查，涵盖语义控件、关联标签、ARIA/role 回退以及隐藏覆盖层风险。
此外，扫描器提供确定性的 x402 v2 端点审计工具 audit_x402_endpoint，对单个付费端点进行不花钱的协议审计，返回 0-100 分、A-F 等级、合规判定、逐项布尔值、失败项以及观察到的 schemes/networks/extensions。它验证实时的 402 挑战，但从不发送 PAYMENT-SIGNATURE，因此无法授权或结算支付。检查项包括 HTTPS/TLS、HTTP 402、PAYMENT-REQUIRED、Base64 JSON、x402Version: 2、非空 accepts、CAIP-2 网络、必需支付字段和 JSON 内容类型。对于 body-gated 路由，可传入 method、body 以及可选的 content_type。该结果与 ASO 评分刻意分开报告：协议合规并不证明可发现性、信任、结算、幂等性或付费响应质量。
使用方式
需要 Node.js ≥ 20。已发布到 npm，包名为 @forgemeshlabs/aso-audit-mcp，无需克隆或构建。推荐使用 npx 直接运行，适用于 Claude Desktop、Cursor、Windsurf 等任意 MCP 客户端。当前版本为 v0.4.4，传输方式为本地 stdio，本地 stdio 使用无需认证，扫描器不要求 API 密钥、令牌、cookie 或第三方凭据。该 npm 包未启用 HTTP 部署；任何公开 HTTP 部署在暴露前必须添加认证、按客户端限流、请求日志和出口策略。
连接 MCP 客户端后，可尝试的用法示例包括："Scan example.com for agent readiness"、"What's my ASO score?"、"Give me a fix plan to make my site agent-ready."。仓库还包含 glama.json 用于 Glama MCP 注册表的所有权和安装元数据，并提供生产 Dockerfile 与 GLAMA.md 构建规范。
适用场景
适用于希望了解自身网站或 API 对 AI 智能体是否友好、是否具备可发现性和就绪信号的开发者、产品团队和运维人员。可用于自查 ASO 评分、定位发现性/信任/互操作性/商业方面的缺口，并获取修复计划。x402 端点审计适合需要检查付费端点协议合规性的场景。
限制与安全设计
ASO 评分是实验性的，会随智能体标准成熟而演进。扫描器产生的评分是方向性的自我评估；ASO 认证（ASO-3+）需要经过验证的证据。声誉信号（引用、评价、成功率）无法由爬虫自动验证，会以手动方式报告并在验证前计 0 分，因此可自动验证的最高分为 89/100，这是刻意的诚实设计而非缺陷。新兴规范（MCP Server Cards SEP-1649/SEP-2127、DNS-AID、Web Bot Auth、UCP/ACP/MPP）变化很快。
由于扫描器会向用户提供的 URL 发出出站请求，它内置了防 SSRF 滥用的设计：仅允许 http/https 协议；DNS 解析后拒绝回环、私有（RFC 1918）、链路本地、CGNAT、保留、组播以及云元数据地址（169.254.169.254），并覆盖 IPv6 回环/ULA/链路本地和 IPv4 映射形式；采用固定 IP 传输，TLS 仍验证原始主机名；禁用自动重定向跟随，每一跳都重新验证，最多 5 次重定向；解析出的清单默认从工具输出中省略（可用 include_artifacts: true 选择加入，并明确标记为不可信），嵌入文本片段会做控制字符清理和长度限制；仅 GET，UA 为 ASO-Scanner/1.0，最大 6 并发，10 秒超时，512KB 响应上限，从不认证、从不 POST、不爬取 well-known 路径之外的内容。npm test 覆盖了不安全 URL 拒绝、私有 IP 范围、工件清理、重定向阻止、重定向跳数上限等加固测试。
关于赞助卡片（Lulu Ads）：该 MCP 背后没有付费的 ForgeMesh 服务器，每个工具都直接抓取被扫描站点，因此 Lulu Ads 卡片只能在客户端侧附加，且仅附加到 list_tools。它是 JSON 结果上一个普通、带标签的数据字段，绝不是模型可读作指令的文本。该包不附带广告凭据；只有当运行 MCP 的操作者设置了 LULU_ADS_PUBLISHER_ID 和 LULU_ADS_API_KEY（两者都必需）时卡片才会渲染。对于无凭据运行 npx -y @forgemeshlabs/aso-audit-mcp 的最终用户，该包对广告网络零调用，不会出现任何卡片。LULU_ADS_ENABLED=false 是终止开关。扫描/审计工具从不接触该 SDK。失败开放：任何 SDK 错误或超时（硬预算 2 秒）都原样返回原始响应。除被扫描站点外，该包唯一联系的外部主机是 ads.getlulu.dev。可通过删除 result.sponsored 去除卡片。
项目采用 MIT 许可，对所有人免费。
