Clawdbot Skill Cookidoo

🍳 Thermomix 食谱与购物清单同步助手

通过非官方 API 连接 Thermomix Cookidoo,管理食谱、购物清单与每周膳食计划,支持 JSON 输出及 Bring! 集成

收藏
7.7k
安装
2.5k
版本
1.0.0
CLS 安全性认证2026-08-10
点击查看完整报告 >

使用说明

核心用法

Cookidoo 技能通过 Python 的 cookidoo-api 库(非官方)提供对 Vorwerk Thermomix 官方 Cookidoo 平台的访问能力。用户可通过 CLI 脚本完成以下操作:

  • 用户账户信息查询:验证登录状态与账户详情
  • 食谱浏览:查看收藏夹、自定义合辑(collections)及每周推荐
  • 购物清单管理:提取当前购物清单中的全部食谱及对应食材
  • 数据导出--json 参数支持机器可读格式,便于与其他工具链集成
  • 跨平台同步:与 bring-shopping 技能配合,可将 Cookidoo 食材一键导入 Bring! 购物应用

配置要求

需设置邮箱、密码、国家及语言环境变量(或配置文件),依赖 cookidoo-apiaiohttp 两个 Python 包。

---

显著优点

1. 生态打通:填补了 Thermomix 官方生态缺乏开放 API 的空白,实现与 Bring! 等第三方购物工具的联动
2. 自动化潜力:JSON 输出格式支持脚本化批处理,适合 meal-prep 自动化工作流

3. 轻量部署:纯 Python 实现,无复杂基础设施依赖

---

潜在缺点与局限性

| 维度 | 说明 |
|------|------|
| **API 稳定性** | 非官方逆向工程,Cookidoo 服务端更新可能导致功能中断 |
| **订阅门槛** | 必须持有有效的 Cookidoo 订阅方可使用 |
| **功能边界** | 仅支持读取操作(查看、导出),无法创建食谱或修改购物清单 |
| **地域限制** | 国家/语言代码需与 Cookidoo 区域设置匹配,配置错误会导致内容异常 |

---

适合人群

  • Thermomix TM6/TM5 用户且订阅 Cookidoo 服务
  • 希望将官方食谱生态与 Bring!/AnyList 等购物 App 打通的效率工具爱好者
  • 有基础 Python/CLI 操作能力,能接受非官方 API 风险的进阶用户

---

常规风险

1. 账户安全风险:凭证以明文环境变量或 .env 文件存储,若误提交至版本控制可能导致泄露
2. 服务可用性风险:依赖个人开发者维护的第三方库(miaucl/cookidoo-api),更新频率与长期维护不确定

3. ToS 合规风险:使用非官方 API 可能违反 Vorwerk 服务条款,极端情况下或导致账户限制

4. 数据隐私:食谱偏好与购物习惯数据经由第三方库传输,未明确审计日志保留策略

安全解读

核心用法

Cookidoo Skill 是一款面向 Thermomix(美善品)用户的食谱管理工具,通过非官方的 cookidoo-api Python 库与 Vorwerk 官方 Cookidoo 服务交互。用户需先安装 cookidoo-apiaiohttp 依赖,并通过环境变量或 ~/.config/atlas/cookidoo.env 配置文件提供 Cookidoo 账户凭证。

该 Skill 提供四大核心功能模块:用户信息查询(info)、购物清单食谱浏览(shopping)、食材清单导出(ingredients)以及自定义收藏夹管理(collections)。所有命令均支持 --json 参数输出机器可读格式,便于与其他工具链集成。特别值得一提的是,该 Skill 可与 bring-shopping Skill 配合使用,将 Cookidoo 食材清单自动同步至 Bring! 购物应用,实现从食谱规划到采购执行的全流程自动化。

显著优点

官方服务依赖背书:核心依赖 cookidoo-api 由 miaucl 维护,已被 Home Assistant 官方 Cookidoo 集成采用,社区认可度和代码质量有充分保障。

网络行为高度可控:所有请求均定向至 cookidoo.{country} 官方域名,采用 TLS 1.2+ 加密传输,无第三方数据中转或遥测行为,用户隐私得到充分保护。

集成生态友好:JSON 输出模式与 Bring! 购物清单 Skill 的联动设计,体现了良好的模块化思维,适合构建个人食谱管理工作流。

凭证管理规范:支持环境变量与配置文件双模式,无硬编码密钥,符合安全运维最佳实践。

潜在缺点与局限性

非官方 API 风险:依赖的 cookidoo-api 为社区逆向工程实现,非 Vorwerk 官方支持。Cookidoo 平台的服务端更新可能导致 API 失效,存在功能性中断风险。

订阅门槛限制:需用户持有有效的 Cookidoo 付费订阅方可使用,免费用户无法获取完整功能。

地域与语言绑定:默认配置针对德语区(de/de-DE),其他国家和地区用户需手动配置 COOKIDOO_COUNTRYCOOKIDOO_LANGUAGE 参数。

功能边界明确:仅支持读取类操作(查询食谱、导出清单),无法实现食谱收藏同步、购物清单编辑等写入操作。

适合的目标群体

  • Thermomix TM6/TM5 活跃用户:已订阅 Cookidoo 服务,希望将数字食谱与日常采购流程打通
  • 智能家居集成爱好者:使用 Home Assistant 等平台,追求跨应用数据自动化的技术用户
  • 效率导向的家庭管理者:需要批量导出食材清单、规划周餐食的营养师或家庭主理人
  • Python 自动化玩家:具备基础脚本能力,希望构建个性化食谱管理工具链的开发者

使用风险与建议

API 稳定性风险:建议用户关注 cookidoo-api 库的 GitHub 仓库更新,在 Cookidoo 服务异常时及时排查是否为 API 变更所致。

凭证泄露防护:配置文件建议设置 Unix 权限 600(chmod 600 ~/.config/atlas/cookidoo.env),避免多用户环境下敏感信息暴露。

依赖版本管理:当前未提供 requirements.txt 版本锁定,建议用户手动指定 cookidoo-apiaiohttp 的兼容版本,防止自动更新引入破坏性变更。

订阅续费提醒:Cookidoo 订阅到期将导致 Skill 功能完全失效,建议设置订阅到期提醒,避免中断使用体验。

Clawdbot Skill Cookidoo 内容

scripts文件夹
手动下载zip · 3.4 kB
cookidoo_cli.pytext/plain
请选择文件