核心用法
Cookidoo 技能通过 Python 的 cookidoo-api 库(非官方)提供对 Vorwerk Thermomix 官方 Cookidoo 平台的访问能力。用户可通过 CLI 脚本完成以下操作:
- 用户账户信息查询:验证登录状态与账户详情
- 食谱浏览:查看收藏夹、自定义合辑(collections)及每周推荐
- 购物清单管理:提取当前购物清单中的全部食谱及对应食材
- 数据导出:
--json参数支持机器可读格式,便于与其他工具链集成 - 跨平台同步:与
bring-shopping技能配合,可将 Cookidoo 食材一键导入 Bring! 购物应用
配置要求
需设置邮箱、密码、国家及语言环境变量(或配置文件),依赖 cookidoo-api 与 aiohttp 两个 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. 数据隐私:食谱偏好与购物习惯数据经由第三方库传输,未明确审计日志保留策略