clinicaltrials-database

Query ClinicalTrials.gov API v2 for trials and export results to CSV or JSON.

94|11|Updated Mar 26, 2026
One-click install
npx skills add https://github.com/swaruplab/operon --skill clinicaltrials-database-swaruplab
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clinicaltrials-database
Source: https://github.com/swaruplab/operon/tree/main/src-tauri/protocols/clinicaltrials-database
Command: npx skills add https://github.com/swaruplab/operon --skill clinicaltrials-database-swaruplab

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Automates the discovery and retrieval of clinical trial information from ClinicalTrials.gov API v2, enabling researchers to locate trials quickly, analyze results, and export data for reporting and patient matching.

Core Features & Use Cases

  • Search by condition, drug, location, status, or phase to build targeted trial lists.
  • Retrieve detailed study information by NCT ID for in-depth review and eligibility assessments.
  • Export data to CSV or JSON for integration into analyses, dashboards, or patient matching.
  • Use Case: A clinician can search for recruiting breast cancer trials in New York and export the results to CSV for patient referrals.

Quick Start

Run a basic search for a condition (e.g., "lung cancer") and retrieve the first page of results and export them.

Frequently Asked Questions about clinicaltrials-database

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

FAQPage Schema
How do I query ClinicalTrials.gov data programmatically using Python?

You query ClinicalTrials.gov data programmatically using Python helper scripts that interact with the ClinicalTrials.gov API v2. This allows you to search for trials by condition, drug, location, status, or phase and retrieve results in JSON or CSV formats.

Can I search for recruiting clinical trials by condition and location?

Yes, you can search for recruiting clinical trials by specific condition and location. The Skill supports filtering across conditions, locations, statuses, and phases to build targeted trial lists for research or patient matching.

How do I retrieve detailed clinical trial information using an NCT ID?

To retrieve detailed clinical trial information, you provide a study's NCT ID to the Python scripts. The Skill queries the ClinicalTrials.gov API v2 and fetches in-depth study data for eligibility assessments and reviews.

Does this Skill handle ClinicalTrials.gov API rate limits and pagination?

Yes, the Skill handles ClinicalTrials.gov API v2 rate limits and pagination. This ensures you can retrieve large datasets across multiple pages without exceeding API request thresholds.

What is the best way to export clinical trial search results to CSV?

The best way to export clinical trial search results to CSV is by using the Skill's built-in Python helper scripts. After querying the ClinicalTrials.gov API v2, you can format and export the data directly to CSV or JSON for analysis.

Do I need the requests library to extract data from ClinicalTrials.gov?

Yes, you need the Python requests library installed as a dependency to extract data from ClinicalTrials.gov. The Skill's scripts rely on it to make HTTP requests to the API v2 base URL.