agent-readiness

商家侧 API 与文档的 agent 可用性实测。

这是一个研究站点，也是一台测量仪器。它不售卖任何产品，不提供 API 服务，没有注册流程。 如果你在找一个可以调用的接口，这里没有。

归属声明：这是一个个人研究项目，不代表任何公司或机构。本站内容不构成对任何被提及公司的评价、推荐或指控；所有结论都带有方法与样本的限定，请连同限定一起读。

为什么有这个站点

2026 年出现了一个说法：应用公司的用户正在从「人」变成「agent」。Stripe 联合创始人 John Collison 在一次访谈里把它说得最直接——现在没有人再手工集成 Stripe 的 API 了，大家派自己的编程 agent 去做，而「开发者体验和 AI 体验是两回事」。

这个说法如果成立，有一个可检验的推论：一份面向人类开发者写得很好的文档，agent 读起来可能照样会失败（比如选错 API 版本）。反过来，如果大量真实存在的商家侧服务，agent 根本无法仅凭公开文档完成一次集成，那么「通用 agent 会吃掉所有数据搬运工作」这个预测，至少在今天是不成立的。

这件事没有公开数据。所以这里自己测。

这里有什么

• 一手源 vs 中文转述：AEO 清单在翻译里丢了什么 — 把 Addy Osmani 的 *Agentic Engine Optimization* 原文与一份流传较广的中文转述逐项对照。主要发现是原作者给自己划的适用边界被整段删除，以及一条硬上限在转述里变成了三个软目标。
• 预注册：渠道管理商文档的 agent 集成实测 — 测试协议、样本选取规则与判定阈值。在跑测试之前发布，所以结果出来以后无法事后挪动判据。

关于这个站点自身

本站同时是上述问题的观测点：它按 agent 可读性的六层清单搭建（robots.txt / llms.txt / skill.md / Markdown 直达 / token 元数据 / AGENTS.md），并在服务端记录每个请求的 User-Agent 分类，用来得到一条 AI 访问 : 人类访问 的基线。

记录的字段是：时间、路径、User-Agent、Referer、国家、ASN 组织。不记录 IP 地址。

所有页面都有 Markdown 直达版本：在路径后加 .md 即得（/aeo → /aeo.md）。索引见 /llms.txt，能力声明见 /skill.md。