# next-ai-ready

> AEO + Agent-API layer for Next.js App Router. Make your site readable by AI and callable by agents.

<!-- Last updated: 2026-06-03 -->

## Introduction

- [Introduction](https://next-ai-ready.vercel.app/en/docs/introduction): What next-ai-ready is and why it exists.
- [简介](https://next-ai-ready.vercel.app/zh/docs/introduction): next-ai-ready 是什么，为什么需要它。

## Installation

- [Installation](https://next-ai-ready.vercel.app/en/docs/installation): Install next-ai-ready and scaffold your first config.
- [安装](https://next-ai-ready.vercel.app/zh/docs/installation): 安装 next-ai-ready 并生成首个配置。

## Project Structure

- [Project Structure](https://next-ai-ready.vercel.app/en/docs/getting-started/project-structure): Understanding the files next-ai-ready creates and where they live.
- [项目结构](https://next-ai-ready.vercel.app/zh/docs/getting-started/project-structure): 了解 next-ai-ready 创建的文件及其作用。

## Quickstart

- [Quickstart](https://next-ai-ready.vercel.app/en/docs/guides/quickstart): Get up and running with next-ai-ready in 5 minutes.
- [快速开始](https://next-ai-ready.vercel.app/zh/docs/guides/quickstart): 5 分钟内让 next-ai-ready 跑起来。

## Concepts

- [Capability Plane](https://next-ai-ready.vercel.app/en/docs/concepts/capability-plane): How next-ai-ready exposes your features as AI-callable tools.
- [How It Works](https://next-ai-ready.vercel.app/en/docs/concepts/how-it-works): The build pipeline, runtime data flow, and what happens under the hood.
- [Knowledge Plane](https://next-ai-ready.vercel.app/en/docs/concepts/knowledge-plane): How next-ai-ready makes your content readable by AI.
- [Two Planes](https://next-ai-ready.vercel.app/en/docs/concepts/two-planes): The Knowledge plane and Capability plane — what each one does and why they are separate.
- [能力平面](https://next-ai-ready.vercel.app/zh/docs/concepts/capability-plane): next-ai-ready 如何将你的功能暴露为 AI 可调用的工具。
- [工作原理](https://next-ai-ready.vercel.app/zh/docs/concepts/how-it-works): 构建管线、运行时数据流和底层机制。
- [知识平面](https://next-ai-ready.vercel.app/zh/docs/concepts/knowledge-plane): next-ai-ready 如何让你的内容被 AI 可读。
- [双平面](https://next-ai-ready.vercel.app/zh/docs/concepts/two-planes): 知识平面和能力平面——各自的作用及分离的原因。

## Guides

- [Actions](https://next-ai-ready.vercel.app/en/docs/guides/actions): How to define, expose, and secure AI-callable actions.
- [Analytics](https://next-ai-ready.vercel.app/en/docs/guides/analytics): Track which AI bots read your content and which actions agents invoke.
- [i18n and AI-friendly URLs](https://next-ai-ready.vercel.app/en/docs/guides/i18n-ai-urls): Middleware, locale prefixes, and SemanticGraph routes for multilingual sites.
- [MCP Integration](https://next-ai-ready.vercel.app/en/docs/guides/mcp-integration): Connect your actions to Claude Desktop, Cursor, and other MCP clients.
- [Writing MDX Content](https://next-ai-ready.vercel.app/en/docs/guides/mdx-content): How to write MDX files that the semantic compiler can extract meaning from.
- [Robots.txt](https://next-ai-ready.vercel.app/en/docs/guides/robots-txt): Configure your robots.txt to explicitly allow or block AI crawlers.
- [Actions](https://next-ai-ready.vercel.app/zh/docs/guides/actions): 如何定义、暴露和保护 AI 可调用的 action。
- [分析](https://next-ai-ready.vercel.app/zh/docs/guides/analytics): 追踪哪些 AI 爬虫读取了你的内容，哪些 agent 调用了你的 action。
- [国际化与 AI 友好 URL](https://next-ai-ready.vercel.app/zh/docs/guides/i18n-ai-urls): 多语言站点的 middleware、locale 前缀与 SemanticGraph 路由策略。
- [MCP 集成](https://next-ai-ready.vercel.app/zh/docs/guides/mcp-integration): 将你的 action 连接到 Claude Desktop、Cursor 和其他 MCP 客户端。
- [编写 MDX 内容](https://next-ai-ready.vercel.app/zh/docs/guides/mdx-content): 如何编写语义编译器能提取含义的 MDX 文件。
- [Robots.txt](https://next-ai-ready.vercel.app/zh/docs/guides/robots-txt): 配置 robots.txt 以显式允许或阻止 AI 爬虫。

## API Reference

- [CLI](https://next-ai-ready.vercel.app/en/docs/api-reference/cli): Command-line interface — init, build, doctor, and mcp.
- [Configuration](https://next-ai-ready.vercel.app/en/docs/api-reference/config): Full reference for ai-ready.config.mjs options.
- [defineAction](https://next-ai-ready.vercel.app/en/docs/api-reference/define-action): API reference for defineAction() and defineActions().
- [Semantic Metadata](https://next-ai-ready.vercel.app/en/docs/api-reference/define-semantic): How to add structured metadata to your MDX content for richer AI extraction.
- [withAiReady](https://next-ai-ready.vercel.app/en/docs/api-reference/with-ai-ready): API reference for the Next.js config wrapper.
- [CLI](https://next-ai-ready.vercel.app/zh/docs/api-reference/cli): 命令行接口——init、build、doctor 和 mcp。
- [配置](https://next-ai-ready.vercel.app/zh/docs/api-reference/config): ai-ready.config.mjs 的完整参考。
- [defineAction](https://next-ai-ready.vercel.app/zh/docs/api-reference/define-action): defineAction() 和 defineActions() 的 API 参考。
- [语义元数据](https://next-ai-ready.vercel.app/zh/docs/api-reference/define-semantic): 如何为 MDX 内容添加结构化元数据以获得更丰富的 AI 提取。
- [withAiReady](https://next-ai-ready.vercel.app/zh/docs/api-reference/with-ai-ready): Next.js 配置包装器的 API 参考。

## Architecture

- [Architecture Decisions](https://next-ai-ready.vercel.app/en/docs/decisions/adr-index): Index of all Architecture Decision Records (ADRs) for next-ai-ready.
- [架构决策](https://next-ai-ready.vercel.app/zh/docs/decisions/adr-index): next-ai-ready 所有架构决策记录（ADR）的索引。