cas-bigdatalab/piflow/chemdb-search

chemdb_search 技能

功能说明

该技能用于调用化学物质基础数据库搜索服务，根据用户输入的化学分子式检索并返回对应的化学物质详细信息，展示时按json字段含义格式化展示并将image字段的 SVG 数据可直接渲染为分子结构示意图，便于直观查看物质结构。

触发条件

当用户希望：

• 检索化学物质详细信息
• 查看化学物质详细信息
• 检索化学物质基础数据库
• 查询特定化学分子式的物质信息
• 获取化学物质的详细属性

调用服务说明

化学物质基础数据库搜索服务

该接口来自 化学物质基础数据库（[chemdb.csdb.cn](https://chemdb.csdb.cn)），核心功能是根据输入的化学分子式（如 C6H6、C12H12），检索并返回对应的化学物质详细信息，支持分页查询。

接口核心信息

1. 基础配置

• 服务名称：化学物质分子式检索服务
• 接口地址：http://www.chemdb.csdb.cn/chemdb_backend/search/text_search
• 请求方式：GET
• 响应状态：成功返回 200，message 为 "success"

2. 请求参数（URL 参数）

3. 响应数据结构（核心字段说明）

响应为 JSON 格式，核心包含data（化学物质列表）和分页相关字段：

data数组中单个化学物质的关键字段

使用方法

1. 调用 scripts/chemdb_search.py 脚本
2. 提供必要参数 text（化学分子式）
3. 可选择提供参数 page（分页页码）和 page_size（每页大小）
4. 脚本将返回接口的完整 JSON 响应

输出格式

按查询结果json的每一条字段的含义属性格式化展示查询结果，并将image字段的 SVG 数据可直接渲染为分子结构示意图，便于直观查看物质结构。

补充说明

1. 检索范围：仅支持化学分子式检索（如 C6H6、C12H12），输入其他类型关键词可能无匹配结果；
2. 数据完整性：返回的化学物质信息涵盖分子结构、命名、标识、分子量等核心属性，满足化学研究、物质识别等场景需求；
3. 分页机制：通过page和page_size控制返回数量，示例中检索 C6H6 共匹配 1244 条结果，分 125 页展示；
4. 分子结构可视化：image字段的 SVG 数据可直接渲染为分子结构示意图，便于直观查看物质结构。

示例

示例 1：检索 C6H6 的化学物质信息

python scripts/chemdb_search.py --text C6H6

示例 2：检索 C12H12 的化学物质信息，指定分页参数

python scripts/chemdb_search.py --text C12H12 --page 2 --page_size 20

错误处理

• 如果未提供必要参数 text，脚本将提示错误并退出
• 如果接口调用失败，脚本将返回错误信息
• 如果网络连接失败，脚本将提示网络错误