Agent-Readable Docs Framework

What is it（这是什么）

Agent-Readable Docs Framework 是一类文档框架的新形态：它生成的文档站点同时服务两类读者——人类开发者和 AI Agent。传统文档工具（如 Docusaurus、Mintlify）只输出给人看的 HTML 页面，而 Blume 2.0、Octri.dev、DocsAlot 这类产品在生成人类可读文档的同时，自动产出结构化的 Agent 接口，典型形式是自动生成 MCP（Model Context Protocol）server。这意味着当用户的 AI 编程助手（Cursor、Claude Code、Windsurf）需要查询某个 API 或 SDK 的用法时，不再靠爬网页猜语义，而是直接调用文档暴露的 MCP 工具拿到精确答案。商业本质：文档从"营销资产+阅读材料"变成"Agent 可调用的知识 API"，谁掌握这个转换层，谁就掌握 AI 编程时代的文档分发入口。

Why now（为什么现在出现）

三个条件在 2026 年同时成熟。第一，MCP 协议在 2025 年被 Anthropic 推出后，到 2026 年已成为 Agent 工具调用的实际标准，Claude Code、Cursor、Windsurf 全部原生支持，Agent 有了统一的"读文档"接口。第二，AI 编程助手的上下文窗口虽然变大，但把整个文档站塞进上下文依然昂贵且低效，RAG 式网页爬取又经常拿到过时或错误的片段，开发者对"Agent 读错文档"的抱怨在 2025 年底集中爆发。第三，文档工具赛道本身增长见顶，Mintlify、ReadMe 的差异化空间收窄，厂商需要新叙事。这个趋势不是一年前出现，是因为一年前 MCP 生态还不存在；也不是一年后，因为现在正是文档厂商抢"Agent 原生"定位的窗口期，晚一年头部玩家已经完成卡位。

Market Evidence（市场证据）

当前信号非常早期：仅 1 个独立信源（Product Hunt），总提及 3 次，趋势分 60/100，增长率 100%。100% 增长率在这个基数下不构成有意义的统计信号——从 1 到 2 也是 100%。真正有价值的信息是：Blume 2.0、Octri.dev、DocsAlot 三家在同一个 Product Hunt 周期内推出同类定位产品，这不是巧合，而是文档工具厂商对同一个市场压力的同步反应。成熟度 nascent 的判断准确。信号质量：这是真实需求的早期信号，但尚未被验证为付费需求。判断依据是产品集中出现（供给侧确认）而非开发者讨论量爆发（需求侧确认）。机会分、市场分、竞争分、需求分全部为 0，说明评分模型没有足够数据支撑任何方向的判断，不应据此做决策。

Who's Behind It（谁在推动）

三家已知玩家：Blume 2.0 是已有文档框架的版本升级，走"老产品加 Agent 能力"路线；Octri.dev 和 DocsAlot 更可能是原生新玩家，直接以 Agent-Readable 为核心卖点。这个领域的"庄家"目前缺席——Mintlify、Docusaurus（Meta）、ReadMe、GitBook 这些文档层头部玩家还没有公开的 Agent-Readable 产品。真正的底层推动者是 Anthropic（MCP 协议制定方）和 AI 编程工具厂商（Cursor、Windsurf），它们决定了 Agent 如何消费文档。独立开发者的机会在于：头部厂商的转身需要 6-12 个月，这段时间是空窗期。

TAM & Market Size（市场规模）

潜在用户是"有公开 API/SDK 文档需要维护"的开发团队。全球活跃的 API 产品大约 5-8 万个（Postman API Network 收录约 3 万，加上未收录的私有和开源项目），其中愿意为文档工具付费的比例约 10-15%，即 5000-12000 个付费客户。文档工具客单价区间 $20-$500/月，Mintlify 起步 $150/月，ReadMe 企业版 $500+/月。取中间值 $100/月，可寻址市场约 $600 万-$1400 万 ARR——这是一个典型的"小而美"市场，适合独立开发者，不适合 VC 级公司。付费意愿明确：文档是开发者体验（DX）的核心预算项。市场处于增长期，驱动力是 AI 编程工具渗透率上升。注意机会分 0/100、需求分 0/100 反映的是数据不足，不是市场不存在。

Competitive Landscape（竞争格局）

直接竞争：Blume 2.0、Octri.dev、DocsAlot，三家都处于极早期，产品成熟度和用户量都未验证。间接竞争：Mintlify（$150/月起，已有 AI 搜索但无 MCP 输出）、Docusaurus（免费开源，无 Agent 能力）、GitBook（企业向，转型慢）、ReadMe（API 文档专精，无 MCP）。竞争分 0/100 说明评分模型认为竞争尚未形成。差异化机会有三个：一是开源核心 + 托管变现（Docusaurus 用户迁移路径）；二是专攻"从 OpenAPI/GraphQL schema 一键生成 MCP server"这个具体场景；三是做 MCP 文档的验证和监控层（Agent 调用文档的准确率测试）。大公司会不会做？Mintlify 和 GitBook 一定会做，但它们要兼顾现有产品线，转身至少 6-12 个月。这个窗口期就是独立开发者的全部机会。

Business Model（商业模式）

推荐免费增值 + 订阅制。理由：文档工具是持续使用型产品，用户一旦接入不会频繁更换，订阅制能吃到长期 LTV；免费层（开源核心或免费托管额度）是获取开发者用户的唯一低成本路径。

定价设计：Free 层——单项目、公开文档、基础 MCP server 生成，$0；Pro 层——$29/月，多项目、私有文档、MCP server 自定义工具描述、调用分析；Team 层——$99/月，5 席位、SSO、审计日志、SLA。定价依据：低于 Mintlify 的 $150/月起步，卡在独立开发者和早期创业公司能自决策的价位。不要做 $9/月，会吸引非目标用户且无法覆盖支持成本。

12 个月收入预测：保守——50 个 Pro 用户，$1.5K MRR；基准——200 个 Pro + 20 个 Team，$7.8K MRR；乐观——600 个 Pro + 80 个 Team，$25K MRR。用户获取：Product Hunt 首发 + GitHub 开源引流 + 开发者社区（Hacker News、Reddit r/webdev）内容营销，CAC 估算 $30-$80，回本周期 1-3 个月（按 Pro 层计）。

MVP Blueprint（MVP 蓝图）

核心功能（只做这些）：

1. 输入 OpenAPI/GraphQL schema 或 Markdown 文档目录，生成人类可读文档站
2. 同一份源自动生成 MCP server（stdio + SSE 两种传输）
3. MCP server 暴露 3 个工具：search_docs、get_endpoint、list_resources
4. 一个部署命令，输出托管 URL + MCP 连接配置

砍掉：自定义主题、多语言、权限管理、分析面板、CI 集成。

技术栈：Next.js（文档站渲染）+ TypeScript（MCP server 生成）+ Cloudflare Workers（托管 MCP server，边缘部署便宜）+ Postgres（项目元数据）+ Stripe（订阅）。

最快上线路径：用 Mintlify 或 Nextra 的现成模板做文档渲染层，只自研"MCP server 生成器"这一核心模块；MCP server 用官方 TypeScript SDK，2 天可跑通；托管用 Cloudflare Workers，避免自建服务器；首发平台 Product Hunt + GitHub。7 天可上线可用版本。建议产品类型 SaaS + API 组合，Tool 形态作为引流。

Commercial Opportunities（商业化机会）

方向一：托管式 Agent-Readable 文档平台。目标用户是有公开 API 的中小 SaaS 团队（10-50 人工程团队）。预期月收入 $3K-$15K。优于其他方向的原因：订阅制现金流稳定，用户迁移成本高，一次接入长期付费。

方向二：MCP 文档生成 CLI 工具 + 企业版。目标用户是已有文档站、只想加 Agent 能力的大团队。预期月收入 $2K-$10K（企业授权）。优于其他方向的原因：不替换现有文档工具，降低采用阻力，可以卖给 Mintlify 用户。

方向三：Agent 文档准确率监控 API。目标用户是文档质量敏感的平台团队。预期月收入 $1K-$5K。优于其他方向的原因：这是文档厂商不会做的中立第三方工具，可以卖给所有文档框架的用户。

Product Ideas（产品创意）

🥇 DocMCP — 一句话价值主张："把你的 API 文档变成 MCP server，一条命令。"目标用户：有 OpenAPI schema 的 API 产品团队。场景：开发者接入 Cursor 后，AI 助手直接查询你的 API 文档而不爬网页。为什么现在：MCP 已成标准，但文档厂商还没做原生支持，6-12 个月窗口期。

🥈 AgentDocs Audit — 一句话价值主张："测试你的文档对 AI Agent 有多友好。"目标用户：文档负责人、DX 工程师。场景：输入文档 URL，输出 Agent 可读性评分和修复建议。为什么现在：需求侧验证工具，本身是引流产品，可转化为付费文档优化服务。

🥉 MCP Registry — 一句话价值主张："公开 MCP server 的发现和索引层。"目标用户：AI 工具用户和 MCP 开发者。场景：像 npm 搜包一样搜 MCP server。为什么现在：MCP server 数量在爆发，但缺乏索引，先发者占据品类定义权。

SEO Opportunity（SEO 机会）

搜索量趋势：上升，但绝对量小（"MCP server" 相关词月搜索量在千级）。有价值的长尾关键词："generate MCP server from OpenAPI"、"agent readable documentation"、"MCP server for API docs"、"docs framework MCP"、"Blume 2.0 alternative"。竞争程度：SEO 难度 0/100，几乎没有竞争内容。内容策略：做对比页（vs Mintlify、vs Docusaurus）和教程页（"如何为你的 API 生成 MCP server"），这两类页面最容易拿到排名且转化意图明确。

Risk Assessment（风险评估）

判断会错的情况：如果 MCP 协议被 OpenAI 或 Google 的竞争标准取代，整个方向需要重做接口层；如果 AI 编程工具改为直接读 OpenAPI schema 而不需要文档层，中间商价值消失。

三大风险：技术风险——MCP 协议仍在演进，破坏性变更可能让产品返工（中高）；市场风险——文档工具付费市场本身不大，天花板 $1400 万 ARR（中）；执行风险——头部厂商（Mintlify）6 个月内推出同类功能，独立开发者被碾压（高）。

最低成本验证：花 2 天做一个 CLI，把任意 OpenAPI schema 转成 MCP server，发到 Hacker News 和 MCP 社区，看有多少人实际使用并询问托管版本。如果 48 小时内没有 50+ 真实使用，说明需求不成立。

放弃信号：Mintlify 或 GitBook 发布原生 MCP 功能且免费提供，此时立即转向方向三（监控工具）或退出。

Action Plan（行动建议）

第一步（今天）：用 MCP 官方 TypeScript SDK 写一个最小脚本，读取一个公开 OpenAPI schema，生成可用的 MCP server，在 Claude Code 里跑通一次查询。这一步验证技术可行性，成本 4 小时。

低成本验证（本周）：把脚本包装成 CLI 发到 GitHub，在 Hacker News、Reddit r/mcp、MCP Discord 发帖，收集使用反馈和托管需求。

信号确认后第二步（第二周）：如果收到 20+ 个"求托管版"请求，开始做 SaaS 版，先做 3 个付费用户的手动服务（concierge MVP），验证付费意愿。

时间线：第一周完成 CLI 和验证；第一个月上线托管 MVP 并拿到前 10 个付费用户；第三个月达到 $3K MRR，决定是否加码或转向监控工具方向。

Related Terms（相关趋势）

• MCP (Model Context Protocol) — 依赖关系，Agent-Readable Docs 的输出目标协议，没有 MCP 这个趋势不成立
• AI Coding Assistant — 互补关系，Cursor/Claude Code 是文档 MCP server 的主要消费者
• RAG — 竞争关系，网页爬取式 RAG 是 Agent 读文档的旧方案，MCP 是替代路径