xiaohui
AFDocs | AI Agent 友好度检测工具
AFDocs 官网 — 检测文档站点对 AI Agent 的友好程度，满分 100 分。
当 AI 工具（豆包、元宝、DeepSeek、Claude、ChatGPT）访问一个网站时，它们能顺利读懂这个网站的内容吗？这个问题之前靠猜测，现在有了一个 CLI 工具可以实测。
AFDocs 是一个开源 CLI 工具，运行 npx afdocs check <https://你的网站.com> --format scorecard，就能输出一份网站对 AI Agent 的友好度评分。它基于 Agent-Friendly Documentation Spec 规范，运行 23 项检查，覆盖 7 个维度。
Agent-Friendly Documentation Spec 官网 — 定义 AI Agent 友好度的技术规范。
这与 c456 的关系
之前我们讨论过做一个「AI 友好度自检清单」工具——AFDocs 就是这个工具的现成方案。它用 23 项自动化检查，告诉你：
- 你的网站有没有
llms.txt（告诉 AI 你的网站有什么内容） - 你的 Markdown 版本是否能被 AI 发现
- 页面大小是否会导致 AI 截断丢失关键信息
- 内容结构是否有利于 AI 导航
核心能力
| 维度 | 检查内容 | 实际意义 |
|---|---|---|
| 内容可发现性 | llms.txt 是否存在、大小是否符合规范、是否有导航指令 | AI 能否找到你的内容 |
| Markdown 可用性 | 页面能否以 .md 格式访问 | AI 是否可以直接读纯文本 |
| 页面大小与截断风险 | 关键内容是否分布在多个独立页面 | 长页面是否丢失关键信息 |
| 导航结构 | 是否有清晰的导航、sitemap 是否符合规范 | AI 能否遍历你的整个站点 |
| 交互诊断 | JS 渲染是否阻碍内容读取、登录墙是否存在 | AI Agent 能否顺畅访问 |
快速使用
# 一行命令出报告
npx afdocs check <https://你的网站.com> --format scorecard
输出格式包括评分卡（scorecard）、JSON、HTML、Markdown，适合 CI 集成。项目基于 MIT 协议，Node.js 22+，0.18.7 版本，已有 49 次发布。
来源
- 官网：afdocs.dev
- GitHub：agent-ecosystem/afdocs — MIT, TypeScript, 63 Stars
- npm：afdocs — 0.18.7
- 规范：Agent-Friendly Documentation Spec v0.5.0