# agent-readiness

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

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

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

## 为什么有这个站点

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

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

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

## 这里有什么

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

## 关于这个站点自身

本站同时是上述问题的观测点：它按 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`](/llms.txt)，能力声明见 [`/skill.md`](/skill.md)。