# 文档总览 (/docs)

拉格朗日提供统一的商标数据 API：一次接入，即可检索、筛查与监控多个法域的商标记录。数据结构归一化、状态口径统一，并同时提供 OpenAPI 规范与 MCP Server。

## 从这里开始 [#从这里开始]

| 目标 | 页面 |
| --- | --- |
| 5 分钟拿到第一条检索结果 | [快速开始](/docs/quickstart) |
| 了解鉴权与密钥管理 | [鉴权与密钥](/docs/authentication) |
| 看清一条商标记录的结构 | [数据模型](/docs/data-model) |
| 理解各局状态的归一规则 | [状态体系](/docs/status-taxonomy) |
| 查检索与相似度筛查参数 | [商标检索](/docs/search) |
| 确认某法域的数据与更新节奏 | [数据覆盖与新鲜度](/docs/coverage) |
| 导入 Postman / 生成 SDK | [OpenAPI 规范](/docs/api-reference) |
| 接到 Claude Desktop / Cursor | [MCP Server](/docs/mcp-overview) |

## 给机器读的入口 [#给机器读的入口]

本站所有内容都以三种形式提供，方便爬虫与 AI Agent 直接消费：

- [`/llms.txt`](/llms.txt) — 全站页面索引（标题 + 链接 + 摘要）
- [`/llms-full.txt`](/llms-full.txt) — 全站 Markdown 合集，一次请求拿走全部正文
- 任意页面顶部的「复制 Markdown / 更多 AI 操作」按钮（可直接把本页送进 ChatGPT、Claude、Cursor），或把页面地址换成 `/llms.mdx/docs/<slug>/content.md`

<Callout type="info" title="鉴权与计费">

所有接口使用 API Key 鉴权，检索类 10 点/次、其余 1 点/次，失败请求不扣点。详见[鉴权与密钥](/docs/authentication)。

</Callout>

## 约定 [#约定]

- 响应统一信封 `{ code, msg, data }`，`code="0000"` 表示成功
- 时间统一为 Unix 毫秒时间戳，`0` 表示未知
- 分页请求 `current` / `size`，响应 `data.current/size/total/records`
- 只存各局原始数据不翻译，与官方登记号（`externalId`）可直接 join