用途:对开发者文档站点做结构化审计。给定一个文档 URL,抓取所需页面,逐项评估 33 项检查,并生成可视化评分报告(满分 100)。
主要能力:检查分为 7 类——AI 与 LLM 可发现性(llms.txt、llms-full.txt、robots.txt 中的 AI 爬虫、sitemap.xml)、结构与导航(简介页、快速开始、API 参考、侧边栏、面包屑、搜索)、内容完整性(用例/教程、代码示例、多语言示例、更新日志、FAQ、错误码)、内容质量、技术 SEO 与可抓取性(HTTPS、meta 标题与描述、canonical、noindex)、内链与流转(交叉链接、上一页/下一页、GitHub 链接、社区支持链接)、版本与维护(版本标识、更新时间、安装命令版本锁定、弃用提示)。
使用方式:先做 URL 扩展,把基础文档 URL 派生出的 robots.txt、sitemap.xml、llms.txt、llms-full.txt 以及根域名变体视为可直接抓取;再用一次 web_search 解锁派生路径(因为 web_fetch 只能抓取用户提供或此前搜索结果中出现过的 URL)。随后抓取主文档页及 quickstart、changelog、api、faq 等标准子页,至少 6–8 页。评估后按类别计分:Pass 满分、Warn 半分、Fail 零分,每类等权(各约 14.3 分),汇总四舍五入为百分制。最后生成自包含 HTML 报告文件 {domain}-docs-audit.html,并给出 3–5 句文字总结。
适用场景:审计公开可访问的开发者文档站点,快速定位 AI 可发现性、SEO、内容完整性与维护信号方面的缺口。
限制:需要能抓取目标页面;受认证保护的页面(401/403)相关检查只能标记为 Warn;JS 渲染页面若抓取内容过少,部分检查可能无法定论;弃用检查仅在多版本产品时才判 Fail,否则记为 N/A 并按 Pass 计分。具体评分权重与模板细节以资料所述为准。