AI智能体的灯塔
ax-audit 是一款用于审计网站 AI 智能体体验(AX)就绪度的开源工具,提供 18 项检查(14 项加权,4 项信息性),包括 LLMs.txt、Robots.txt、内容协商等,可生成评分和详细报告。
随着 AI 智能体和大型语言模型(LLM)越来越多地爬取、索引和与网站交互,网站是否已为这一生态系统做好准备成为关键问题。ax-audit 应运而生,它是一款开源 CLI 工具,旨在审计网站的 AI 智能体体验(AX)就绪度,类似于 Lighthouse 对 Web 性能的审计或 axe-core 对无障碍性的审计。通过运行一条简单的命令“npx ax-audit https://your-site.com”,即可获得一份全面的 AX 审计报告,涵盖从发现文件到爬虫策略的各个方面。
tool 核心包含 18 项检查,其中 14 项加权,4 项信息性。加权检查包括 LLMs.txt(权重 11%)、Robots.txt 与内容信号(11%)、HTML 渲染(9%)、结构化数据 JSON-LD(9%)、HTTP 头部(9%)、SEO 基础(7%)等。信息性检查如内容协商(Markdown 格式)、RSL 许可、代理访问和爬虫效率在 3.x 版本中提供参考,不计入总分。每项检查结果都附有逐步修复指南,帮助网站管理员快速定位并解决问题。
在用法上,ax-audit 支持单站点审计、批量并发审计(如“ax-audit https://a.com https://b.com --concurrency 2”),并可输出 JSON、Markdown 或 HTML 格式的报告。它还能通过“--only-failures”仅显示失败项,以及“--baseline”实现回归检测,非常适合集成到 CI/CD 流程中。程序化 API 同样可用,例如调用“audit({ url })”即可获得包含总分和各项结果的报告对象。
技术层面,ax-audit 采用 TypeScript 严格模式编写,仅依赖 chalk 和 commander 两个运行时包,利用 Node 18+ 内置 fetch 进行并行检查(通过 Promise.allSettled)。它还实现了包含 Vary 感知键的请求缓存、瞬态失败重试和退避机制,并附带 301 个测试用例(依赖零测试框架)。该项目基于 Apache 2.0 许可开源,由 Lucio Duran 构建,并提供了相关工具 ax-init 和 ax-cite 用于生成被审计的 AX 文件。对于希望让网站更好地服务 AI 智能体的开发者而言,ax-audit 无疑是一个值得关注的实用工具。