mfds-cli — Korea Ministry of Food and Drug Safety (식품의약품안전처) CLI

Wraps four high-value MFDS Open APIs published on data.go.kr: drug master, e약은요 (consumer drug leaflet), DUR contraindications, and drug recalls / sale-stop notices. Every endpoint returns XML or JSON; this skill normalizes everything to JSONL so AI agents can pipe it straight into a vector store, a notebook, or another tool.

Why this matters: Korean drug data is the highest-traffic public-data category on data.go.kr after real estate. Pharmacy chatbots, medication-safety agents, and clinical-decision tools need a single, clean interface — not four separate XML wrappers. This is the only ClawHub skill covering MFDS at the time of publish.

Quick start

export MFDS_API_KEY="<your-decoded-serviceKey>"   # from data.go.kr (free, instant approval)

# Search the drug master by Korean or English name
bin/mfds-cli drug --name "타이레놀" --rows 5

# Consumer-friendly drug leaflet (efficacy, dosage, side effects, storage)
bin/mfds-cli drug-easy --name "게보린" --rows 3

# Drug-drug interaction (병용금기) lookup
bin/mfds-cli dur --type interaction --name "와파린"

# Drugs recalled or sales-suspended this year
bin/mfds-cli recall --year 2026 --rows 50

Subcommands

Common flags

• --key <KEY> — override $MFDS_API_KEY
• --rows N — page size (default 30, max 100)
• --page N — 1-indexed page (default 1)
• --format jsonl|json|xml — output (default jsonl)
• --raw — pass through API response without normalization (for debugging)
• --endpoint <full-url> — escape hatch when MFDS rotates a service version

drug — drug master

drug-easy — consumer leaflet (e약은요)

dur — DUR contraindication lookup

The DUR API publishes 8 distinct lists. Use --type to pick:

Filters: --name "<품목명>", --ingredient "<주성분명>", --type-name "<DUR유형명>".

recall — recall / sales-stop / disposal

Output schema (JSONL)

Each record is one line. The CLI normalizes MFDS XML/JSON into a stable shape; _raw retains the original API field names for fields the normalizer doesn't yet cover.

{
  "type": "drug",
  "item_seq": "200005221",
  "item_name_ko": "타이레놀정500밀리그람(아세트아미노펜)",
  "item_name_en": "Tylenol Tab. 500mg (Acetaminophen)",
  "maker": "한국얀센(주)",
  "permit_no": "200500001",
  "permit_date": "20051018",
  "form_code": "정제",
  "main_ingredient": "아세트아미노펜 500mg",
  "atc_code": "N02BE01",
  "kpic_code": "643301250",
  "narcotic": false,
  "prescription": "일반의약품",
  "_raw": { "...": "..." }
}

Examples

The examples/ folder includes:

• drug-name-to-leaflet.sh — chain drug → drug-easy to get full consumer info from a brand name
• prescription-safety-check.sh — given a list of drug names, flag DUR interactions and pregnancy warnings
• recall-watch.sh — daily delta of recalls vs. yesterday's snapshot

Getting an API key

1. Register at https://www.data.go.kr (Naver / Kakao social login OK).
2. Search "의약품제품허가정보" (or any of the 4 services) and click 활용신청.
3. Approval is automatic for development tier (10,000 calls/day).
4. Copy the decoded service key (not the URL-encoded one) and export MFDS_API_KEY=....

The same key works across all four services after you register each one.

Rate limits

• Development tier: 10,000 requests/day per service.
• Production tier: unlimited after publishing a use case.
• The CLI does not retry on 429; if you hit it, slow down with sleep 0.2 between calls.

License

MIT-0 — public-domain-equivalent. MFDS data itself is 공공누리 제1유형 (free use with attribution to 식품의약품안전처).