SKILL.md
readonly只读
name
mfds-food-safety
description
通过k-skill-proxy查询韩国食药处/食品安全国家公开数据前,必须追问症状和摄入情况的访谈式食品安全检查技能。
食品安全检查
技能功能
通过**k-skill-proxy**查询韩国食药处/食品安全国家公开数据,获取食品安全信息。
可查询的官方数据:
- 健康功能食品功能性原料认证现状 (I-0040) — 原料是否获得官方认证、每日摄入量、摄入注意事项
- 健康功能食品个别认证型信息 (I-0050) — 个别认证原料的功能性、摄入量上下限、注意事项
- 健康功能食品品类制造申报事项 (I0030) — 已申报产品的原材料、功能性、摄入注意事项、标准规格(包括告示型原料)
- 检验不合格现状(国内) (I2620) — 国内流通食品不合格判定记录
- 不合格食品列表 — 通过公共数据门户查询
- 召回·暂停销售公开列表 (I0490) — 通过食品安全国家查询
但如果用户提到腹痛、腹泻、皮疹等症状,不要立即下结论,先追问。
- 谁吃了(本人/儿童/孕妇/老年人)
- 吃了什么、何时吃、吃了多少
- 同时吃的食物/酒/药
- 当前症状及开始时间
- 基础疾病、怀孕、过敏
- 红旗征(
혈변、탈수、호흡곤란、의식저하、심한 복통/고열)
如有红旗征,优先立即引导就医(急诊/119/医护人员),而非查询食品信息。
使用场景
- "这个食物可以吃吗?" → 查询健康功能食品原料认证现状 + 检验不合格
- "可以吃车前子壳吗?" → 在功能性原料认证现状中确认每日摄入量·注意事项
- "吃了这个紫菜包饭肚子疼,有召回记录吗?" → 查询召回·不合格列表
- "请从食药处官方不合格食品列表中确认产品名称"
- "请从食品安全国家公开召回列表中按企业名称查找"
前提条件
- 互联网连接
python3- 已安装的技能负载中包含
scripts/mfds_food_safety.py辅助脚本 - 可访问托管或自托管的
k-skill-proxy的 food-safety 路由
凭证要求
- 用户侧无需密钥。
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等所有服务。
强制先进行访谈
当提到症状/摄入情况时,在给出结论前必须先追问。
推荐的首个问题示例:
누가 무엇을 언제 얼마나 먹었는지, 지금 복통/구토/설사/발진 같은 증상이 있는지 먼저 알려주세요.호흡곤란, 혈변, 심한 탈수, 의식저하, 심한 복통/고열이 있으면 즉시 응급실이나 119가 우선입니다.
官方数据源
- 公共数据门户文档:
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
工作流程
- 如有症状/摄入情况,先进行访谈。
- 如有红旗征,立即转为紧急就医引导。
- 对于“这个可以吃吗?”类问题:
- 通过
/v1/mfds/food-safety/product-report查询健康功能食品品类制造申报事项(原材料、功能性、摄入注意事项、标准规格)。告示型原料(如车前子壳)在此确认。 - 通过
/v1/mfds/food-safety/health-food-ingredient查询健康功能食品功能性原料认证现状(个别认证型原料的每日摄入量、注意事项)。 - 通过
/v1/mfds/food-safety/inspection-fail查询国内检验不合格记录。 - 通过
/v1/mfds/food-safety/search同时查询召回·不合格公开列表。
- 通过
- 简要整理产品名称、企业名称、功能性、摄入量、注意事项、不合格原因,不判断是否可以食用。
- 若代理在无
FOODSAFETYKOREA_API_KEY的情况下运行,需通过警告提示结果可能基于示例数据。
命令行示例
python3 scripts/mfds_food_safety.py interview \
--question "这个紫菜包饭可以吃吗?" \
--symptoms "腹痛和腹泻"
python3 scripts/mfds_food_safety.py search --query "紫菜包饭" --limit 5
python3 scripts/mfds_food_safety.py product-report --query "车前子壳" --limit 5
python3 scripts/mfds_food_safety.py health-food-ingredient --query "植物固醇" --limit 5
python3 scripts/mfds_food_safety.py inspection-fail --query "小萝卜" --limit 5
回复策略
- 本技能不进行直接诊断。
- 本技能不进行食物中毒诊断或最终判定是否可食用/禁止食用。
- 仅传达官方公开列表中存在的事实。
- 对于有症状的问题,未经访谈不得直接回答。
- 如有红旗征或高危人群,优先建议咨询医护人员。
完成条件
- 已先追问症状或摄入情况。
- 已确认是否存在红旗征。
- 通过代理路由在官方公开列表中至少找到一条基于产品名称或企业名称的结果,或明确告知未找到。
- 提供包含产品名称、企业名称、公开原因/不合格原因、公开日期的摘要。






