这份文档把我们的检测口径完整公开:27 条规则、四维权重、L0–L5 门槛、按站点类型的适用范围,以及与 AgentReady v2.0 的逐条符合性。任何人都可以按这里的判据复现同一结果。
四维合计 100 分。判定:ok 拿满权重、warn 拿一半、fail 记 0、na 剔出分母(不参与计分)。
| 规则 ID | 检查项 | 权重 | 为什么重要 |
|---|---|---|---|
发现 find · 权重 25 | |||
AR-FIND-01 | robots.txt 允许 AI 爬虫 | 6 | robots.txt 整站屏蔽 AI 爬虫时,智能体连页面都拿不到。 |
AR-FIND-02 | sitemap.xml 可访问 | 4 | 提供 sitemap 让智能体一次拿全站 URL,不必猜路径。 |
AR-FIND-03 | sitemap 含 lastmod | 2 | lastmod 告诉智能体哪些页面是新改的,决定它先读哪一页。 |
AR-FIND-04 | llms.txt 就绪 | 6 | llms.txt 是给 LLM 的站点摘要,缺失时智能体只能靠猜。 |
AR-FIND-05 | HTML 内链接发现文件 | 3 | llms.txt / OpenAPI 要在页面里被链接到;实测多数抓取来自链接而非猜路径。 |
AR-FIND-06 | Link 响应头声明 | 4 | RFC 8288 的 Link 头让智能体从响应头就能找到 llms.txt / API 描述,不用解 HTML。 |
可读 read · 权重 30 | |||
AR-READ-01 | 首屏 HTML 含正文 | 8 | 答案藏在 JavaScript 里是智能体失败的头号原因,正文必须服务端渲染。 |
AR-READ-02 | 语义结构清晰 | 4 | 唯一 H1 + 合理 H2 层级,智能体才分得清标题与正文。 |
AR-READ-03 | JSON-LD 结构化数据 | 6 | Organization/WebSite/FAQPage 等实体声明,让智能体确认你是谁。 |
AR-READ-04 | JSON-LD 关键字段 | 3 | 只有 @type 不够,name / url 等字段才让实体可被引用。 |
AR-READ-05 | meta description + canonical | 4 | 摘要与规范地址决定智能体摘录哪一句、引用哪个 URL。 |
AR-READ-06 | Open Graph 标签 | 3 | og:title / og:description 是智能体生成引用卡片的第一来源。 |
AR-READ-07 | 真实 HTTP 状态码 | 2 | 缺失页面必须返回 404 而不是 200,否则智能体会把错误页当答案。 |
可调用 act · 权重 30 | |||
AR-ACT-01 | MCP 端点可发现 | 6 | MCP 是智能体调用工具的标准接口,须有 server card 或 well-known 声明。 内容站不适用 |
AR-ACT-02 | A2A Agent Card | 5 | A2A 卡描述智能体能替你完成什么,是跨智能体协作的入口。 内容站不适用 |
AR-ACT-03 | Agent Skill / AGENTS.md | 4 | skill.md 或 AGENTS.md 用自然语言告诉智能体什么时候、怎么调用你。 内容站不适用 |
AR-ACT-04 | OpenAPI 描述 | 4 | 有 OpenAPI 的 HTTP 面才能被智能体稳定地当成工具调用。 内容站不适用 |
AR-ACT-05 | Agent 认证发现 | 3 | OAuth/OIDC 或 auth.md 让智能体知道怎么拿到凭证。 内容站不适用 |
AR-ACT-06 | CLI 用法有文档 | 2 | 给智能体一条可直接执行的命令,比让它猜 API 更可靠。 内容站不适用 |
AR-ACT-07 | ARD 能力清单 | 3 | /.well-known/ai-catalog.json 用条目列出可调用的能力,比散落的卡片更容易被索引。 内容站不适用 |
AR-ACT-08 | agent-permissions 权限声明 | 3 | 明确写出智能体能读什么、能写什么、不能碰什么,减少越权调用。 内容站不适用 |
清单与声明 manifest · 权重 15 | |||
AR-MANI-01 | agent-ready / agents 清单 | 4 | 机器可读的自述文件,一次说清入口、鉴权与文档位置。 |
AR-MANI-02 | AI 使用声明(Content-Signal) | 2 | 在 robots.txt 里声明 ai-train / search / ai-input 意图,避免默认被当成禁止。 |
AR-MANI-03 | Markdown 内容协商 | 3 | Accept: text/markdown 时返回 markdown 原文,省掉智能体的解析成本。 |
AR-MANI-04 | llms-full.txt 全文版 | 2 | llms.txt 给索引,llms-full.txt 给一次抓全的全文,两者配合最省调用。 |
AR-MANI-05 | sitemap.md / AGENTS.md 镜像 | 2 | 给智能体的 markdown 版导航与项目说明,比解析 HTML 更稳。 |
AR-MANI-06 | Poppy 个人智能体清单 | 2 | /.well-known/poppy.json 声明组织与网站级接入方式(纯网站可只写 web:{})。 |
门槛递进:每一级都建立在前一级之上。等级与百分制并存——分数看差距,等级看阶段。
| 等级 | 名称 | English | 门槛 |
|---|---|---|---|
| L0 | 未就绪 | Not Ready | 连基础可发现都没做到 |
| L1 | 基础可发现 | Basic Web Presence | robots / sitemap / Link 头 三项过两项 |
| L2 | 爬虫友好 | Bot-Aware | 在 L1 之上声明了 Content-Signal |
| L3 | 智能体可读 | Agent-Readable | 在 L2 之上支持 markdown 内容协商 |
| L4 | 智能体已集成 | Agent-Integrated | 在 L3 之上至少有 1 个可调用入口 |
| L5 | 智能体原生 | Agent-Native | 在 L4 之上满足 2 项高级要求 |
纯展示站没有 API、没有交易,就不该因为没有 MCP 被判低分。规则按类型适用,不适用的记为 na 并剔出分母;等级上限也按类型设定。
| 类型 | 名称 | English | 等级上限 | 说明 | 该类型不适用的规则 |
|---|---|---|---|---|---|
content | 内容/展示站 | Content Site | L3 | 没有对外 API、没有交易,用户只是来读内容。合理上限是 L3 智能体可读。 | AR-ACT-01、AR-ACT-02、AR-ACT-03、AR-ACT-04、AR-ACT-05、AR-ACT-06、AR-ACT-07、AR-ACT-08 |
app | 产品/应用站 | API / Application | L5 | 有可调用的 API 或工具,智能体应当能完成任务。 | — |
commerce | 电商站 | Commerce | L5 | 有商品与交易,智能体可能需要比价或下单。 | — |
不传类型时按公开信号自动判定:出现商品/购物车信号判电商站;出现 OpenAPI / MCP / AI Catalog 判应用站;其余按内容站处理(门槛最低,最不容易误伤)。
对照 AgentReady v2.0(2026-10,MIT) 的 23 条 AR-* 要求逐条判定。共 23 条:18 条符合、1 条部分符合、4 条不适用。其中 MUST 级 4 条,4 条全部满足。
| 要求 | 强度 | 原文要点 | 本站 | 对应规则 | 说明 |
|---|---|---|---|---|---|
AR-FIND-01 | MUST | Allow agents in robots.txt and bot protection | 符合 | AR-FIND-01 | |
AR-FIND-02 | SHOULD | Publish the answer as first-party docs | 符合 | — | 已发布 /docs/ 第一方文档 |
AR-FIND-03 | SHOULD | List your pages in a sitemap.xml | 符合 | AR-FIND-02 | |
AR-FIND-04 | MAY | Publish an AI Catalog and link it | 符合 | AR-ACT-07 | 文件在 /.well-known/ai-catalog.json,首页 head 已用 link rel=ai-catalog 指向 |
AR-READ-01 | MUST | Fetchable without JavaScript | 符合 | AR-READ-01 | |
AR-READ-02 | MUST | Return real HTTP status codes | 符合 | AR-READ-07 | |
AR-READ-03 | SHOULD | Homepage in raw HTML | 符合 | AR-READ-01 | |
AR-READ-04 | SHOULD | Docs pages that answer | 符合 | — | 已发布 /docs/,含快速开始、API 参考、方法、价格、FAQ |
AR-READ-05 | SHOULD | Fenced code, language-tagged | 符合 | — | 文档与落地页代码块均带 language-* 标记 |
AR-READ-06 | SHOULD | .well-known/* protocol and metadata discovery | 符合 | AR-MANI-01 | |
AR-READ-07 | SHOULD | llms.txt | 符合 | AR-FIND-04 | |
AR-READ-08 | SHOULD | JSON-LD machine-readable facts | 符合 | AR-READ-03 | |
AR-READ-09 | MAY | Markdown mirror / content negotiation | 符合 | AR-MANI-03 | |
AR-READ-11 | SHOULD | Pricing on a first-party page | 符合 | — | 价格以 HTML 文本呈现在首页与 /docs/ |
AR-ACT-01 | SHOULD | Auth an agent can get through | 不适用 | AR-ACT-05 | 本站所有端点公开只读、无需凭据;写入仅报告请求且不创建账号,故不存在需要鉴权的资源 |
AR-ACT-02 | SHOULD | Public API with a machine-readable contract | 符合 | AR-ACT-04 | |
AR-ACT-03 | SHOULD | MCP server | 符合 | AR-ACT-01 | |
AR-ACT-05 | MAY | MCP Apps (ui:// views) | 不适用 | — | 产品无需要在智能体宿主内渲染的交互界面 |
AR-ACT-06 | SHOULD | SDKs and a CLI | 部分符合 | AR-ACT-06 | 有 CLI;未发布 npm/PyPI SDK |
AR-ACT-07 | SHOULD | WebMCP in-page tools | 符合 | — | 页面已用 document.modelContext 注册 scan_site |
AR-ACT-08 | MAY | Let agents pay | 不适用 | — | 面向人的微信扫码支付,不对智能体开放支付 |
AR-ACT-09 | MAY | NLWeb /ask endpoint | 不适用 | — | 未实现 NLWeb,诊断通过结构化 API/MCP 提供 |
AR-ACT-10 | MUST | An MCP server or a CLI | 符合 | AR-ACT-01 | 两者都有 |
同一域名、同一时刻,任何人跑出的结果应当一致(结果缓存 6 小时)。
# 完整结果(分数、等级、逐条检查)
curl -sS "https://geo.paibaowork.com/public/agent-ready?domain=example.com"
# 只要规则表(本文档的机器可读版)
curl -sS "https://geo.paibaowork.com/public/agent-ready?format=rules"
# 按指定站点类型判定
curl -sS "https://geo.paibaowork.com/public/agent-ready?domain=example.com&type=content"
# 与 isitagentready.com 并排对照
curl -sS "https://geo.paibaowork.com/public/agent-ready?domain=example.com&compare=1"
MCP 用户:POST https://geo.paibaowork.com/public/mcp,工具 agent_ready_rules 返回同一份规则表。
| 版本 | 日期 | 变更 |
|---|---|---|
| v1.0.0 | 2026-11-03 | 首次发布:27 条规则、L0–L5 分级、站点类型(内容/应用/电商)、AgentReady v2.0 符合性表。 |