用途：查询美国国家医学图书馆维护的 ClinicalTrials.gov 临床试验注册库，通过公开 API v2 检索试验并按 NCT ID 获取详情，用于患者匹配、研究分析、药物与干预研究、地域检索、申办方追踪、数据导出、试验监测和入组条件筛查。不适用于已发表文献（用 alterlab-pubmed）、FDA 审批与不良事件（alterlab-fda）、试验报告撰写（alterlab-clinical-reports）、循证治疗推荐（alterlab-clinical-decision）。
主要能力：按疾病（query.cond）、干预/药物（query.intr）、地点（query.locn）、申办方（query.spons）检索；按整体状态（filter.overallStatus）过滤；按 NCT ID 获取完整记录；分页与批量导出；CSV 导出。状态值包括 RECRUITING、NOT_YET_RECRUITING、ENROLLING_BY_INVITATION、ACTIVE_NOT_RECRUITING、SUSPENDED、TERMINATED、COMPLETED、WITHDRAWN 等。
使用方式：基础地址 https://clinicaltrials.gov/api/v2/studies，无需认证。可用脚本 python3 scripts/query_clinicaltrials.py，或直接调用 search_studies()、get_study_details()、search_with_all_results()、extract_study_summary()。示例参数含 query.cond、filter.overallStatus、pageSize、countTotal；分页游标返回为 nextPageToken，需作为 pageToken 传回；获取某试验用 https://clinicaltrials.gov/api/v2/studies/{nct_id}。响应为嵌套结构，如 study['protocolSection']['identificationModule']['nctId']、['statusModule']['overallStatus']、['designModule']['phases']、['eligibilityModule']、['contactsLocationsModule']['locations']。
限制：速率约每分钟 50 次请求，超限返回 429；单页最多 1000 条；没有 filter.phase 参数，传该参数会返回 400，可按 aggFilters=phase:N（N 为 0–4，同组值以空格分隔）或 filter.advanced=AREAPhase 过滤，也可在获取完整记录后按 designModule.phases 后过滤；API 仅在 countTotal=true 时返回 totalCount；部分试验字段缺失，访问前需检查存在性；将 400 视为查询错误而非“无试验”。