diegosouzapw 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:
--jsonoutput for pipelines.
Privacy
Do not include PHI. Query by drug name or identifiers only.
Quickstart
cd {baseDir}
python3 scripts/med_info.py "Eliquis" --brief
Common workflows:
# 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)
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
# Pharmacist-friendly output bundle
python3 scripts/med_info.py "Eliquis" --pharmacist --brief
# Safety signals and operational context (opt-in)
python3 scripts/med_info.py "metformin" --recalls --brief
python3 scripts/med_info.py "amphetamine" --shortages --brief
python3 scripts/med_info.py "Eliquis" --faers --faers-max 10
python3 scripts/med_info.py "Eliquis" --interactions --interactions-max 20
python3 scripts/med_info.py "Eliquis" --rxclass
python3 scripts/med_info.py "cyclophosphamide" --hazardous
python3 scripts/med_info.py "isotretinoin" --rems
# Reference datasets
python3 scripts/med_info.py "adalimumab" --purplebook
python3 scripts/med_info.py "metformin" --orangebook
# Chemistry (best-effort)
python3 scripts/med_info.py "ibuprofen" --chem
Output shaping
python3 scripts/med_info.py "ibuprofen" --json
python3 scripts/med_info.py "Eliquis" --brief --sections all
python3 scripts/med_info.py "Eliquis" --print-url --brief # prints queried URLs (api_key redacted)
Sources (high level)
- openFDA: drug labels, NDC directory, recalls/enforcement, shortages, FAERS
- RxNorm / RxClass (RxNav): normalization and drug classes
- DailyMed: SPL label history and media
- MedlinePlus Connect: patient-friendly summaries (links)
- Orange Book and Purple Book: best-effort context
Safety notes
- For clinical decisions, verify against the full official label.
- Input is treated as untrusted, openFDA
searchstrings are escaped to prevent query injection.
Keys and rate limits
Works without any keys. Optionally:
OPENFDA_API_KEY: increases openFDA rate limits for heavy usage.