| name | faers-query |
| description | Query the FDA Adverse Event Reporting System (FAERS) via openFDA API. Use whenever the user asks about adverse drug reactions, side effects, drug safety signals, or wants to look up reported adverse events for one or more drug names.
|
FAERS Query Skill
Query adverse event reports from FDA's FAERS database. No API key required.
API
| Function | Input | Returns |
|---|
get_metadata() | — | {total, last_updated} |
count_reactions(drug, top_n) | single drug name | [{term, count}, ...] |
count_reactions_batch(drugs, top_n) | list of drug names | {drug: [{term, count}, ...]} |
search_adverse_events(drug, limit) | single drug name | raw openFDA response dict |
summarize_reactions(reactions, drug) | reaction list + label | compact one-line text |
Usage
See if __name__ == "__main__" block in faers_query.py for runnable examples covering: single drug query, batch query, metadata retrieval, raw report inspection, and LLM-friendly summary output.
Notes
- Drug names should be uppercase (auto-converted internally).
- Input accepts a single string or a list of strings for batch queries.
summarize_reactions produces compact DRUG: reaction(count), ... format suitable for LLM context.- Source: openFDA Drug Adverse Events endpoint (
https://api.fda.gov/drug/event.json).
