临床试验检索

检索 ClinicalTrials.gov 登记的临床研究，返回 NCT 编号、标题、状态、分期、适应症、申办方、起止日期和登记链接，可按招募状态筛选。

接口	POST /v1/clinical-trial-searches
所需权限	clinical_trial:search
MCP 工具	clinical_trial
计量单位	studies

计量单位出现在 execution.usage.units 中，用于对账和计费。

请求字段

字段	类型	必填	说明
invocation_id	string	是	调用方（市场）生成的调用 ID：同一个 ID 在同一操作上只执行一次，用同一 ID 重试会被拒绝而不会重复计费。1–128 个字符，可用 A-Z a-z 0-9 . _ : -。
provider	string	是	处理本次请求的数据源，按下方数据源表的覆盖范围选择。 可选值：clinicaltrials-gov
query	string	是	检索关键词，1–300 个字符。
max_results	integer	否	返回的研究数量，1–20，默认 10。
statuses	string[]	否	可选，只保留这些总体状态：RECRUITING、NOT_YET_RECRUITING、ACTIVE_NOT_RECRUITING、ENROLLING_BY_INVITATION、COMPLETED、SUSPENDED、TERMINATED、WITHDRAWN 等。

数据源

数据源	区域	说明	限制
clinicaltrials-gov	US	ClinicalTrials.gov（美国国家医学图书馆）	max_results: 20, timeout_seconds: 30

示例

curl

curl -sS https://services.zgi.im/v1/clinical-trial-searches \
  -H "Authorization: Bearer $ZGI_SERVICES_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"invocation_id": "docs-1791778521-clinical_trial", "provider": "clinicaltrials-gov", "query": "type 2 diabetes", "max_results": 2}'

HTTP

POST /v1/clinical-trial-searches HTTP/1.1
Host: services.zgi.im
Authorization: Bearer <token>
Content-Type: application/json

{
  "invocation_id": "docs-1791778521-clinical_trial",
  "provider": "clinicaltrials-gov",
  "query": "type 2 diabetes",
  "max_results": 2
}

MCP

通过 MCP 调用时，工具参数与 HTTP 请求体完全相同。

request.json

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "clinical_trial",
    "arguments": {
      "invocation_id": "docs-1791778521-clinical_trial",
      "provider": "clinicaltrials-gov",
      "query": "type 2 diabetes",
      "max_results": 2
    }
  }
}

curl -sS https://services.zgi.im/v1/mcp \
  -H "Authorization: Bearer $ZGI_SERVICES_TOKEN" \
  -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' \
  -H 'MCP-Protocol-Version: 2025-11-25' \
  -d @request.json

返回

以下为一次真实调用的返回，列表只保留前两项，长文本已截断。

{
  "code": 0,
  "message": "success",
  "data": {
    "execution": {
      "id": "exe_01a12e528f2b74a2adb92c7322e4490b",
      "invocation_id": "docs-1791778521-clinical_trial",
      "capability": "clinical_trial",
      "operation": "clinical_trial.search",
      "provider": "clinicaltrials-gov",
      "outcome": "succeeded",
      "error_category": null,
      "error_code": null,
      "usage": {
        "provider_requests": 1,
        "units": [
          {
            "name": "studies",
            "value": 2,
            "source": "measured"
          }
        ]
      },
      "upstream_ref": null,
      "request_id": "req_812a185d16c7889bb5819858",
      "started_at": "2026-10-12T04:15:24.971301559Z",
      "finished_at": "2026-10-12T04:15:25.257899629Z",
      "duration_ms": 286
    },
    "result": {
      "studies": [
        {
          "nct_id": "NCT03162237",
          "title": "Safety and Efficacy Study of Islets Xenotransplantation",
          "status": "COMPLETED",
          "phases": [
            "NA"
          ],
          "conditions": [
            "Type 1 Diabetes"
          ],
          "sponsor": "Wei Wang,MD",
          "start_date": "2013-07",
          "completion_date": "2018-12",
          "url": "https://clinicaltrials.gov/study/NCT03162237"
        },
        {
          "nct_id": "NCT01121172",
          "title": "Apelin Levels and G212A Polymorphism of Apelin Receptor (APJ)",
          "status": "COMPLETED",
          "phases": [],
          "conditions": [
            "Obesity",
            "Insulin Resistance"
          ],
          "sponsor": "Aristotle University Of Thessaloniki",
          "start_date": "2010-05",
          "completion_date": "2014-01",
          "url": "https://clinicaltrials.gov/study/NCT01121172"
        }
      ],
      "source": {
        "name": "ClinicalTrials.gov (US National Library of Medicine)",
        "license": "US Government database; retrieved live and reduced to selected fields by ZGI Services",
        "url": "https://clinicaltrials.gov"
      }
    }
  }
}