ClinicalTrials 临床试验检索

要解决什么问题

做患者匹配、药物管线跟踪或研究趋势分析时，你往往需要在 ClinicalTrials.gov 里按疾病、干预措施、地点或申办方筛试验，再读入组标准、状态和联系信息。手工在网页上翻页既慢，也不利于批量导出和后续脚本分析。

技能如何工作

本技能围绕 API v2（https://clinicaltrials.gov/api/v2）组织查询与解析，公开接口、无需认证，默认 JSON，也可选 CSV。

常见参数与能力包括：

• query.cond：按疾病/条件检索（如正在招募的糖尿病试验）
• query.intr：按干预/药物检索（如特定药物的 3 期研究）
• query.locn / query.spons：按地理位置或申办机构筛选
• filter.overallStatus：按 RECRUITING、COMPLETED 等状态过滤
• 用 NCT ID 拉取单条试验的完整 protocolSection（资格标准、地点、干预等嵌套字段）
• 分页：单次最多 1000 条，可自动翻页做批量拉取
• 辅助脚本 scripts/query_clinicaltrials.py 封装 search_studies()、get_study_details()、search_with_all_results()、extract_study_summary() 等模式

响应是深层 JSON，常用路径例如：study['protocolSection']['identificationModule']['nctId']、状态在 statusModule.overallStatus，资格在 eligibilityModule。

适用边界与注意点

• 速率限制约 每分钟 50 次请求/IP；大批量采集应加大 pageSize、在 429 时做指数退避，必要时在请求间加延迟。
• 并非每条试验字段都完整，读取前应判断键是否存在；富文本字段为 CommonMark 格式。
• CSV 返回的是字符串而非 JSON 对象，和默认 JSON 解析流程不同。不熟悉参数或排错时可对照 references/api_reference.md。