用途:查询某食品或品牌产品中实际含有的成分,包括营养素数值、配料表、过敏原、添加剂和加工等级分类。数据来自两个互补来源,工具本身不进行毒理学或流行病学分析,需将检索到的数据交给 tooluniverse-toxicology(添加剂/过敏原安全问题)或 tooluniverse-epidemiological-analysis(膳食暴露问题)处理。原则是“查询而非凭记忆”,不要凭记忆给出营养素值、配料、过敏原或Nutri-Score。
主要能力:一、USDA FoodData Central,提供权威美国营养素数据,含 Foundation Foods、SR Legacy、Survey/FNDDS 和 Branded 类型。工具 FoodDataCentral_search_foods 支持关键词搜索,参数 query、page_size(最大200)、page_number、data_type;FoodDataCentral_get_food 按 fdc_id 返回70多种营养素的完整档案。可选 FDC_API_KEY(免费,在 https://fdc.nal.usda.gov/api-guide.html 注册),无密钥时回退到共享限流的 DEMO_KEY。二、Open Food Facts,众包全球产品库,300万以上产品,品牌与国际覆盖更广但非集中审核,个别记录可能有缺失或不一致。工具 OpenFoodFacts_search_products(search_terms 必填,page_size 最大100,默认50,page)、OpenFoodFacts_get_product(barcode 必填,EAN-13/UPC)、OpenFoodFacts_filter_products_by_tags(按受控词表标签做分面搜索,参数如 additives_tags、allergens_tags、categories_tags_en、brands_tags、nutrition_grades_tags、labels_tags、countries_tags、fields、page_size、page,可组合为 AND)。三个工具均无需 API 密钥。
使用方式:查通用/参考食品的严格营养素值用 FoodDataCentral(Foundation 或 SR Legacy);查品牌产品标签营养素可用两者并交叉核对;查配料、过敏原、添加剂、Nutri-Score 或 NOVA 加工等级用 Open Food Facts;按条码查产品用 OpenFoodFacts_get_product;查“含/不含某添加剂或过敏原的产品”用 filter_products_by_tags。
限制与注意:不要凭记忆使用 fdcId,USDA 的 ID 可能随时间变动或废弃,应在同一次会话中通过 search_foods 获取;Open Food Facts 为众包数据,字段缺失或异常可能只是该产品贡献不完整,不代表工具故障;filter_products_by_tags 的标签字段使用受控词表(如 en:peanuts、en:e322),应从产品自身的标签字段获取确切值而非猜测;Open Food Facts 偶发返回 HTML“Page temporarily unavailable”错误,可重试一次再判断是否故障。临床营养指南或饮食-疾病管理建议不在本工具范围内。