clinical-trials-database

1# Clinical Trials Database
2 
3## Prerequisites
4 
51.  **`uv`**: Read the `uv` skill and follow its Setup instructions to ensure
6    `uv` is installed and on PATH.
72.  **User Notification**: If .licenses/clinical_trials_database_LICENSE.txt
8    does not already exist in the workspace root directory then (1) prominently
9    notify the user to check the terms at https://clinicaltrials.gov/, then (2)
10    create the file recording the notification text and timestamp.
11 
12## Overview
13 
14Access worldwide clinical trial data from ClinicalTrials.gov via the REST API
15v2. The CLI script at `scripts/clinical_trials_api.py` wraps the API with
16dedicated flags for common filters (phase, age group, status, intervention,
17sponsor, etc.) so you rarely need to construct raw queries.
18 
19## Core Rules
20 
21-   **Use the Wrapper**: ALWAYS execute the provided helper scripts to query the
22    database rather than accessing the database directly. The scripts
23    automatically enforce the required rate limit gracefully.
24-   **Always use `--fields`** — trial JSON records can be very large; restrict
25    to the data points you need.
26-   **Use `--count-total` first** — check result volume before fetching all
27    records.
28-   **Paginate large result sets** — use `--limit` with `--page-token` to
29    iterate.
30-   **Trust Search Filters**: Do not manually re-filter results unless
31    explicitly asked to verify detailed eligibility.
32-   **Notification**: If this skill is used, ensure this is mentioned in the
33    output.
34…