Agent Ready 方法论 v1.0.0

这份文档把我们的检测口径完整公开:27 条规则、四维权重、L0–L5 门槛、按站点类型的适用范围,以及与 AgentReady v2.0 的逐条符合性。任何人都可以按这里的判据复现同一结果。

版本 v1.0.0 · 生效 2026-11-03 · 维护方:派宝 GEO · 机器可读版本:/public/agent-ready?format=rules
声明:本方法论由派宝 GEO 维护,不是任何标准化组织发布的标准,也未获得 AgentReady 项目认证。 我们与 AgentReady v2.0(MIT)对齐并逐条标注符合性,但「对齐」不等于「认证」。

一、27 条规则与权重

四维合计 100 分。判定:ok 拿满权重、warn 拿一半、fail 记 0、na 剔出分母(不参与计分)。

规则 ID检查项权重为什么重要
发现 find · 权重 25
AR-FIND-01robots.txt 允许 AI 爬虫6robots.txt 整站屏蔽 AI 爬虫时,智能体连页面都拿不到。
AR-FIND-02sitemap.xml 可访问4提供 sitemap 让智能体一次拿全站 URL,不必猜路径。
AR-FIND-03sitemap 含 lastmod2lastmod 告诉智能体哪些页面是新改的,决定它先读哪一页。
AR-FIND-04llms.txt 就绪6llms.txt 是给 LLM 的站点摘要,缺失时智能体只能靠猜。
AR-FIND-05HTML 内链接发现文件3llms.txt / OpenAPI 要在页面里被链接到;实测多数抓取来自链接而非猜路径。
AR-FIND-06Link 响应头声明4RFC 8288 的 Link 头让智能体从响应头就能找到 llms.txt / API 描述,不用解 HTML。
可读 read · 权重 30
AR-READ-01首屏 HTML 含正文8答案藏在 JavaScript 里是智能体失败的头号原因,正文必须服务端渲染。
AR-READ-02语义结构清晰4唯一 H1 + 合理 H2 层级,智能体才分得清标题与正文。
AR-READ-03JSON-LD 结构化数据6Organization/WebSite/FAQPage 等实体声明,让智能体确认你是谁。
AR-READ-04JSON-LD 关键字段3只有 @type 不够,name / url 等字段才让实体可被引用。
AR-READ-05meta description + canonical4摘要与规范地址决定智能体摘录哪一句、引用哪个 URL。
AR-READ-06Open Graph 标签3og:title / og:description 是智能体生成引用卡片的第一来源。
AR-READ-07真实 HTTP 状态码2缺失页面必须返回 404 而不是 200,否则智能体会把错误页当答案。
可调用 act · 权重 30
AR-ACT-01MCP 端点可发现6MCP 是智能体调用工具的标准接口,须有 server card 或 well-known 声明。
内容站不适用
AR-ACT-02A2A Agent Card5A2A 卡描述智能体能替你完成什么,是跨智能体协作的入口。
内容站不适用
AR-ACT-03Agent Skill / AGENTS.md4skill.md 或 AGENTS.md 用自然语言告诉智能体什么时候、怎么调用你。
内容站不适用
AR-ACT-04OpenAPI 描述4有 OpenAPI 的 HTTP 面才能被智能体稳定地当成工具调用。
内容站不适用
AR-ACT-05Agent 认证发现3OAuth/OIDC 或 auth.md 让智能体知道怎么拿到凭证。
内容站不适用
AR-ACT-06CLI 用法有文档2给智能体一条可直接执行的命令,比让它猜 API 更可靠。
内容站不适用
AR-ACT-07ARD 能力清单3/.well-known/ai-catalog.json 用条目列出可调用的能力,比散落的卡片更容易被索引。
内容站不适用
AR-ACT-08agent-permissions 权限声明3明确写出智能体能读什么、能写什么、不能碰什么,减少越权调用。
内容站不适用
清单与声明 manifest · 权重 15
AR-MANI-01agent-ready / agents 清单4机器可读的自述文件,一次说清入口、鉴权与文档位置。
AR-MANI-02AI 使用声明(Content-Signal)2在 robots.txt 里声明 ai-train / search / ai-input 意图,避免默认被当成禁止。
AR-MANI-03Markdown 内容协商3Accept: text/markdown 时返回 markdown 原文,省掉智能体的解析成本。
AR-MANI-04llms-full.txt 全文版2llms.txt 给索引,llms-full.txt 给一次抓全的全文,两者配合最省调用。
AR-MANI-05sitemap.md / AGENTS.md 镜像2给智能体的 markdown 版导航与项目说明,比解析 HTML 更稳。
AR-MANI-06Poppy 个人智能体清单2/.well-known/poppy.json 声明组织与网站级接入方式(纯网站可只写 web:{})。

二、L0–L5 分级

门槛递进:每一级都建立在前一级之上。等级与百分制并存——分数看差距,等级看阶段。

等级名称English门槛
L0未就绪Not Ready连基础可发现都没做到
L1基础可发现Basic Web Presencerobots / 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 SiteL3没有对外 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 / ApplicationL5有可调用的 API 或工具,智能体应当能完成任务。—
commerce电商站CommerceL5有商品与交易,智能体可能需要比价或下单。—

不传类型时按公开信号自动判定:出现商品/购物车信号判电商站;出现 OpenAPI / MCP / AI Catalog 判应用站;其余按内容站处理(门槛最低,最不容易误伤)。

四、AgentReady v2.0 符合性

对照 AgentReady v2.0(2026-10,MIT) 的 23 条 AR-* 要求逐条判定。共 23 条:18 条符合、1 条部分符合、4 条不适用。其中 MUST 级 4 条,4 条全部满足。

要求强度原文要点本站对应规则说明
AR-FIND-01MUSTAllow agents in robots.txt and bot protection符合AR-FIND-01
AR-FIND-02SHOULDPublish the answer as first-party docs符合—已发布 /docs/ 第一方文档
AR-FIND-03SHOULDList your pages in a sitemap.xml符合AR-FIND-02
AR-FIND-04MAYPublish an AI Catalog and link it符合AR-ACT-07文件在 /.well-known/ai-catalog.json,首页 head 已用 link rel=ai-catalog 指向
AR-READ-01MUSTFetchable without JavaScript符合AR-READ-01
AR-READ-02MUSTReturn real HTTP status codes符合AR-READ-07
AR-READ-03SHOULDHomepage in raw HTML符合AR-READ-01
AR-READ-04SHOULDDocs pages that answer符合—已发布 /docs/,含快速开始、API 参考、方法、价格、FAQ
AR-READ-05SHOULDFenced code, language-tagged符合—文档与落地页代码块均带 language-* 标记
AR-READ-06SHOULD.well-known/* protocol and metadata discovery符合AR-MANI-01
AR-READ-07SHOULDllms.txt符合AR-FIND-04
AR-READ-08SHOULDJSON-LD machine-readable facts符合AR-READ-03
AR-READ-09MAYMarkdown mirror / content negotiation符合AR-MANI-03
AR-READ-11SHOULDPricing on a first-party page符合—价格以 HTML 文本呈现在首页与 /docs/
AR-ACT-01SHOULDAuth an agent can get through不适用AR-ACT-05本站所有端点公开只读、无需凭据;写入仅报告请求且不创建账号,故不存在需要鉴权的资源
AR-ACT-02SHOULDPublic API with a machine-readable contract符合AR-ACT-04
AR-ACT-03SHOULDMCP server符合AR-ACT-01
AR-ACT-05MAYMCP Apps (ui:// views)不适用—产品无需要在智能体宿主内渲染的交互界面
AR-ACT-06SHOULDSDKs and a CLI部分符合AR-ACT-06有 CLI;未发布 npm/PyPI SDK
AR-ACT-07SHOULDWebMCP in-page tools符合—页面已用 document.modelContext 注册 scan_site
AR-ACT-08MAYLet agents pay不适用—面向人的微信扫码支付,不对智能体开放支付
AR-ACT-09MAYNLWeb /ask endpoint不适用—未实现 NLWeb,诊断通过结构化 API/MCP 提供
AR-ACT-10MUSTAn 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.02026-11-03首次发布:27 条规则、L0–L5 分级、站点类型(内容/应用/电商)、AgentReady v2.0 符合性表。
© 派宝 · GEO 生成式引擎优化 —— 让回答你客户的 AI 引用到你。
方法论问题请联系:geo.paibaowork.com