FatSecret Nutrition API 技能评估
核心用法
FatSecret skill 提供完整的营养数据服务与饮食日记功能，采用双认证架构：
- OAuth2（客户端凭证）：无需用户登录，支持食物搜索、条码查询、食谱检索等只读操作
- OAuth1（三-legged）：需一次性 PIN 授权，解锁完整的日记写入功能，可记录三餐与营养摄入
主要功能覆盖：食物数据库搜索（支持模糊匹配）、条码扫描解析、宏量营养素/微量营养素查询、健康食谱检索、以及个人饮食日记的增删改查。CLI 工具与 Python SDK 双重支持，便于脚本自动化与智能体集成。
显著优点
1. 数据权威性：FatSecret 拥有超过 300 万种食物条目，涵盖包装食品、连锁餐厅及生鲜食材，数据来源经营养学界认可
2. 双轨认证设计：OAuth2 满足快速查询场景，OAuth1 保障写入安全，架构灵活
3. 条码扫描支持：直接对接商品条码数据库，便于快速识别包装食品
4. 开放替代方案：内置 Open Food Facts 客户端，欧洲产品可免费查询，降低使用门槛
5. 本地凭证管理：所有 token 与密钥均存储于本地 ~/.config/fatsecret/，无云端泄露风险
潜在缺点与局限性
- 认证流程繁琐：OAuth1 需用户手动访问授权页面并输入 PIN，交互链条较长
- 地域限制：FatSecret 数据库以北美市场为主，亚洲及欧洲本土产品覆盖可能不足
- 代理依赖：部分 API 套餐强制要求 IP 白名单，需配置 SOCKS5 代理，增加部署复杂度
- 写入权限过重：OAuth1 授权后应用可读写完整饮食日记，用户需信任应用开发者
适合人群
- 健身人士与营养追踪用户
- 需要自动化饮食记录的智能体/机器人开发者
- 健康管理类应用开发者
常规风险
| 风险类型 | 说明 |
|---------|------|
| 凭证泄露 | Consumer Key/Secret 存储于本地明文 JSON，共享设备存在暴露风险 |
| 授权持久化 | OAuth1 access token 长期有效，设备丢失可能导致账户被冒用 |
| 数据准确性 | 用户上传食物条目可能存在误差，关键营养决策建议交叉验证 |
| API 稳定性 | 依赖 FatSecret 商业服务，存在配额限制或接口变更可能 |
使用建议
- 生产环境建议启用代理并定期轮换凭证
- 敏感操作后及时 revoke 应用授权
- 结合 Open Food Facts 作为数据交叉验证来源