clinicaltrials-study-search
starsforks
How to install clinicaltrials-study-search?
ma-compbio-lab/skillfoundry/clinicaltrials-study-search
$npx -y skills add ma-compbio-lab/SkillFoundry --skill clinicaltrials-study-searchUse 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 | ## Purpose |
| 2 | Query the current ClinicalTrials.gov v2 API and save structured study metadata for a condition or free-text term. |
| 3 | |
| 4 | ## When to use |
| 5 | - You need official clinical study metadata. |
| 6 | - You want a lightweight search path for cohort or intervention discovery. |
| 7 | |
| 8 | ## When not to use |
| 9 | - You need patient-level data. |
| 10 | - You are working against deprecated ClinicalTrials.gov API examples. |
| 11 | |
| 12 | ## Inputs |
| 13 | - A condition query or a general term query |
| 14 | - Optional page size and output path |
| 15 | |
| 16 | ## Outputs |
| 17 | - JSON payload containing `studies` |
| 18 | |
| 19 | ## Requirements |
| 20 | - Python 3.13+ |
| 21 | - Network access to `clinicaltrials.gov` |
| 22 | |
| 23 | ## Procedure |
| 24 | 1. 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`. |
| 25 | 2. Inspect the first `protocolSection.identificationModule` block. |
| 26 | 3. Use the result list for follow-up triage or cohort narrowing. |
| 27 | |
| 28 | ## Validation |
| 29 | - Command exits successfully. |
| 30 | - Output contains `studies`. |
| 31 | - A common query returns at least one study. |
| 32 | |
| 33 | ## Failure modes and fixes |
| 34 | - 404 or legacy errors: use `api/v2` endpoints only. |
| 35 | - No results: switch between `--condition` and `--term`. |
| 36 | |
| 37 | ## Safety and limits |
| 38 | - Public study metadata only. |
| 39 | - This skill does not provide patient-level or operational medical guidance. |
| 40 | |
| 41 | ## Examples |
| 42 | - `python3 .../search_clinicaltrials.py --term melanoma --page-size 2` |
| 43 | |
| 44 | ## Provenance |
| 45 | - ClinicalTrials.gov API overview: https://clinicaltrials.gov/data-api/about-api |
| 46 | |
| 47 | ## Related skills |
| 48 | - `ncbi-pubmed-search` |
People who liked this also viewed
6 picksType
- azure-aiUse for Azure AI: Search, Speech, OpenAI, Document Intelligence. Helps with search, vector/hybrid search, speech-to-text, text-to-speech, transcription, OCR. WHEN: AI Search, query search, vector searSkillsJul 2026
- just-scrapeSearch, scrape, crawl, extract structured data, and monitor web pages via the ScrapeGraph AI CLI. Use when the user asks to search the web, scrape a webpage, grab content from a URL, extract JSON fromSkillsJul 2026
- firecrawlCLI and Agent Skill for Firecrawl - Add scrape, search, and browsing capabilities to your AI agentsSkillsJul 2026
- firecrawl-searchWeb search with full page content extraction. Use this skill whenever the user asks to search the web, find articles, research a topic, look something up, find recent news, discover sources, or says "SkillsJul 2026
- firecrawl-agentAI-powered autonomous data extraction that navigates complex sites and returns structured JSON. Use this skill when the user wants structured data from websites, needs to extract pricing tiers, producSkillsJul 2026
- firecrawl-mapDiscover and list all URLs on a website, with optional search filtering. Use this skill when the user wants to find a specific page on a large site, list all URLs, see the site structure, find where sSkillsJul 2026
