Back to Details

mfds-food-safety

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

식품 안전 체크

食品安全检查

What this skill does

本Skill的功能

식약처/식품안전나라 공개 표면을 
k-skill-proxy
경유로 조회해 식품 안전 정보를 확인한다.
조회 가능한 공식 데이터:
  • 건강기능식품 기능성 원료 인정현황 (I-0040) — 원료가 공식 인정됐는지, 1일 섭취량, 섭취시 주의사항
  • 건강기능식품 개별인정형 정보 (I-0050) — 개별 인정 원료의 기능성, 섭취량 상·하한, 주의사항
  • 건강기능식품 품목제조 신고사항 (I0030) — 신고된 제품의 원재료, 기능성, 섭취 주의사항, 기준규격 (고시형 원료 포함)
  • 검사부적합 현황(국내) (I2620) — 국내 유통 식품 부적합 판정 이력
  • 부적합 식품 목록 — 공공데이터포털 경유
  • 회수·판매중지 공개 목록 (I0490) — 식품안전나라 경유
하지만 사용자가 복통, 설사, 발진 같은 증상을 말하면 바로 단정하지 말고 먼저 되묻는다.
  • 누가 먹었는지 (본인/아이/임산부/고령자)
  • 무엇을 언제 얼마나 먹었는지
  • 같이 먹은 음식/술/약
  • 현재 증상과 시작 시점
  • 기저질환, 임신, 알레르기
  • red flag (
    혈변
    , 
    탈수
    , 
    호흡곤란
    , 
    의식저하
    , 
    심한 복통/고열
    )
red flag 가 있으면 식품 조회보다 즉시 응급실·119·의료진 안내가 우선이다.
通过**
k-skill-proxy
**查询韩国食药处/食品安全公开平台的信息，以确认食品安全相关内容。
可查询的官方数据:
  • 健康功能食品功能性原料认可现状 (I-0040) — 原料是否获得官方认可、每日摄入量、食用注意事项
  • 健康功能食品个别认可型信息 (I-0050) — 个别认可原料的功能性、摄入量上下限、注意事项
  • 健康功能食品品类制造申报事项 (I0030) — 已申报产品的原料、功能性、食用注意事项、标准规格（含公告型原料）
  • 国内检验不合格现状 (I2620) — 韩国流通食品的不合格判定记录
  • 不合格食品清单 — 通过公共数据门户查询
  • 召回·停止销售公开清单 (I0490) — 通过食品安全平台查询
但如果用户提及腹痛、腹泻、皮疹等症状，不要直接下定论，应先进行询问。
  • 食用者是谁（本人/儿童/孕妇/老年人）
  • 食用了什么、何时食用、食用量多少
  • 同时食用的食物/酒/药物
  • 当前症状及发作时间
  • 基础疾病、怀孕、过敏史
  • red flag (
    便血
    、
    脱水
    、
    呼吸困难
    、
    意识模糊
    、
    严重腹痛/高烧
    )
若存在red flag，应优先引导用户立即前往急诊、拨打119或咨询医护人员，而非进行食品信息查询。

When to use

使用场景

  • "이 음식 먹어도 괜찮니?" → 건강기능식품 원료 인정현황 + 검사부적합 조회
  • "차전자피를 먹어도 되나?" → 기능성 원료 인정현황에서 1일 섭취량·주의사항 확인
  • "이 김밥 먹고 배가 아픈데 회수 이력 있나?" → 회수·부적합 목록 조회
  • "식약처 공식 부적합 식품 목록에서 제품명 확인해줘"
  • "식품안전나라 공개 회수 목록에서 업체명으로 찾아줘"
  • "这个食物可以吃吗？" → 查询健康功能食品原料认可现状+检验不合格记录
  • "可以吃车前子壳吗？" → 在功能性原料认可现状中查看每日摄入量·注意事项
  • "吃了这个紫菜包饭后肚子痛，有召回记录吗？" → 查询召回·不合格清单
  • "帮我在食药处官方不合格食品清单中确认产品名"
  • "帮我在食品安全平台公开的召回清单中按企业名查找"

Prerequisites

前置条件

  • 인터넷 연결
  • python3
  • 설치된 skill payload 안에 
    scripts/mfds_food_safety.py
    helper 포함
  • k-skill-proxy
    의 food-safety route들이 있는 hosted/self-host 프록시에 접근 가능할 것
  • 网络连接
  • python3
  • 已安装的Skill包中包含
    scripts/mfds_food_safety.py
    辅助脚本
  • 可访问包含
    k-skill-proxy
    的food-safety路由的托管/自托管代理

Credential requirements

凭证要求

  • 사용자 측 필수 시크릿 없음.
  • KSKILL_PROXY_BASE_URL
    — self-host·별도 프록시를 쓸 때만 설정. 비우면 기본 hosted 
    https://k-skill-proxy.nomadamas.org
    를 사용한다.
  • DATA_GO_KR_API_KEY
    는 프록시 운영 서버 환경에서 부적합 식품 live 조회용으로만 둔다.
  • FOODSAFETYKOREA_API_KEY
    는 프록시 운영 서버 환경에서 식품안전나라 live 조회용으로만 둔다. 없으면 public sample feed로 fallback 할 수 있다.
  • FOODSAFETYKOREA_API_KEY 발급: 
    https://www.foodsafetykorea.go.kr
    에서 회원가입 후 OpenAPI 이용신청. 하나의 키로 I-0040, I-0050, I0490, I2620 등 모든 서비스 호출 가능.
  • 用户侧无需提供密钥。
  • KSKILL_PROXY_BASE_URL
    — 仅在使用自托管/独立代理时设置。留空则使用默认托管地址
    https://k-skill-proxy.nomadamas.org
    。
  • DATA_GO_KR_API_KEY
    仅在代理运营服务器环境中用于实时查询不合格食品。
  • FOODSAFETYKOREA_API_KEY
    仅在代理运营服务器环境中用于实时查询食品安全平台信息。若没有该密钥，将回退使用公开样本数据。
  • FOODSAFETYKOREA_API_KEY 申请：在
    https://www.foodsafetykorea.go.kr
    注册会员后申请OpenAPI使用权限。单个密钥可调用I-0040、I-0050、I0490、I2620等所有服务。

Mandatory interview first

必须先进行访谈

증상/섭취상황이 언급되면 결론을 말하기 전에 먼저 되묻는다.
권장 첫 질문 예시:
  • 누가 무엇을 언제 얼마나 먹었는지, 지금 복통/구토/설사/발진 같은 증상이 있는지 먼저 알려주세요.
  • 호흡곤란, 혈변, 심한 탈수, 의식저하, 심한 복통/고열이 있으면 즉시 응급실이나 119가 우선입니다.
若用户提及症状或摄入情况，在给出结论前必须先进行询问。
推荐的初始提问示例:
  • 请先告知是谁、在何时吃了什么、吃了多少，以及是否有腹痛/呕吐/腹泻/皮疹等当前症状。
  • 若出现呼吸困难、便血、严重脱水、意识模糊、严重腹痛/高烧等情况，请立即前往急诊或拨打119。

Official surfaces

官方接口与地址

  • 공공데이터포털 문서: 
    https://www.data.go.kr/data/15056516/openapi.do
  • 부적합 식품 endpoint: 
    https://apis.data.go.kr/1471000/PrsecImproptFoodInfoService03/getPrsecImproptFoodList01
  • 식품안전나라 회수·판매중지 (I0490): 
    https://www.foodsafetykorea.go.kr/api/openApiInfo.do?menu_grp=MENU_GRP31&menu_no=661&show_cnt=10&start_idx=1&svc_no=I0490&svc_type_cd=API_TYPE06
  • 식품안전나라 회수 sample: 
    https://openapi.foodsafetykorea.go.kr/api/sample/I0490/json/1/5
  • 건강기능식품 기능성 원료 인정현황 (I-0040): 
    https://www.foodsafetykorea.go.kr/api/openApiInfo.do?menu_grp=MENU_GRP31&menu_no=661&show_cnt=10&start_idx=1&svc_no=I-0040&svc_type_cd=API_TYPE06
  • 건강기능식품 기능성 원료 sample: 
    https://openapi.foodsafetykorea.go.kr/api/sample/I-0040/json/1/5
  • 건강기능식품 개별인정형 정보 (I-0050): 
    https://www.foodsafetykorea.go.kr/api/openApiInfo.do?menu_grp=MENU_GRP31&menu_no=661&show_cnt=10&start_idx=1&svc_no=I-0050&svc_type_cd=API_TYPE06
  • 건강기능식품 개별인정형 sample: 
    https://openapi.foodsafetykorea.go.kr/api/sample/I-0050/json/1/5
  • 검사부적합(국내) (I2620): 
    https://www.foodsafetykorea.go.kr/api/openApiInfo.do?menu_grp=MENU_GRP31&menu_no=661&show_cnt=10&start_idx=1&svc_no=I2620&svc_type_cd=API_TYPE06
  • 검사부적합(국내) sample: 
    https://openapi.foodsafetykorea.go.kr/api/sample/I2620/json/1/5
  • 건강기능식품 품목제조 신고사항 (I0030): 
    https://www.foodsafetykorea.go.kr/api/openApiInfo.do?menu_grp=MENU_GRP31&menu_no=661&show_cnt=10&start_idx=1&svc_no=I0030&svc_type_cd=API_TYPE06
  • 건강기능식품 품목제조 신고 sample: 
    https://openapi.foodsafetykorea.go.kr/api/sample/I0030/json/1/5
  • 프록시 route: 
    GET /v1/mfds/food-safety/search
  • 프록시 route: 
    GET /v1/mfds/food-safety/health-food-ingredient
  • 프록시 route: 
    GET /v1/mfds/food-safety/product-report
  • 프록시 route: 
    GET /v1/mfds/food-safety/inspection-fail
  • 公共数据门户文档: 
    https://www.data.go.kr/data/15056516/openapi.do
  • 不合格食品接口: 
    https://apis.data.go.kr/1471000/PrsecImproptFoodInfoService03/getPrsecImproptFoodList01
  • 食品安全平台召回·停止销售 (I0490): 
    https://www.foodsafetykorea.go.kr/api/openApiInfo.do?menu_grp=MENU_GRP31&menu_no=661&show_cnt=10&start_idx=1&svc_no=I0490&svc_type_cd=API_TYPE06
  • 食品安全平台召回样本: 
    https://openapi.foodsafetykorea.go.kr/api/sample/I0490/json/1/5
  • 健康功能食品功能性原料认可现状 (I-0040): 
    https://www.foodsafetykorea.go.kr/api/openApiInfo.do?menu_grp=MENU_GRP31&menu_no=661&show_cnt=10&start_idx=1&svc_no=I-0040&svc_type_cd=API_TYPE06
  • 健康功能食品功能性原料样本: 
    https://openapi.foodsafetykorea.go.kr/api/sample/I-0040/json/1/5
  • 健康功能食品个别认可型信息 (I-0050): 
    https://www.foodsafetykorea.go.kr/api/openApiInfo.do?menu_grp=MENU_GRP31&menu_no=661&show_cnt=10&start_idx=1&svc_no=I-0050&svc_type_cd=API_TYPE06
  • 健康功能食品个别认可型样本: 
    https://openapi.foodsafetykorea.go.kr/api/sample/I-0050/json/1/5
  • 国内检验不合格 (I2620): 
    https://www.foodsafetykorea.go.kr/api/openApiInfo.do?menu_grp=MENU_GRP31&menu_no=661&show_cnt=10&start_idx=1&svc_no=I2620&svc_type_cd=API_TYPE06
  • 国内检验不合格样本: 
    https://openapi.foodsafetykorea.go.kr/api/sample/I2620/json/1/5
  • 健康功能食品品类制造申报事项 (I0030): 
    https://www.foodsafetykorea.go.kr/api/openApiInfo.do?menu_grp=MENU_GRP31&menu_no=661&show_cnt=10&start_idx=1&svc_no=I0030&svc_type_cd=API_TYPE06
  • 健康功能食品品类制造申报样本: 
    https://openapi.foodsafetykorea.go.kr/api/sample/I0030/json/1/5
  • 代理路由: 
    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

Workflow

工作流程

  1. 증상/섭취상황이 있으면 인터뷰를 먼저 진행한다.
  2. red flag 가 있으면 즉시 응급 안내로 전환한다.
  3. "이거 먹어도 되나?" 류 질문: 
    • /v1/mfds/food-safety/product-report
      로 건강기능식품 품목제조 신고사항을 조회한다 (원재료, 기능성, 섭취 주의사항, 기준규격). 고시형 원료(차전자피 등)는 여기서 확인.
    • /v1/mfds/food-safety/health-food-ingredient
      로 건강기능식품 기능성 원료 인정현황을 조회한다 (개별인정형 원료의 1일 섭취량, 주의사항).
    • /v1/mfds/food-safety/inspection-fail
      로 국내 검사부적합 이력을 확인한다.
    • /v1/mfds/food-safety/search
      로 회수·부적합 공개 목록도 함께 조회한다.
  4. 제품명, 업체명, 기능성, 섭취량, 주의사항, 부적합 사유를 짧게 정리하고, 먹어도 되는지 단정하지 않는다.
  5. 프록시가 
    FOODSAFETYKOREA_API_KEY
    없이 동작 중이면 결과가 sample feed 기반일 수 있음을 warnings 로 확인한다.
  1. 若用户提及症状或摄入情况，先进行访谈。
  2. 若存在red flag，立即切换至应急引导。
  3. 对于“这个可以吃吗？”类问题:
    • 通过
      /v1/mfds/food-safety/product-report
      查询健康功能食品品类制造申报事项（原料、功能性、食用注意事项、标准规格）。公告型原料（如车前子壳）可在此查询。
    • 通过
      /v1/mfds/food-safety/health-food-ingredient
      查询健康功能食品功能性原料认可现状（个别认可型原料的每日摄入量、注意事项）。
    • 通过
      /v1/mfds/food-safety/inspection-fail
      查询国内检验不合格记录。
    • 通过
      /v1/mfds/food-safety/search
      同时查询召回·不合格公开清单。
  4. 简要整理产品名、企业名、功能性、摄入量、注意事项、不合格原因，不直接判断是否可食用。
  5. 若代理未配置
    FOODSAFETYKOREA_API_KEY
    运行，需通过提示告知用户结果可能基于样本数据。

CLI examples

CLI示例

bash
python3 scripts/mfds_food_safety.py interview \
  --question "이 김밥 먹어도 되나요?" \
  --symptoms "복통과 설사"
bash
python3 scripts/mfds_food_safety.py search --query "김밥" --limit 5
bash
python3 scripts/mfds_food_safety.py product-report --query "차전자피" --limit 5
bash
python3 scripts/mfds_food_safety.py health-food-ingredient --query "스타놀" --limit 5
bash
python3 scripts/mfds_food_safety.py inspection-fail --query "쪽갓" --limit 5
bash
python3 scripts/mfds_food_safety.py interview \
  --question "这个紫菜包饭可以吃吗？" \
  --symptoms "腹痛和腹泻"
bash
python3 scripts/mfds_food_safety.py search --query "紫菜包饭" --limit 5
bash
python3 scripts/mfds_food_safety.py product-report --query "车前子壳" --limit 5
bash
python3 scripts/mfds_food_safety.py health-food-ingredient --query "斯坦诺" --limit 5
bash
python3 scripts/mfds_food_safety.py inspection-fail --query "荠菜" --limit 5

Response policy

响应规则

  • 이 스킬은 직접 진단을 하지 않는다.
  • 이 스킬은 식중독 진단이나 섭취 허가/금지의 최종 판정을 하지 않는다.
  • 공식 공개 목록에 있는 사실만 전달한다.
  • 증상이 있는 질문은 인터뷰 없이 바로 답하지 않는다.
  • red flag 또는 고위험군이면 의료진 상담을 우선 권고한다.
  • 本Skill不进行直接诊断。
  • 本Skill不进行食物中毒诊断或最终判定是否允许/禁止食用。
  • 仅传递官方公开清单中的事实信息。
  • 对于提及症状的问题，不跳过访谈直接回答。
  • 若存在red flag或涉及高危人群，优先建议咨询医护人员。

Done when

完成标准

  • 증상 또는 섭취상황을 먼저 되물었다.
  • red flag 여부를 확인했다.
  • 프록시 route를 통해 공식 공개 목록에서 제품명 또는 업체명 기준 결과를 최소 1건 이상 찾았거나, 없다고 분명히 알렸다.
  • 제품명, 업체명, 공개사유/부적합 사유, 공개일자를 포함한 요약을 제공했다.
  • 已先询问症状或摄入情况。
  • 已确认是否存在red flag。
  • 通过代理路由从官方公开清单中，至少找到1条以上基于产品名或企业名的结果，或明确告知无结果。
  • 提供了包含产品名、企业名、公开原因/不合格原因、公开日期的摘要。