searching-clinicaltrials

Find ClinicalTrials.gov studies by condition, intervention, and recruitment status.

5.0k|615|Updated Oct 4, 2025
One-click install
npx skills add https://github.com/maziyarpanahi/openmed --skill searching-clinicaltrials
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: searching-clinicaltrials
Source: https://github.com/maziyarpanahi/openmed/tree/main/skills/searching-clinicaltrials
Command: npx skills add https://github.com/maziyarpanahi/openmed --skill searching-clinicaltrials

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps users find relevant clinical studies without manually searching ClinicalTrials.gov or managing complex API pagination.

Core Features & Use Cases

  • Condition and Intervention Search: Find studies by disease, diagnosis, drug, or other intervention.
  • Recruitment Filtering: Narrow results to recruiting, not-yet-recruiting, or other supported study statuses.
  • Structured Trial Retrieval: Collect study identifiers, titles, conditions, interventions, eligibility criteria, and locations for research or trial-matching workflows.
  • OpenMed Integration: Convert biomedical entities extracted from clinical text into ClinicalTrials.gov search filters while keeping patient notes local.
  • Use Case: Search for recruiting breast cancer studies involving trastuzumab, then pass the returned eligibility criteria to downstream eligibility parsing.

Quick Start

Ask the skill to find recruiting ClinicalTrials.gov studies for a specified condition and optional intervention, returning the study identifiers, titles, statuses, and eligibility criteria.

Frequently Asked Questions about searching-clinicaltrials

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

FAQPage Schema
How do I find recruiting clinical trials for a specific condition and intervention?

You can find recruiting clinical trials by specifying a medical condition and an optional intervention. The skill filters recruiting studies on ClinicalTrials.gov, returning study identifiers, titles, statuses, and eligibility criteria in structured JSON.

Do I need an API key to search ClinicalTrials.gov?

No, you do not need an API key to search ClinicalTrials.gov. This functionality uses the public ClinicalTrials.gov API v2, handling query filters and cursor-based pageToken pagination natively without authentication.

How does cursor-based pagination work for clinical trial searches?

Cursor-based pageToken pagination retrieves large volumes of clinical trial search results sequentially. It uses a token from the previous response to fetch the next page of structured JSON data, preventing API timeouts and ensuring complete study corpus generation.

Can I retrieve eligibility criteria from ClinicalTrials.gov for trial matching?

Yes, you can retrieve eligibility criteria for trial matching. The skill extracts structured trial data including study identifiers, conditions, interventions, and locations, which can be passed to downstream eligibility parsing workflows.

What is the best way to search biomedical studies without manually managing API pagination?

The best way to search biomedical studies without manual pagination is using an automated query filter system. It handles ClinicalTrials.gov API v2 cursor-based pageToken pagination internally, delivering structured JSON responses with study titles and recruitment statuses.

Can I convert biomedical entities from clinical text into ClinicalTrials.gov search filters?

Yes, biomedical entities extracted from clinical text can be converted into ClinicalTrials.gov search filters. This OpenMed integration keeps patient notes local while generating structured trial retrieval queries for biomedical research.