FatSecret 营养 API 技能评估
核心用法
FatSecret 技能提供完整的营养数据查询与饮食日记管理功能，主要面向需要追踪饮食摄入的用户。核心功能包括：食物数据库搜索（支持关键词模糊匹配）、详细营养成分查询（热量、宏量营养素、微量营养素）、条码扫描识别商品、健康食谱搜索，以及最重要的——饮食日记自动记录（支持早餐、午餐、晚餐、加餐四个时段）。
技能采用双数据源架构：FatSecret 作为主力数据库覆盖北美市场，提供完整的 API 访问和日记写入功能；Open Food Facts 作为免费补充，专注欧洲/意大利产品数据，无需认证即可只读访问。这种设计既保证了功能完整性，又降低了特定场景的使用门槛。
显著优点
- 代理自动化友好：专为 OpenClaw 代理设计，将复杂的 OAuth1 三-legged 认证流程封装为 4 步自动化交互，用户仅需提供 Consumer Key/Secret 和一次授权 PIN
- 持久化认证：OAuth1 Token 长期有效，存储于本地配置文件，避免重复授权
- 双源互补：FatSecret + Open Food Facts 覆盖欧美主流市场，条码扫描场景实用性高
- 简化日记操作：
quick_log等封装函数将多步 API 调用简化为单行命令，大幅降低代理开发复杂度 - 完整 CLI 工具：提供统一的 shell 脚本接口，便于调试和手动使用
潜在缺点与局限性
- 网络依赖较重：FatSecret 要求 IP 白名单，强制依赖 wireproxy VPN（SOCKS5 代理），增加了部署复杂度
- 认证门槛：FatSecret 需开发者注册应用获取 API Key，对终端用户不够友好；OAuth1 流程虽被封装，仍比现代 OAuth2 繁琐
- 地域覆盖不均：FatSecret 以美国数据为主，欧洲产品依赖 Open Food Facts，亚洲及其他地区数据薄弱
- 写入功能受限：Open Food Facts 仅只读，无法贡献数据；FatSecret 日记写入需完整认证
- Token 失效风险：若用户撤销授权或配置损坏，需重新走完整认证流程
适合人群
- 使用 OpenClaw 代理自动管理饮食记录的健身/减脂用户
- 需要集成营养数据库的第三方应用开发者
- 欧美地区用户（尤其是有包装食品条码扫描需求）
- 对数据隐私敏感、希望自建数据管道的技术型用户
常规风险
- 隐私泄露：饮食记录包含敏感健康信息，本地 Token 和配置文件需妥善保管
- API 限制：FatSecret 免费套餐有调用频次限制，高并发场景可能受限
- 服务可用性：依赖 FatSecret 平台持续运营，存在第三方服务中断风险
- 数据准确性：营养数据库存在 crowdsourced 数据，部分条目可能不准确或缺失
- VPN 单点故障：wireproxy 配置错误将导致 FatSecret API 完全不可用