mfds-safety

MFDS 의약품·식품 안전 체크 (통합)

식품의약품안전처(MFDS) 공식 OpenAPI를 통해 의약품과 식품의 안전 정보를 확인합니다. 헬스·F&B 커머스 상품 검수, 소비자 안전 안내, 회수·부적합 이력 확인에 사용합니다.

본 스킬은 NomaDamas k-skill의 mfds-drug-safety + mfds-food-safety (MIT)를 통합 정리했습니다.

Mandatory interview first — red flag 우선

증상·복용/섭취 상황이 언급되면 결론을 말하기 전에 반드시 먼저 되묻습니다.

권장 첫 질문:

• 누가 (본인/아이/임산부/고령자), 무엇을 언제 얼마나, 같이 먹은 음식·술·약, 현재 증상, 기저질환·알레르기
• red flag: 호흡곤란, 의식저하, 입술·혀 붓기, 심한 발진, 혈변, 심한 탈수, 심한 복통/고열, 지속되는 구토/흉통

red flag 가 하나라도 있으면 API 조회보다 즉시 119·응급실·의료진 연결을 우선 안내합니다.

When to use

의약품:

• "이 약이랑 이 약 같이 먹어도 되니?"
• "타이레놀 먹는 중인데 판콜 같이 먹어도 돼?"
• "두드러기가 있는데 이 약 계속 먹어도 되나?"
• 식약처 공식 약 정보로 효능·주의사항 확인

식품:

• "이 음식 먹어도 괜찮니?" → 건강기능식품 원료 인정현황 + 검사부적합
• "차전자피 1일 섭취량 알려줘" → 기능성 원료 인정현황
• "이 김밥 먹고 배 아픈데 회수 이력 있어?" → 회수·부적합 목록
• 헬스/F&B 커머스에서 신상품 안전성 확인

When not to use

• 진단·처방·복용 지시
• 식중독 진단, 섭취 허가/금지 최종 판정
• red flag 또는 고위험군의 응급 상황 (의료진 우선)

Prerequisites

사용자 측 필수 시크릿 없음.

• KSKILL_PROXY_BASE_URL (선택): self-host 시
• 운영 측: DATA_GO_KR_API_KEY (의약품 + 부적합), FOODSAFETYKOREA_API_KEY (건강기능식품 + 회수 live) — 프록시 서버에만 둡니다
• FOODSAFETYKOREA_API_KEY 발급: https://www.foodsafetykorea.go.kr 회원가입 → OpenAPI 이용신청. 키 1개로 I-0040, I-0050, I0030, I0490, I2620 모두 사용

Workflow

A. 의약품 안전 체크

1. 증상/복용 상황이 있으면 인터뷰 먼저.
2. red flag 하나라도 있으면 즉시 응급 안내로 전환.
3. 약 이름이 확인되면 /v1/mfds/drug-safety/lookup 으로 e약은요·안전상비의약품 조회.
4. 효능·사용법·주의사항·상호작용·이상반응·보관법을 짧게 정리.
5. "같이 먹어도 되나?"는 공식 상호작용 문구만 근거. 최종 판단은 약사·의료진.

B. 식품 안전 체크

1. 증상/섭취 상황이 있으면 인터뷰 먼저.
2. red flag → 즉시 응급 안내.
3. "이거 먹어도 되나?" 흐름:
4. /v1/mfds/food-safety/product-report → 건강기능식품 품목제조 신고사항(원재료·기능성·섭취 주의·기준규격, 고시형 원료 포함)
5. /v1/mfds/food-safety/health-food-ingredient → 기능성 원료 인정현황(개별인정형 1일 섭취량·주의사항)
6. /v1/mfds/food-safety/inspection-fail → 국내 검사부적합 이력
7. /v1/mfds/food-safety/search → 회수·부적합 공개 목록
8. 제품명·업체명·기능성·섭취량·주의사항·부적합 사유를 짧게 정리. 먹어도 되는지 단정하지 않습니다.
9. 프록시가 FOODSAFETYKOREA_API_KEY 없이 동작하면 결과가 sample feed 기반일 수 있음을 warnings로 확인.

Endpoints

| 카테고리 | Endpoint | |---|---| | 의약품 통합 | GET /v1/mfds/drug-safety/lookup | | 식품 회수·부적합 | GET /v1/mfds/food-safety/search | | 건강기능식품 원료 | GET /v1/mfds/food-safety/health-food-ingredient | | 건강기능식품 품목제조 | GET /v1/mfds/food-safety/product-report | | 검사부적합 | GET /v1/mfds/food-safety/inspection-fail |

Official surfaces

• e약은요: https://apis.data.go.kr/1471000/DrbEasyDrugInfoService/getDrbEasyDrugList
• 안전상비의약품: https://apis.data.go.kr/1471000/SafeStadDrugService/getSafeStadDrugInq
• 식품안전나라 (I-0040/I-0050/I0030/I0490/I2620): https://www.foodsafetykorea.go.kr/api/openApiInfo.do
• 부적합 식품: https://apis.data.go.kr/1471000/PrsecImproptFoodInfoService03/getPrsecImproptFoodList01

Response policy

• 본 스킬은 진단·처방·복용 지시를 하지 않습니다.
• 공식 문서에 있는 효능·주의·상호작용·기능성 문구만 근거로 요약합니다.
• 상호작용 문구가 모호하거나 red flag 가 있으면 약사·의사 상담으로 넘깁니다.
• 증상이 있는 질문은 인터뷰 없이 바로 답하지 않습니다.
• 회수·부적합 결과가 sample feed면 그 사실을 명시합니다.

관련 스킬 체이닝

• before: moai-commerce:commerce-strategy — 헬스/F&B 신상품 기획 시 안전성 검토
• after: moai-commerce:detail-page-copy — 안전 정보 반영한 상세페이지 카피
• after: moai-content:product-detail — 안전성 안내 콘텐츠 작성

Done when

• 증상 또는 복용/섭취 상황을 먼저 되물었다.
• red flag 여부를 확인했다.
• 프록시 route를 통해 공식 endpoint 조회 결과를 JSON으로 정리했다.
• 의약품: 제품명·업체명·효능·주의·상호작용 요약 / 식품: 제품명·업체명·기능성·섭취량·주의·부적합 사유 요약을 제공했다.