用途 该技能是一个快速、轻量级的临床术语规范化工具,不是研究型技能。它将部分或非正式的临床术语转换为标准名称或代码,并提供标准化编码系统的完整记录查询。其核心原则是“查找而非猜测”:RxCUI、ICD-10-CM代码、UMLS CUI、HCPCS代码和星等位基因核苷酸变化都是精确标识符,应从工具解析而非凭记忆推断。
主要能力
- 自动补全式查询(NLM Clinical Table Search Service):所有六个工具接受必填terms字符串(部分或全文)和可选max_results(默认20,最大500),无需API密钥。匹配基于前缀/子串,而非仅精确匹配。
- RxTerms_search_drugs:部分药物名 -> RxTerms显示名、可用规格/剂型、RxCUI。输出字段:DISPLAY_NAME、STRENGTHS_AND_FORMS[]、RXCUIS[]。
- HealthConditions_search:非正式症状/问题描述 -> 正式病症名 + ICD-10-CM/ICD-9-CM代码。输出字段:primary_name、consumer_name、icd10cm_codes、term_icd9_code。
- DiseaseNames_search:疾病提及 -> 规范疾病名 + UMLS CUI。输出字段:primary_name、code。
- HCPCS_search:操作/ DME描述 -> HCPCS Level II计费代码。输出字段:code、display。
- StarAlleles_search:基因或部分星等位基因 -> 匹配的星等位基因定义。输出字段:code/allele、nucleotide_change、protein_change、alternate_name。
- NPIProvider_search:提供者/组织名 -> NPI注册条目。输出字段:NPI、name.full、provider_type、addr_practice.full、is_organization。额外可选organization布尔值(默认false)用于搜索组织/医院而非个人。 每个结果集还包含total_count(服务器可用匹配数,可能超过返回页的count)和search_terms(回显查询)。
- 标准化编码系统:ICD-10-CM与RxNorm
- ICD10_search_codes:疾病名、部分名或部分代码 -> 匹配的ICD-10-CM代码及描述(无需认证,NLM Clinical Tables)。
- ICD10_get_code_info:一个精确ICD-10-CM代码 -> 其官方描述(无需认证)。
- ICD11_search_diseases、ICD11_get_entity、ICD11_browse_hierarchy:WHO ICD-11实体查询,需要ICD_CLIENT_ID和ICD_CLIENT_SECRET(在icd.who.int/icdapi免费注册);未设置密钥时调用会报“ICD API authentication required...”错误。
- RxNorm_find_rxcui:药物名 -> RxNorm概念唯一标识符(rxcuis[]、primary_rxcui)。
- RxNorm_get_drug_info:RXCUI或药物名 -> 完整RxNorm属性(name、term_type如IN=成分、BN=品牌、SCD=临床药物、term_type_label)。
- RxNorm_get_related_drugs:RXCUI(可选tty过滤)-> 相关品牌/仿制/剂型产品(related_drugs按关系类型键控、total_related)。
- RxNorm_get_ndc_status_history:11位NDC -> 营销状态时间线(status如ACTIVE、active、历史RxCUI重映射)。
- RxNorm_get_ndc_properties:NDC(任意常见格式)-> 包装/产品标识元数据。 RxTerms用于对部分用户字符串自动补全;RxNorm用于已拥有或需要特定RXCUI或NDC进行下游工作时。
- 癌症本体与检验编码:NCI Thesaurus与LOINC
- NCIThesaurus_search:自由文本词 -> 匹配的NCIt概念代码(term、page_size),无需认证。
- NCIThesaurus_get_concept:NCIt代码 -> 完整定义、同义词(带来源术语)、属性(含UMLS_CUI作为属性条目,非顶层字段)。
- NCIThesaurus_get_children:NCIt代码 -> 直接子类别(向下层级)。
- NCIThesaurus_get_parents:NCIt代码 -> 直接更广类别/药物类别父项(向上层级)。
- NCIThesaurus_get_concept_maps:NCIt代码 -> 到MedDRA/SNOMED/GDC/ICD的跨词汇映射。
- LOINC_search_tests:检验/观察名 -> 匹配的LOINC代码,无需认证。
- LOINC_get_code_details:一个LOINC代码 -> 完整组件/属性/方法细节。
- LOINC_get_answer_list:LOINC代码(或搜索词)-> 其允许的编码值(如有)。
- LOINC_search_forms:临床表单/面板/调查工具名 -> 匹配的整工具LOINC代码。 重要限制:LOINC索引(clinicaltables loinc_items/v3)不发布SYSTEM(标本类型)、SCALE_TYP、CLASS、METHOD_TYP、TIME_ASPCT、STATUS或COMMON_TEST_RANK,所有结果均返回空字符串,并通过fields_unavailable/fields_unavailable_note说明。空SYSTEM/CLASS字段不表示“此代码无标本/类别”,而是该字段不在数据源中。可使用LONG_COMMON_NAME/COMPONENT/SHORTNAME(已填充)消歧。LOINC_search_forms仅返回整工具(如PHQ-9、GAD-7、MMSE、实验室面板),单个问题或单项检验不会出现;应使用LOINC_search_tests。LOINC_get_answer_list通过answer_lists_found计数和仅在计数为0时出现的note字段区分“代码匹配但无编码答案列表”(如REAL/ST自由值数据类型)与“代码未找到”。
- 蛋白质注释词汇:UniProt疾病与关键词
- UniProtRef_search_diseases:疾病名/症状/基因 -> UniProt疾病ID(DI-XXXXX)。输出id、name、cross_references[](OMIM/MeSH/MedGen/SNOMED)、reviewed_protein_count。
- UniProtRef_get_disease:一个DI-XXXXX ID -> 完整定义(definition、alternative_names[]、cross_references[]、reviewed_protein_count、unreviewed_protein_count)。
- UniProtRef_search_keywords:功能/生物过程术语 -> UniProt关键词ID(KW-XXXX)。输出id、name、category、reviewed_protein_count。
- UniProtRef_get_keyword:一个KW-XXXX ID -> (资料在此处截断,未提供完整输出字段)。 这些是UniProt用于注释蛋白质的受控词汇,非临床/EHR编码系统,用于将术语映射到UniProt疾病/关键词ID。
使用方式 调用时传入terms字符串(部分或全文),可选max_results。匹配为前缀/子串,不做超出索引的完整语义/同义词扩展,因此非常口语化或拼写错误的术语可能零命中,即使存在正式同义词;应先用更短或更标准的片段重试。NPIProvider_search的organization参数可切换组织搜索。ICD11_*工具需先注册并设置两个API密钥。
适用场景
- 在深入药物研究、药物相互作用、药物基因组学剂量解读、疾病研究之前,先将术语解析为标准名称/代码。
- 需要从免费文本获得ICD-10-CM/ICD-9-CM编码、RxCUI、NDC、HCPCS、LOINC、NCIt、UMLS CUI、NPI、UniProt ID等精确标识符时。
- 需要跨词汇映射(如NCIt到MedDRA/SNOMED/GDC/ICD)时。
- 需要LOINC检验的可允许值集合(如ABO血型答案列表)时。
限制
- 本技能职责止于“这是标准名称/代码”,不解释临床意义、剂量或计费资格。
- 深度药物机制/相互作用/监管研究应转至tooluniverse-drug-research、tooluniverse-drug-drug-interaction。
- 完整药物基因组学剂量解读(CPIC指南)应转至tooluniverse-pharmacogenomics;本技能仅查找等位基因定义(核苷酸/蛋白质变化)。
- 疾病生物学、机制或治疗研究应转至tooluniverse-disease-research。
- 提供者网络分析、资质认证或支付历史调查超出基本NPI查询;NPIProvider_search返回的NPI可作为CMSOpenPayments_search_payments的npi过滤条件,本技能仅解析提供者身份后移交。
- LOINC数据源缺失SYSTEM、CLASS等字段,不能将空值解读为无标本/类别。
- ICD11_*工具需API密钥,未设置时调用失败;虽然出现在工具列表中,但不代表无需设置即可使用。
- 匹配不做完整语义扩展,口语化或拼写错误术语可能零命中。