用途:通过 NCBI E-utilities REST API 访问 NCBI Gene 数据库,检索基因中心信息,包括官方符号、别名、全名、功能摘要、基因组坐标(GRCh38/GRCh37)、RefSeq 编号、GO 注释、互作伙伴及外部数据库链接。适用于将基因别名解析为当前官方符号、获取 NCBI Gene ID 供下游 API(如 dbSNP、ClinVar、GEO)使用、程序化获取基因摘要、提取 RefSeq mRNA(NM_)与蛋白(NP_)编号、查询 GO 功能注释,以及通过 NCBI Datasets v2 端点查找跨物种直系同源基因。
主要能力:ESearch 按符号、名称或功能关键词检索;ESummary 批量获取元数据;EFetch 获取完整 XML 记录(含 RefSeq、GO、互作);支持 [sym]、[orgn]、alive[prop] 等字段标签过滤。
使用方式:需 Python 的 requests、xml.etree.ElementTree(标准库),pandas 可选;安装命令 pip install requests pandas。需联网并设置 email 参数。基础地址为 https://eutils.ncbi.nlm.nih.gov/entrez/eutils。未认证限速 3 请求/秒,使用免费 NCBI API key 可提升至 10 请求/秒。
限制:直系同源需改用 NCBI Datasets v2 的 /gene/id/{gene_id}/orthologs,旧 E-utilities gene_gene_homolog 已于 2019 年随 HomoloGene 退役;符号查询应加 alive[prop] 排除已停用记录;ESummary 每次 POST 最多 200 个 Gene ID;XML 解析异常需容错处理。表达谱请用 geo-database,变异注释请用 clinvar-database 或 ensembl-database。