qsong-github/drugclaw/nsides

nSIDES Query Skill

Search drug adverse reactions across three complementary nSIDES sources by drug name.

Entity Detection

No ID-based routing — all queries are natural-language drug names.

API

Output Fields

OnSIDES row

• ingredient — RxNorm ingredient name
• effect — MedDRA adverse effect term
• meddra_id — MedDRA concept ID
• source — label origin country (US / EU / UK / JP)
• label_count — number of labels reporting this ADE

OffSIDES row

• drug — RxNorm drug name
• condition — MedDRA side effect name
• PRR — proportional reporting ratio (>1 = signal)
• A/B/C/D — 2×2 contingency counts
• mean_reporting_frequency — proportion of drug reports with this effect

KidSIDES row

• drug — drug concept name
• event — adverse event name
• nichd_phase — NICHD developmental phase (e.g. "Neonatal", "Infancy", "Adolescence")
• gam_score — GAM model score
• ror / ror_lower / ror_upper — reporting odds ratio with 95% CI

Usage

See if __name__ == "__main__" block in 15_nSIDES.py for runnable examples: single-drug query, batch query, text summary, and JSON output.

Data

DATA_DIR default: resources_metadata/adr/nSIDES

Citations

• OnSIDES: Tanaka Y et al. OnSIDES database: Extracting adverse drug events from drug labels using NLP models. Med. 2025;100642. doi:10.1016/j.medj.2025.100642
• OffSIDES / TwoSIDES: Tatonetti NP et al. Data-driven prediction of drug effects and interactions. Sci Transl Med. 2012;4(125):125ra31. doi:10.1126/scitranslmed.3003377
• KidSIDES: Giangreco NP, Tatonetti NP. A database of pediatric drug effects to evaluate ontogenic mechanisms. Med. 2022.