这是 Pro 功能 —— Pro 引擎(v2.4.0+)的一部分。免费工具包经 site_audit 检查 llms.txt 基础项;完整的 8 项评分在 Pro 里。
问题所在
你的流量里越来越多不是人、也不是搜索爬虫——是自主 agent。Agent 读到的是 curl 读到的:不执行 JS、不解析 HTML 错误页、不猜你的 API 接口。返回 app-shell 200、HTML 错误页、纯 JS 内容的站,对 agent 来说不存在。
Vercel 的 is-agentic.com 把这件事变成可量化的公开评分。参考:vercel.com 85 分,linkedin.com 47 分,而这套检查清单的参考实现让 zens.ink 从 64 分升到 98/100。
8 项检查
| # | 检查 | 级别 | 分值 |
|---|---|---|---|
| 1 | Agent 友好 404(真实状态码 + markdown 恢复正文) | essential | 15 |
| 2 | OpenAPI 规范(operationId、描述、类型化 schema) | essential | 15 |
| 3 | JSON 错误响应(结构化,绝不用 HTML) | essential | 15 |
| 4 | Markdown 协商(Accept: text/markdown + Vary) | essential | 15 |
| 5 | 开发者可发现性(/developers/ + llms.txt 链接) | recommended | 10 |
| 6 | Agent 指引(llms.txt 的 when-to-use) | recommended | 10 |
| 7 | 信任锚(about/contact/privacy + Organization schema) | recommended | 10 |
| 8 | CLI / MCP 接口面有文档 | recommended | 10 |
用法
python3 -m zens_ink_pro.agent_readiness https://yoursite.com
# 保存报告 + JSON
python3 -m zens_ink_pro.agent_readiness https://yoursite.com --report agent-report.md --json agent-data.json
确定性评分——不调 LLM、不需要 API 密钥,每次运行约 10 个 HTTP 请求。每个发现都写明需要改什么、值多少分,按 P0(关键)/ P1(高)/ P2(打磨)分桶。
修复之后
用官方公开评分器复扫确认:
npx is-agentic yoursite.com
满分长什么样
zens.ink 的实现(2026 年 8 月)就是参考:/openapi.json 的 OpenAPI 3.1、Accept: text/markdown 返回 markdown 且带 Vary: Accept、带提示的 JSON 404、四语言信任锚页、以 agent 指引开头的 llms.txt。98/100,“Strong technical baseline”——所有修复模式都收录在 Pro 包的 references/ 目录里。