korean-pharma-data

한국 의약품 데이터를 쉽게 수집하고 활용하세요.

A Python library for collecting, parsing, and cleaning Korean pharmaceutical open data from the Ministry of Food and Drug Safety (MFDS / 식약처) APIs.

Features / 주요 기능

• 의약품 정보 수집 (e약은요 API) - Drug product information
• DUR 상호작용 정보 - Drug interaction data (contraindicated combinations, age restrictions, pregnancy restrictions, dosage warnings)
• 의약품 성분 정보 - Drug ingredient data
• 건강기능식품 정보 - Health supplement data
• 다양한 내보내기 형식 - Export to JSON, CSV, SQLite (with FTS5 search), Parquet
• 비동기 수집 - Async collection with rate limiting and caching
• CLI 도구 - Command-line interface for quick data collection

Quick Start / 빠른 시작

Installation / 설치

pip install korean-pharma-data

# With all optional dependencies
pip install korean-pharma-data[all]

API Key / API 키 발급

1. 공공데이터포털 회원가입
2. 다음 API 활용 신청:
   • 의약품 제품 허가정보 (e약은요)
   • DUR 품목정보
   • 의약품 성분정보
   • 건강기능식품 정보
3. 발급받은 인증키를 환경변수로 설정:

export MFDS_API_KEY="your-api-key-here"

Python API

import asyncio
from korean_pharma_data.client import MFDSClient
from korean_pharma_data.collectors import DrugInfoCollector
from korean_pharma_data.exporters import export_json

async def main():
    async with MFDSClient(api_key="YOUR_KEY") as client:
        collector = DrugInfoCollector(client)

        # Search for drugs
        drugs = await collector.search("타이레놀", max_results=10)
        for drug in drugs:
            print(f"{drug.item_name} - {drug.entp_name}")

        # Export to JSON
        export_json(drugs, "results.json")

asyncio.run(main())

CLI

# Collect drug data
korean-pharma-data collect drugs --api-key $MFDS_API_KEY --output drugs.json

# Collect DUR interactions
korean-pharma-data collect dur --api-key $MFDS_API_KEY --type 병용금기 --output dur.json

# Collect supplements
korean-pharma-data collect supplements --api-key $MFDS_API_KEY --output supplements.json

# Export to SQLite with full-text search
korean-pharma-data export drugs.json --format sqlite --output pharma.db

# Search in SQLite database
korean-pharma-data search "타이레놀" --db pharma.db

Data Sources / 수집 가능한 데이터

Data Models / 데이터 모델

Drug (의약품)

DURInteraction (DUR 상호작용)

Supplement (건강기능식품)

Export Formats / 내보내기 형식

Development / 개발

# Clone the repository
git clone https://github.com/pillright/korean-pharma-data.git
cd korean-pharma-data

# Install in development mode
pip install -e ".[dev,all]"

# Run tests
pytest -v

# Lint
ruff check src/ tests/

Related Projects

Part of the Pillright open-source healthcare ecosystem:

• llm-medical-guard — Safety guardrails for LLM medical content
• drug-interaction-mcp — MCP server for drug interaction checking
• pharma-ai-agent — RAG-based drug information AI agent
• awesome-drug-interactions — Curated list of drug interaction resources
• fastapi-health-template — Healthcare FastAPI boilerplate

Contributing / 기여

1. Fork the repository
2. Create a feature branch (git checkout -b feat/amazing-feature)
3. Commit your changes (git commit -m 'feat: add amazing feature')
4. Push to the branch (git push origin feat/amazing-feature)
5. Open a Pull Request

License / 라이선스

This project is licensed under the MIT License - see the LICENSE file for details.

Disclaimer / 면책조항

This library provides access to publicly available pharmaceutical data from Korea's MFDS. The data is provided as-is and should not be used as a substitute for professional medical advice.

이 라이브러리는 식약처의 공공데이터를 제공하며, 의사/약사의 전문적 판단을 대체하지 않습니다.