clinical-trials-search

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Clinical Trials Search

临床试验搜索

Search the complete ClinicalTrials.gov database of clinical studies using natural language queries powered by Valyu's semantic search API.

借助Valyu的语义搜索API，使用自然语言查询搜索ClinicalTrials.gov的完整临床研究数据库。

Why This Skill is Powerful

该工具的强大之处

No API Parameter Parsing: Just pass natural language queries directly - no need to construct complex search parameters
Semantic Search: Understands the meaning of your query, not just keyword matching
Full-Text Access: Returns complete trial information including phases, conditions, interventions, and outcomes
Image Links: Includes data visualizations when available
Comprehensive Coverage: Access to all ClinicalTrials.gov data

无需解析API参数：直接传入自然语言查询即可，无需构建复杂的搜索参数
语义搜索：理解查询的含义，而非仅进行关键词匹配
全文访问：返回完整的试验信息，包括试验阶段、病症、干预措施和试验结果
图片链接：如有可用数据可视化内容，会一并提供
全面覆盖：可访问ClinicalTrials.gov的全部数据

Requirements

环境要求

Node.js 18+ (uses built-in fetch)
Valyu API key from https://platform.valyu.ai ($10 free credits)

Node.js 18+（使用内置的fetch功能）
从https://platform.valyu.ai获取Valyu API密钥（赠送10美元免费额度）

CRITICAL: Script Path Resolution

重要提示：脚本路径解析

The

scripts/search

commands in this documentation are relative to this skill's installation directory.

Before running any command, locate the script using:

bash

CLINICAL_TRIALS_SCRIPT=$(find ~/.claude/plugins/cache -name "search" -path "*/clinical-trials-search/*/scripts/*" -type f 2>/dev/null | head -1)

Then use the full path for all commands:

bash

$CLINICAL_TRIALS_SCRIPT "CAR-T cell therapy trials" 15

本文档中的

scripts/search

命令是相对于该工具的安装目录的相对路径。

运行任何命令前，请先通过以下命令定位脚本：

bash

CLINICAL_TRIALS_SCRIPT=$(find ~/.claude/plugins/cache -name "search" -path "*/clinical-trials-search/*/scripts/*" -type f 2>/dev/null | head -1)

随后使用完整路径执行所有命令：

bash

$CLINICAL_TRIALS_SCRIPT "CAR-T细胞疗法试验" 15

API Key Setup Flow

API密钥设置流程

When you run a search and receive

"setup_required": true

, follow this flow:

Ask the user for their API key: "To search ClinicalTrials.gov, I need your Valyu API key. Get one free ($10 credits) at https://platform.valyu.ai"
Once the user provides the key, run:
bash
```
scripts/search setup <api-key>
```
Retry the original search.

当你运行搜索并收到

"setup_required": true

时，请遵循以下流程：

向用户索要API密钥： "要搜索ClinicalTrials.gov，我需要你的Valyu API密钥。可前往https://platform.valyu.ai免费获取（含10美元额度）"
用户提供密钥后，运行以下命令：
bash
```
scripts/search setup <api-key>
```
重新尝试执行原搜索。

When to Use This Skill

适用场景

Finding ongoing and completed clinical trials
Identifying trial eligibility criteria
Recruiting status and enrollment information
Comparing treatment approaches in trials
Patient recruitment and enrollment research
Outcomes and safety data from trials

查找进行中及已完成的临床试验
确认试验入选标准
招募状态和招募信息
对比试验中的治疗方案
患者招募与入组研究
试验结果与安全性数据

Output Format

输出格式

json

{
  "success": true,
  "type": "clinical_trials_search",
  "query": "CAR-T cell therapy trials",
  "result_count": 10,
  "results": [
    {
      "title": "Trial Title",
      "url": "https://clinicaltrials.gov/...",
      "content": "Trial details, phase, conditions, outcomes...",
      "source": "clinical-trials",
      "relevance_score": 0.95,
      "images": []
    }
  ],
  "cost": 0.025
}

json

{
  "success": true,
  "type": "clinical_trials_search",
  "query": "CAR-T cell therapy trials",
  "result_count": 10,
  "results": [
    {
      "title": "Trial Title",
      "url": "https://clinicaltrials.gov/...",
      "content": "Trial details, phase, conditions, outcomes...",
      "source": "clinical-trials",
      "relevance_score": 0.95,
      "images": []
    }
  ],
  "cost": 0.025
}

Processing Results

结果处理

With jq

使用jq工具

bash

undefined

bash

undefined

Get trial titles

获取试验标题

scripts/search "query" 10 | jq -r '.results[].title'

Get URLs

获取URL

scripts/search "query" 10 | jq -r '.results[].url'

Extract full content

提取完整内容

scripts/search "query" 10 | jq -r '.results[].content'

undefined

scripts/search "query" 10 | jq -r '.results[].content'

undefined

Common Use Cases

常见使用场景

Drug Development

药物研发

bash

undefined

bash

undefined

Find drug trials

查找药物试验

scripts/search "phase 2 trials for Alzheimer's disease" 50

undefined

scripts/search "阿尔茨海默病2期试验" 50

undefined

Treatment Research

治疗研究

bash

undefined

bash

undefined

Search for treatment studies

搜索治疗研究

scripts/search "checkpoint inhibitor combinations in lung cancer" 20

undefined

scripts/search "肺癌中的检查点抑制剂联合疗法" 20

undefined

Medical Device Studies

医疗设备研究

bash

undefined

bash

undefined

Find device trials

查找设备试验

scripts/search "continuous glucose monitoring device studies" 15

undefined

scripts/search "连续血糖监测设备研究" 15

undefined

Intervention Analysis

干预措施分析

bash

undefined

bash

undefined

Search for intervention studies

搜索干预研究

scripts/search "behavioral interventions for obesity" 25

undefined

scripts/search "肥胖症行为干预措施" 25

undefined

Error Handling

错误处理

All commands return JSON with

success

field:

json

{
  "success": false,
  "error": "Error message"
}

Exit codes:

```
0
```
- Success
```
1
```
- Error (check JSON for details)

所有命令返回的JSON均包含

success

字段：

json

{
  "success": false,
  "error": "Error message"
}

退出码：

```
0
```
- 成功
```
1
```
- 错误（查看JSON获取详细信息）

API Endpoint

API端点

Base URL:
```
https://api.valyu.ai/v1
```
Endpoint:
```
/search
```
Authentication: X-API-Key header

基础URL：
```
https://api.valyu.ai/v1
```
端点：
```
/search
```
认证方式：X-API-Key请求头

Architecture

架构

scripts/
├── search          # Bash wrapper
└── search.mjs      # Node.js CLI

Direct API calls using Node.js built-in

fetch()

, zero external dependencies.

scripts/
├── search          # Bash封装脚本
└── search.mjs      # Node.js命令行工具

使用Node.js内置的

fetch()

直接调用API，无外部依赖。

Adding to Your Project

集成到你的项目

If you're building an AI project and want to integrate Clinical Trials Search directly into your application, use the Valyu SDK:

如果你正在构建AI项目，并希望将临床试验搜索直接集成到应用中，请使用Valyu SDK：

Python Integration

Python集成

python

from valyu import Valyu

client = Valyu(api_key="your-api-key")

response = client.search(
    query="your search query here",
    included_sources=["valyu/valyu-clinical-trials"],
    max_results=20
)

for result in response["results"]:
    print(f"Title: {result['title']}")
    print(f"URL: {result['url']}")
    print(f"Content: {result['content'][:500]}...")

python

from valyu import Valyu

client = Valyu(api_key="your-api-key")

response = client.search(
    query="your search query here",
    included_sources=["valyu/valyu-clinical-trials"],
    max_results=20
)

for result in response["results"]:
    print(f"Title: {result['title']}")
    print(f"URL: {result['url']}")
    print(f"Content: {result['content'][:500]}...")

TypeScript Integration

TypeScript集成

typescript

import { Valyu } from "valyu-js";

const client = new Valyu("your-api-key");

const response = await client.search({
  query: "your search query here",
  includedSources: ["valyu/valyu-clinical-trials"],
  maxResults: 20
});

response.results.forEach((result) => {
  console.log(`Title: ${result.title}`);
  console.log(`URL: ${result.url}`);
  console.log(`Content: ${result.content.substring(0, 500)}...`);
});

See the Valyu docs for full integration examples and SDK reference.

typescript

import { Valyu } from "valyu-js";

const client = new Valyu("your-api-key");

const response = await client.search({
  query: "your search query here",
  includedSources: ["valyu/valyu-clinical-trials"],
  maxResults: 20
});

response.results.forEach((result) => {
  console.log(`Title: ${result.title}`);
  console.log(`URL: ${result.url}`);
  console.log(`Content: ${result.content.substring(0, 500)}...`);
});

查看Valyu文档获取完整的集成示例和SDK参考。