IXNO 基因池 API 文档

免 Key 搜索 12000+ 经过进化验证的代码基因，覆盖中医、软件开发、AI 智能体、办公效率四大领域。

概览与基础信息

IXNO 基因池是一个开放的只读 API 网关，提供对 12000+ 条经过进化验证的代码基因的搜索和查询能力。所有读取操作免 Key、免费用，适合 AI Agent、开发工具、数据分析等场景直接调用。

API 端点一览

端点	方法	说明
/api/v1/search	GET	搜索基因，支持关键词、分类、子类筛选
/api/v1/stats	GET	获取基因池统计信息
/api/v1/genes/{gene_id}	GET	获取单条基因详情
/api/v1/health	GET	健康检查
/mcp	POST	MCP (Model Context Protocol) 端点

认证与限制

所有读取操作（search、stats、genes、health）均无需认证，直接请求即可。写入操作需要单独的 API Key。系统对 IP 进行轻量频控，正常使用不会触发限制。

搜索 API 详解

请求参数

参数	类型	必填	说明
q	string	必填	搜索关键词，支持中英文。如"六味地黄丸"、"React Hook"
category	string	可选	大类筛选：中医 / 软件开发 / AI / 办公技能 / External
sub	string	可选	子类筛选（33 子类，如 经方、方剂学、前端、后端 等）
limit	integer	可选	返回条数，默认 20，最大 100

请求示例

GET https://ixno.com/api/v1/search?q=地黄&category=中医&limit=10

响应示例

{
  "query": "地黄",
  "total": 42,
  "results": [
    {
      "gene_id": "tcm-001",
      "name": "六味地黄丸",
      "desc": "滋阴补肾经典方剂...",
      "fitness": 0.95,
      "domain": "中医",
      "layer": "S0",
      "source": "经典方剂",
      "method": "manual",
      "tags": "[\"滋阴\",\"补肾\",\"经典方\"]",
      "version": "1.0",
      "_score": 6.15
    }
  ]
}

查看搜索 API 完整文档 →

统计 API

请求示例

GET https://ixno.com/api/v1/stats

响应字段

字段	类型	说明
total_genes	integer	基因总数
total_domains	integer	领域数量
tagged_genes	integer	已打标签的基因数
skill_categories	integer	技能分类数
fitness_mean	number	平均适应度分数
layers	object	各层级分布

基因详情 API

路径参数

参数	类型	说明
gene_id	string	基因唯一标识，从搜索结果中获取

请求示例

GET https://ixno.com/api/v1/genes/tcm-001

响应格式与字段说明

所有 API 返回 JSON 格式。基因（Gene）对象包含以下字段：

字段	类型	说明
gene_id	string	基因唯一标识
name	string	基因名称
desc	string	基因描述
fitness	number	适应度分数 0-1，越高代表质量越好
domain	string	所属领域（中医/软件开发/AI/办公技能）
layer	string	进化层级（S0/S1/S2 等）
source	string	来源
method	string	采集方法
tags	string	标签 JSON 数组
version	string	版本号
_score	number	搜索相关度得分（仅搜索结果包含）

错误码

HTTP 状态码	说明
200	请求成功
400	请求参数错误（如缺少必填参数 q）
404	资源不存在（如基因 ID 无效）
429	请求过于频繁，触发频控
500	服务器内部错误

官方 SDK

MCP 协议接入

IXNO 支持 MCP (Model Context Protocol) 协议，可被 Claude Desktop、Cursor、Qoder 等 AI 工具直接调用。MCP 端点提供 health、stats、search 三个工具。

查看 MCP 接入完整指南 →