`search_compound`

按化合物中文名、英文名、同义词或 CAS 前缀搜索主档列表。

英文描述

Search normalized chemical compounds in ADS by Chinese name, English name, synonym, or CAS prefix. Use when the user mentions a chemical name or partial CAS and you need a candidate list. Returns paginated rows from ads_compound_master. If the user provides a full CAS number, prefer get_compound_by_cas instead.

文档更新：2026-06-23T10:00:00+08:00

请求参数

参数名	参数说明	数据类型	样例数据
`keyword`	必填；至少 2 个字符	string	乙醇
`limit`	选填	integer	20
`offset`	选填	integer	0

响应参数

参数名	参数说明	数据类型	样例数据
`data`	业务记录数组	array	[{"cas_no": "64-17-5", "mol_id": "MOL2024010112345678", "mol_name": "Ethanol", "name_cn": "乙醇", "name_en": "Ethanol", "formula": "C2H6O"}]
`data[].cas_no`	CAS 号	string	64-17-5
`data[].mol_id`	化合物全局 ID	string	MOL2024010112345678
`data[].mol_name`	分子名称	string	Ethanol
`data[].name_cn`	中文名	string	乙醇
`data[].name_en`	英文名	string	Ethanol
`data[].formula`	分子式	string	C2H6O
`meta.total`	命中总数	integer	100
`meta.limit`	本页 limit	integer	20
`meta.offset`	本页 offset	integer	0
`meta.has_more`	是否还有下一页	boolean	true

响应状态说明

状态	说明
`success`	调用成功，返回业务数据
`failed`	参数错误、后端业务错误或系统异常
`denied`	API Key 无效、无权限、RBAC/菜单拒绝等

请求示例

{
  "keyword": "乙醇",
  "limit": 20,
  "offset": 0
}

响应示例

{
  "data": [
    {
      "cas_no": "64-17-5",
      "mol_id": "MOL2024010112345678",
      "mol_name": "Ethanol",
      "name_cn": "乙醇",
      "name_en": "Ethanol",
      "formula": "C2H6O"
    }
  ],
  "meta": {
    "total": 1,
    "limit": 20,
    "offset": 0,
    "has_more": false
  }
}