# 文档


- **入门**
- [快速开始](https://docs.isud.cn/docs/quickstart): 5 分钟完成注册、获取 API Key 并拿到第一条商标检索结果的完整流程。
- [鉴权与密钥](https://docs.isud.cn/docs/authentication): 拉格朗日 API 的 Bearer Token 鉴权方式、组织密钥池、密钥创建与轮换规则。

- **核心概念**
- [数据模型](https://docs.isud.cn/docs/data-model): 商标记录的统一字段结构：四轴状态、溯源四件套、多语原文与尼斯分类对应关系。
- [状态体系](https://docs.isud.cn/docs/status-taxonomy): 27 个商标局的状态如何归一化为四轴模型，跨局口径对照与查询字典。

- **API 指南**
- [商标检索](https://docs.isud.cn/docs/search): POST /v1/trademarks/search 的精确检索与相似度筛查参数、分页、计费与错误码。
- [数据覆盖与新鲜度](https://docs.isud.cn/docs/coverage): 27 个商标局、1.3697 亿条记录的真实覆盖明细、最近同步时间与已知缺口，覆盖数字按周对账。
- [OpenAPI 规范](https://docs.isud.cn/docs/api-reference): OpenAPI 3.1 规范下载与导入说明，覆盖商标检索、设计检索、报告与统计端点。

- **API 端点参考**
- Openapi
  - [工作台汇总统计](https://docs.isud.cn/docs/openapi/getWorkbenchStats): 商标/设计总量、名下资产、风险与监测、案件与期限等汇总计数。
  - [分页查询排查报告](https://docs.isud.cn/docs/openapi/listReports)
  - [分页查询商标档案](https://docs.isud.cn/docs/openapi/listTrademarks)
  - [外观设计检索](https://docs.isud.cn/docs/openapi/searchDesigns): 按关键字与洛迦诺分类检索在先外观设计。每次调用扣 10 点。
  - [商标检索与冲突判定](https://docs.isud.cn/docs/openapi/searchTrademarks): 在指定法域内检索在先商标，执行相似度 + 尼斯分类重叠判定，
返回冲突分级（high / medium / low）与整体结论。
每次调用扣 10 点。传 `saveReport=true` 时生成排查报告并回传 `reportId`。

- **AI Agent**
- [MCP Server](https://docs.isud.cn/docs/mcp-overview): 把拉格朗日商标数据接入 Claude Desktop、Cursor 等 AI Agent 的 MCP Server 配置说明。