FatSecret Nutrition API 综合评估
核心用法
本 Skill 提供 FatSecret 营养 API 的完整集成，覆盖两大核心场景：只读查询（食品搜索、营养数据、条码识别、食谱查找）与 日记写入（饮食记录管理）。采用双认证架构：OAuth2 客户端凭证模式免登录即可查询；OAuth1 三-legged 授权支持完整日记功能，用户需一次性 PIN 码授权。
显著优点
1. 功能完整：唯一同时支持营养查询与日记管理的开源 FatSecret 集成方案
2. 认证灵活：双模式设计，简单查询无需用户交互，复杂场景支持完整 OAuth1 流程
3. 多数据源兜底：内置 Open Food Facts 客户端，欧洲产品无需认证即可查询
4. 代理支持：SOCKS5 代理配置解决 IP 白名单限制问题
5. CLI 与 Agent 双接口：bash 脚本即开即用，Python API 便于二次开发
潜在局限
- 认证门槛：日记功能需用户完成 OAuth1 授权流程，存在学习成本
- 地域覆盖不均：FatSecret 数据库以北美为主，欧洲/亚洲食品覆盖依赖 Open Food Facts
- 单位换算陷阱：
grams_or_ml参数需传入实际数值而非倍数，易因误用导致记录偏差 - 密钥管理责任：Consumer Key/Secret 需用户自行申请并本地安全存储
适合人群
- 健康管理类 Agent 开发者（需追踪用户饮食摄入）
- 个人量化自我（Quantified Self）用户
- 营养师、健身教练等需批量查询食品数据的从业者
- 需要与现有 FatSecret 账号打通的终端用户
常规风险
| 风险类别 | 说明 |
|---------|------|
| 数据隐私 | OAuth1 授权后 Agent 获得用户完整日记读写权限，需明确告知权限范围 |
| 记录准确性 | 食品数据依赖 FatSecret 社区维护，部分条目营养值可能存在偏差 |
| 服务依赖 | 免费 API 存在速率限制，商业化场景需评估付费计划 |
| 凭证泄露 | 本地 `~/.config/fatsecret/` 存储敏感信息，多用户环境需加强隔离 |
总体评价：T2 级可信度的专业营养数据工具，架构设计成熟，适合有明确 OAuth 集成经验的开发者部署，终端用户建议配合可视化的授权引导使用。