用途:查询 EMBL-EBI Ontology Lookup Service(OLS),检索生物医学本体术语、定义与层级关系,覆盖 250 多个本体(如 GO、DOID 等)。
主要能力:按关键词跨本体搜索术语;对部分名称自动补全;按 OBO ID 或 IRI 获取术语详情、同义词、定义与关系(parents、children、ancestors、descendants 及 hierarchical 变体);获取属性、个体、本体元数据与 OLS 索引统计。
使用方式:需先安装 uv 并确保其在 PATH 中。所有 API 交互必须使用 scripts/ 下的配套脚本,禁止直接用 curl 或自定义 Python 请求。常用命令示例:uv run scripts/search_ols.py --query "diabetes" --rows 5 --output /tmp/ols_search_results.json 2>/dev/null;uv run scripts/get_term.py --obo_id "GO:0005634" --summary --output /tmp/nucleus_full.json;uv run scripts/suggest_ols.py --query "diabet" --rows 5 --output /tmp/ols_suggest.json 2>/dev/null。--output 为必填。
适用场景:疾病、表型、基因功能、化学物、解剖结构、细胞类型等术语解析与层级探索。本体选择建议:常见人类疾病用 doid,表型用 hp,基因功能用 go,化学物用 chebi,解剖用 uberon,细胞类型用 cl;仅在明确需要跨物种时用 mondo。
限制:须遵守 EBI 使用条款,最大 5 请求/秒,脚本已自动限速。若工作区根目录不存在 .licenses/embl_ebi_ols_LICENSE.txt,需先提示用户查看 https://www.ebi.ac.uk/ols4/api-docs 条款并创建记录文件。使用该技能时须在输出中提及。多步查询应限定在单一最合适的本体中,避免跨多个本体搜索。