SuperAPI AI 工具集

pp-open-food-facts

数据与分析

查看项目

更新于 10-16 01:32

技能介绍

用途:该技能驱动 open-food-facts-pp-cli 二进制程序,为智能体提供有来源依据的 Open Food Facts 只读数据,包括按条形码查询产品、按类别/品牌/国家/标签/营养等级进行有界结构化搜索、营养成分摘要、配料与过敏原检查、少量产品对比及类别取样。

安装与验证:先验证 CLI 是否已安装,缺失时执行 npx -y @mvanhorn/printing-press-library install open-food-facts --cli-only;若失败可改用 go install github.com/mvanhorn/printing-press-library/library/food-and-dining/open-food-facts/cmd/open-food-facts-pp-cli@latest(需 Go 1.26.4 或更新版本)。验证命令为 open-food-facts-pp-cli --version,并确保安装目录在 $PATH 中。

配置:读取操作无需 API 密钥,但建议设置请求身份:export OPEN_FOOD_FACTS_USER_AGENT="my-food-tool/1.0" 和 export OPEN_FOOD_FACTS_CONTACT_EMAIL="you@example.org",可选设置 OPEN_FOOD_FACTS_BASE_URL。使用时需遵守文档限制:每 IP 每分钟 15 次产品读取、10 次搜索,禁止实时 API 批量抓取。

主要命令示例:product 3017620422003 --agent;search --category "breakfast cereals" --country "united-states" --page-size 5 --agent;nutrition 3017620422003 --agent;allergens 3017620422003 --agent;compare 3017620422003 5449000000996 --agent;category "breakfast cereals" --page-size 5 --agent。

限制:不用于产品编辑、图片上传、账户登录或会话流程;不用于批量采集或本地数据库同步,批量访问应使用 Open Food Facts 的 CSV/JSONL 导出;不要构建实时搜索即输入循环;不可将营养、配料或过敏原输出视为医疗或饮食建议;不得宣称 Open Food Facts 数据完整、准确或权威;其数据由社区贡献。