SuperAPI AI 工具集

clinicaltrials-database

数据与分析

查看项目

更新于 10-16 05:01

技能介绍

用途:该技能用于访问 ClinicalTrials.gov 临床试验注册库的 API v2,检索全球临床研究信息,适合患者匹配、研究分析、药物与干预研究、地理检索、申办方追踪、数据导出、试验监测和入组资格筛选等场景。

主要能力:可按条件/疾病(query.cond)、干预/药物(query.intr)、地点(query.locn)、申办方(query.spons)搜索;可按整体状态过滤(如 RECRUITING、COMPLETED、TERMINATED 等);可用 NCT ID 获取单条试验详情,包括入组标准、年龄性别要求、联系方式与试验地点;支持分页批量获取和导出 CSV;辅助脚本提供 search_studies()、get_study_details()、search_with_all_results()、extract_study_summary() 等函数。

使用方式:可直接运行脚本,例如 cd scientific-databases/clinicaltrials-database/scripts 后执行 python3 query_clinicaltrials.py;也可用 Python requests 调用基础地址 https://clinicaltrials.gov/api/v2/studies,按需传入查询参数。获取详情时请求 https://clinicaltrials.gov/api/v2/studies/{nct_id}。返回数据为嵌套结构,常见路径如 study['protocolSection']['identificationModule']['briefTitle']。

限制:API 公开无需认证,但限速约每分钟 50 次请求,批量抓取需加大 pageSize(最大 1000)、实现指数退避并添加延迟;并非所有试验字段完整,需用 .get() 安全访问;CSV 格式返回字符串而非 JSON 字典;日期为 ISO 8601,富文本字段为 CommonMark Markdown;错误处理建议捕获 HTTPError、RequestException 和 JSON 解析异常。具体收费、价格与平台可用性暂未提供。