📦 food nutrition facts search — 食物营养信息搜索
v1.0.1通过公开的 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
若用户只说“可口可乐”“燕麦奶”“饼干”,先 type=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
- 商品含 identity.siteUrl 时提示用户可打开查看完整页
- 截断或模糊时说明
- 无匹配则明确告知并建议更窄查询输出优先级
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