openfda-database

1# openFDA Search and Query
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/openfda_database_LICENSE.txt does not
8    already exist in the workspace root directory then (1) prominently notify
9    the user to check the terms at https://open.fda.gov/apis/ and
10    https://open.fda.gov/license, then (2) create the file recording the
11    notification text and timestamp.
123.  **`.env` file**: Make sure the `.env` file exists in your home directory.
13    Create one if it does not exist.
144.  **`FDA_API_KEY`** (optional but recommended): Raises the daily request limit
15    from 1,000 to 120,000. The skill works without it, but an agent can easily
16    exhaust the keyless limit in a single session. You can register for a free
17    key at https://open.fda.gov/apis/authentication/. You **MUST** use the safe
18    credentials protocol in the `credentials` skill to check for and request
19    this key if this skill looks relevant to the user's request.
20 
21## Core Rules
22 
23-   **Use the Wrapper**: ALWAYS execute the provided helper scripts to query the
24    database rather than accessing the database directly. The scripts
25    automatically enforce the required rate limit gracefully.
26 
27-   **Rate Limiting**: Respect openFDA rate limits. Without API key: 240
28    requests/min, 1,000 requests/day per IP. With API key: 240 requests/min,
29…