skills.rest
google-deepmind
google-deepmindOFFICIAL
Explore all skills by this author →
WebsiteGitHub

clinical-trials-database

Query ClinicalTrials.gov API v2 for structured trial data by condition, intervention, phase, and status.

2.7k|283|Updated May 13, 2026
Search Tags:#clinical trials#patient matching#eligibility criteria#clinicaltrials.gov#api search#nct id#recruiting status
One-click install
npx skills add https://github.com/google-deepmind/science-skills --skill clinical-trials-database
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: clinical-trials-database
Source: https://github.com/google-deepmind/science-skills/tree/main/skills/clinical_trials_database
Command: npx skills add https://github.com/google-deepmind/science-skills --skill clinical-trials-database

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Searching ClinicalTrials.gov manually is slow and error-prone when you need specific trials by condition, intervention, phase, status, or location, plus eligibility details for patient matching.

Core Features & Use Cases

  • Condition/intervention/phase/status search: Query ClinicalTrials.gov API v2 using the provided CLI wrapper to quickly identify relevant studies and trial landscapes.
  • NCT-ID deep retrieval: Fetch full trial details or a targeted set of fields by NCT identifier without crafting raw queries.
  • Eligibility extraction for matching: Pull inclusion/exclusion criteria and age/sex requirements to support clinical and recruiting workflows.
  • Efficiency guardrails: Use --fields, --count-total, and pagination to control large JSON responses and avoid unnecessary data transfer.

Quick Start

Use the clinical-trials-database skill to search for recruiting Phase 3 pediatric cystic fibrosis trials by running: uv run scripts/clinical_trials_api.py search --condition "cystic fibrosis" --status RECRUITING --phase PHASE3 --age-group CHILD --fields "NCTId,BriefTitle,OverallStatus,Phase" --limit 10 --output /tmp/cf_trials.json

Frequently Asked Questions about clinical-trials-database

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search ClinicalTrials.gov by condition and recruiting status?▼

You can search ClinicalTrials.gov by condition and recruiting status using the provided CLI wrapper to query the API v2. It filters by phase, age group, and location, returning specified fields like NCT ID and Brief Title in a JSON file.

How do I extract eligibility criteria for patient matching using an NCT ID?▼

Extract eligibility criteria for patient matching by performing an NCT-ID deep retrieval using the CLI wrapper. This fetches inclusion and exclusion requirements directly from ClinicalTrials.gov to support clinical and recruiting workflows.

What is the best way to control large JSON payloads when querying clinical trials?▼

Control large JSON payloads from clinical trials searches by using mandatory `--fields` to select targeted data and `--count-total` for landscape exploration. The CLI wrapper enforces these guardrails to avoid unnecessary data transfer during paginated retrieval.

Can I pull pediatric trial data for specific phases like Phase 3?▼

Yes, you can query pediatric Phase 3 trials by combining the `--age-group CHILD` and `--phase PHASE3` arguments in the CLI wrapper. This filters the ClinicalTrials.gov API results to match specific patient demographics and trial phases.

Do I need to craft raw API queries to get full trial details by NCT ID?▼

No, you do not need to craft raw API queries to get full trial details by NCT ID. The Skill provides NCT-ID deep retrieval via the CLI wrapper, allowing you to fetch targeted fields or full trial details directly without manual query construction.

Related Skills

Explore More Education & Research Skills→
birgitta410birgitta410
15

_local-setup

Automate local installation and configuration of the sensors-cli development environment.

Community
Basic
maziyarpanahimaziyarpanahi
5.0k

parsing-trial-eligibility

Convert free-text clinical-trial eligibility criteria into structured inclusion and exclusion rules.

Community
Advanced
robinbarvaagrobinbarvaag

clinicaltrials-database

Query ClinicalTrials.gov API v2 to search and retrieve clinical trial data.

Community
Intermediate
OwnLabAIOwnLabAI
21

clinicaltrials-database

Query ClinicalTrials.gov API v2 to search and export trial data.

Official
Advanced