SKILL.md
唯讀
名稱
mfds-food-safety
描述
透過 k-skill-proxy 查詢食藥處/食品安全國家公開資料前,務必先反問症狀與攝取情況的訪談型食品安全檢查技能。
食品安全檢查
技能功能
透過 k-skill-proxy 查詢食藥處/食品安全國家公開資料,確認食品安全資訊。
可查詢的官方資料:
- 健康機能食品功能性原料認證現況 (I-0040) — 原料是否獲得官方認證、每日攝取量、攝取注意事項
- 健康機能食品個別認證型資訊 (I-0050) — 個別認證原料的功能性、攝取量上下限、注意事項
- 健康機能食品品項製造申報事項 (I0030) — 已申報產品的原料、功能性、攝取注意事項、基準規格(含告示型原料)
- 檢驗不合格現況(國內) (I2620) — 國內流通食品不合格判定紀錄
- 不合格食品清單 — 經由公共資料入口網站
- 回收·販賣中斷公開清單 (I0490) — 經由食品安全國家
但若使用者提到腹痛、腹瀉、皮疹等症狀,請勿直接下結論,務必先反問。
- 誰吃了(本人/小孩/孕婦/老年人)
- 吃了什麼、何時吃、吃多少
- 一起吃的食物/酒/藥
- 目前症狀與開始時間
- 基礎疾病、懷孕、過敏
- 紅旗警訊(
혈변、탈수、호흡곤란、의식저하、심한 복통/고열)
若有紅旗警訊,應優先引導立即前往急診、撥打119或諮詢醫療人員,而非查詢食品資料。
使用時機
- 「這個食物可以吃嗎?」→ 查詢健康機能食品原料認證現況 + 檢驗不合格
- 「洋車前子可以吃嗎?」→ 在功能性原料認證現況中確認每日攝取量與注意事項
- 「吃了這個飯糰肚子痛,有回收紀錄嗎?」→ 查詢回收·不合格清單
- 「請幫我在食藥處官方不合格食品清單中確認產品名稱」
- 「請幫我在食品安全國家公開回收清單中以業者名稱搜尋」
前置需求
- 網路連線
python3- 已安裝的 skill payload 中包含
scripts/mfds_food_safety.pyhelper - 可存取
k-skill-proxy的 food-safety 路由(hosted 或 self-host 代理)
憑證需求
- 使用者端無需機密資料。
KSKILL_PROXY_BASE_URL— 僅在使用 self-host 或自訂代理時設定。若留空,預設使用 hosted 的https://k-skill-proxy.nomadamas.org。DATA_GO_KR_API_KEY僅用於代理運作伺服器環境中即時查詢不合格食品。FOODSAFETYKOREA_API_KEY僅用於代理運作伺服器環境中即時查詢食品安全國家。若無此金鑰,可降級使用公開 sample feed。- 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 - 食品安全國家回收 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 - 代理路由:
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情況下運作,應以 warnings 提示結果可能基於 sample feed。
CLI 範例
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
回應政策
- 本技能不進行直接診斷。
- 本技能不進行食物中毒診斷或最終的攝取許可/禁止判定。
- 僅傳達官方公開清單中的事實。
- 對於有症狀的提問,未經訪談不得直接回答。
- 若有紅旗警訊或高風險族群,應優先建議諮詢醫療人員。
完成條件
- 已先反問症狀或攝取情況。
- 已確認紅旗警訊與否。
- 已透過代理路由在官方公開清單中,以產品名稱或業者名稱找到至少一筆結果,或明確告知無資料。
- 已提供包含產品名稱、業者名稱、公開原因/不合格原因、公開日期的摘要。






