Clinicaltrials study search

Skill ma-compbio-lab/SkillFoundry/skills/clinical-biomedical-data-science/clinicaltrials-study-search

A framework for discovering, compiling, and validating reusable skills for scientific agents.

Install

npx -y skills add ma-compbio-lab/SkillFoundry --skill clinicaltrials-study-search

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

What its author says it does

Copied from the file, not written here

Use this skill to search the current ClinicalTrials.gov v2 API for condition or keyword matches when you need official clinical-study metadata. Do not use it for legacy API URLs or offline work.

SKILL.md

1.8 KB, as published. Nobody here has run it

Purpose

Query the current ClinicalTrials.gov v2 API and save structured study metadata for a condition or free-text term.

When to use

You need official clinical study metadata.
You want a lightweight search path for cohort or intervention discovery.

When not to use

You need patient-level data.
You are working against deprecated ClinicalTrials.gov API examples.

Inputs

A condition query or a general term query
Optional page size and output path

Outputs

JSON payload containing studies

Requirements

Python 3.13+
Network access to clinicaltrials.gov

Procedure

Run python3 skills/clinical-biomedical-data-science/clinicaltrials-study-search/scripts/search_clinicaltrials.py --condition melanoma --page-size 3 --out skills/clinical-biomedical-data-science/clinicaltrials-study-search/assets/melanoma_studies.json.
Inspect the first protocolSection.identificationModule block.
Use the result list for follow-up triage or cohort narrowing.

Validation

Command exits successfully.
Output contains studies.
A common query returns at least one study.

Failure modes and fixes

404 or legacy errors: use api/v2 endpoints only.
No results: switch between --condition and --term.

Safety and limits

Public study metadata only.
This skill does not provide patient-level or operational medical guidance.

Examples

python3 .../search_clinicaltrials.py --term melanoma --page-size 2

Provenance

ClinicalTrials.gov API overview: https://clinicaltrials.gov/data-api/about-api

Related skills

ncbi-pubmed-search