med-info

# med-info

**Medication answers you can cite.**

`med-info` turns a drug name (or RxCUI, NDC, SPL set_id) into a **label-backed** summary with **traceable identifiers** and **source links**.

Use it when you want “show your work” medication information for notes, training, QA, internal docs, or agent workflows.

Not medical advice.

## What you get

- **Authoritative sources first**: FDA labeling via openFDA + DailyMed, identifiers via RxNorm/RxClass.
- **Citations + traceability**: RxCUI, NDC (product/package), SPL set_id, effective dates, and URLs.
- **The sections you actually need**: boxed warning, indications, dosing, contraindications, warnings, interactions, adverse reactions.
- **Optional safety context** (opt-in flags): recalls, shortages, FAERS aggregates, interactions, drug class, hazardous drug flag, REMS linkouts, Orange Book, Purple Book.
- **Automation friendly**: `--json` output for pipelines.

## Privacy

Do not include PHI. Query by drug name or identifiers only.

## Quickstart

```bash
cd {baseDir}
python3 scripts/med_info.py "Eliquis" --brief
```

Common workflows:

```bash
# Only the sections you care about
python3 scripts/med_info.py "Eliquis" --sections contraindications,drug_interactions --brief

# Find keyword hits in label text (fast way to answer "does the label mention X?")
python3 scripts/med_info.py "Eliquis" --find ritonavir --find CYP3A4 --find P-gp --find-max 8

# Deterministic lookups by identifier (best for reproducibility)
python3 scripts/med_info.py "70518-4370-0"   # NDC (package)
python3 scripts/med_info.py "70518-4370"     # NDC (product)
python3 scripts/med_info.py "05999192-ebc6-4198-bd1e-f46abbfb4f8a"  # SPL set_id
```

## Disambiguation (when there are multiple labels)

```bash
python3 scripts/med_info.py "metformin" --candidates
python3 scripts/med_info.py "metformin" --candidates --pick 2 --brief
python3 scripts/med_info.py "metformin" --set-id "05999192-ebc6-4198-bd1e-f46abbfb4f8a"
```

## Optional add-ons

```bash
# P...