seo-ai-discovery

用途：审计浏览器根目录下供智能体与编程助手使用的发现文件与端点，包括 /llms.txt、/llms-full.txt、/agents.md、/.well-known/ucp、/.well-known/ai-catalog.json、/sitemap_agentic_discovery.xml 与 /api/ucp/mcp。该模块的分类权重为 0，所有发现仅供方向性参考，不构成答案引擎排名或引用信号。\n\n主要能力：检查 llms.txt 是否存在、是否符合 llmstxt.org 结构（单个 H1、可选摘要 blockquote、H2 分节链接）以及链接是否可解析（--deep，最多 25 个）；/llms-full.txt 仅报告有无。检查 agents.md 有无并提示平台默认情况。在电商未激活时检查 UCP 档案是否公开、JSON 是否有效、版本格式与 services/capabilities 结构；报告 ARD 目录是否可解析（v0.9 草案，采用率极低）与代理 sitemap 是否结构良好、采样 loc 是否可解析。\n\n使用方式：输入来自 dispatch envelope 指定的 PageSnapshot，读取 site/discovery.json 与 site/robots.json，vertical 决定 UCP 归属；已由 audit.mjs 输出的确定性发现不重复。若直接以 URL 调用且无快照，先运行 node "${CLAUDE_PLUGIN_ROOT}/scripts/snapshot.mjs" <target> --out "${CLAUDE_PLUGIN_DATA}/runs"。校验命令为 node "${CLAUDE_PLUGIN_ROOT}/scripts/ai-discovery.mjs" --snapshot <pages/<slug>.json> [--deep]。\n\n可修复项：AUTO 级别可在明确请求下根据站点自身结构生成或修复 llms.txt / llms-full.txt，写入前展示 diff，并声明影响低且不确定；ADVISORY 级别提示 UCP/ARD/代理 sitemap 采用与解除发现文件被 robots 屏蔽（写入归 M14）。工具不会代为撰写商户档案。\n\n适用场景：站点根目录 AI 发现文件与代理端点的合规性、结构完整性与链接健康状况检查。限制：不属于答案引擎引用因素；llms.txt 被 Google Search 忽略，厂商支持不完整，采用率约 10%，且据 Ahrefs（2026 年 5 月）97% 的 llms.txt 未收到机器人请求；测量结果在无网络或本地路径下状态为 needs_api，绝不虚报通过。