📦 nutrition facts search — 营养成分搜索
v1.0.0通过公开、对 AI 友好的端点搜索营养成分、食品评分与包装商品数据。当用户要求查找、对比或查看食品时调用。
运行时依赖
安装命令
点击复制技能文档
营养信息搜索 当用户想从公开食品数据网站获取营养信息、食品评分、商品详情或条码查询数据,而非分析代码库时,使用本技能。
何时调用 用户执行以下操作时调用:
- 查找食品或包装商品
- 提供品牌名、条码或部分商品名并想匹配对应条目
- 想利用营养信息或食品评分对比两种及以上食品/商品
- 想获得食品或商品详情页的结构化摘要
不用于仓库代码搜索、实现问题或非相关网站。
公共端点
搜索:https://foodbenchmark.com/api/ai/search?q=&type=&limit=<1-20>&offset=<0-based>
食品详情:https://foodbenchmark.com/api/ai/foods/
商品详情:https://foodbenchmark.com/api/ai/products/
食品 vs 商品
food:通用食品概念,如香蕉、橄榄油、西兰花- product:可展示标签式字段的商品记录,如营养信息、配料、添加剂、品牌、条码、包装数据
二者为不同数据集,不可互换:
foods 适合通用食品实体、类别级评分、食品导向摘要- products 适合包装商品及需要营养标签式数据的请求
重要规则
若用户索要营养信息、营养标签、热量、蛋白质、脂肪、碳水、按份营养素等,使用 products
即使用户说“全脂牛奶”“香蕉”,只要意图是查看营养信息,就用 products
若用户要配料表、配料分析、添加剂详情或条码查询,仅用 products
若用户只要通用食品条目或评分摘要,不要营养信息,优先 foods
若用户给出品牌、条码或具体包装品,优先 products
若用户只说“可口可乐”“燕麦奶”“饼干”,先搜 all 再消歧
类型选择规则
按用户意图而非名称选 type:
索要营养信息、标签、热量、宏量、按份营养、配料、添加剂、条码、包装/品牌 → type=products- 索要通用食品、类别背景、评分摘要且不要营养信息 → type=foods
- 查询模糊 → type=all,搜索后再选
快速意图映射
Find banana nutrition facts → type=products
Show whole milk calories → type=products
Compare oat milk nutrition labels → type=products
Find banana food score → type=foods
What category is olive oil in? → type=foods
Coca-Cola → type=all
工作流
先搜索
- 用户要营养信息或标签数据 → type=products
- 用户明显要包装品、品牌、配料、添加剂、条码 → type=products
- 用户明显要通用食品或评分摘要且不要营养信息 → type=foods
- 查询模糊 → type=all
搜索返回:foods、products、meta(总计、分页、截断)- 必要时取详情
- 唯一明显结果 → 直接取详情
- 多个接近匹配 → 先展示最佳结果供用户选择
- 需要对比 → 分别取各条目详情 - 保持简洁
- 优先结构化摘要,避免原始 JSON
- 给出每条目的官网 canonical URL
- 若结果截断或模糊,予以说明
- 无匹配则明确提示并建议更精确查询 输出优先级
foods:标题、类别、Food Compass 2、Health Star Rating、Nutri-Score、NOVA 组、canonical URL
products:标题、品牌、Nutri-Score、NOVA 组、环境评分摘要、相关配料/添加剂亮点、canonical URL
查询策略
- 仅条码 → type=products
- 任何名称的营养信息请求 → type=products
- 明显食品名但无营养意图 → type=foods
- 配料、添加剂、包装标签问题 → type=products
- 品牌等模糊名称 → 先 type=all