ADReCS-query

Query the ADReCS (Adverse Drug Reaction Classification System) v3.3 database. Use whenever the user asks about adverse drug reactions, drug safety profiles, ADR classification, ADR severity/frequency,

SKILL.md

GitHub

ADReCS Query Skill

Search ADReCS v3.3 records by any entity. Auto-detects type by prefix:

Input Pattern Detected As Example
BADD_D00142 BADD Drug ID exact on drug_id column
DB00945 DrugBank ID resolved via Drug_information
A02BC01 ATC code resolved via Drug_information
50-78-2 CAS RN resolved via Drug_information
CID2244 or bare digits PubChem CID resolved via Drug_information
D00109 (5-digit) KEGG ID resolved via Drug_information
08.06.02.001 ADReCS ID substring on ADReCS_ID column
10003781 (8-digit) MedDRA code resolved via ADR_ontology
D###### (6+ digit) MeSH ID resolved via ADR_ontology
anything else free text substring on drug_name OR ADR_term

API

Function Input Returns
load_drug_adr(path) txt path DataFrame (Drug–ADR pairs)
load_drug_info(path) xlsx path DataFrame (drug metadata)
load_adr_ontology(path) xlsx path DataFrame (ADR hierarchy)
search(entity) single entity string DataFrame of matching Drug–ADR rows
search_batch(entities) list of entity strings dict[str, DataFrame]
summarize(hits, entity) DataFrame + label compact LLM-readable text
to_json(hits) DataFrame list[dict]

Usage

See if __name__ == "__main__" block in 62_ADReCS.py for runnable examples covering: drug name lookup, BADD Drug ID, DrugBank ID, ADR term, ADReCS ID prefix, batch search, and JSON output.

Data

  • Source: ADReCS v3.3 — https://www.bio-add.org/ADReCS/
  • Primary file: Drug_ADR_v3.3.txt (drug–ADR association pairs)
  • Drug metadata: Drug_information_v3.3.xlsx (name, synonyms, DrugBank/KEGG/PubChem/ATC/CAS cross-refs)
  • ADR hierarchy: ADR_ontology_v3.3.xlsx (ADReCS ID, ADR term, MedDRA code, MeSH ID, 4-level classification)
  • Path: DATA_DIR variable in 62_ADReCS.py

Citation

Cai MC et al. (2015) ADReCS: an ontology database for aiding standardization and hierarchical classification of adverse drug reaction terms. Nucleic Acids Research 43(D1):D907–D913.