核心用法
Cookidoo Skill 是一款面向美善品（Thermomix）用户的食谱管理工具，通过调用非官方 Python 包 cookidoo-api 与 Cookidoo 服务平台交互。用户配置邮箱、密码及可选的区域语言参数后，即可执行六大核心任务：浏览已保存食谱、获取每周膳食计划、导出购物清单、搜索特定食谱、查看详细食谱信息，以及查询账户状态。所有操作均支持 --json 结构化输出与 --limit 结果限制，便于与其他自动化工具链集成。
显著优点
生态整合能力突出：Skill 设计之初即考虑与第三方应用（如 Bring! 购物清单）的打通潜力，支持食材数据的标准化导出，为跨平台膳食管理提供基础设施。交互简洁直观：命令行接口设计遵循 Unix 哲学，单命令即可完成复杂查询，降低学习成本。凭证管理安全：敏感信息通过环境变量或独立配置文件隔离，无硬编码风险，符合安全开发规范。区域化支持完善：默认德国区域配置的同时支持多国多语言切换，适应全球化用户需求。
潜在缺点与局限性
依赖非官方 API 的固有脆弱性：cookidoo-api 为社区逆向工程成果，非 Vorwerk 官方维护。Cookidoo 服务端任何接口变更都可能导致功能断裂，且修复时效取决于社区维护者响应速度。订阅门槛限制：功能完全依赖活跃的 Cookidoo 付费订阅，未订阅用户无法使用核心服务。数据隐私跨境传输：用户凭证、食谱偏好及购物行为数据需传输至 Cookidoo 服务器（总部位于德国），对数据本地化有严格要求的场景需谨慎评估。功能深度有限：当前仅覆盖读取类操作，无法实现食谱收藏管理、购物清单编辑等写入型交互。
适合的目标群体
美善品设备深度用户：已建立 Cookidoo 使用习惯、依赖平台食谱库进行日常烹饪规划的家庭厨师。智能家庭自动化爱好者：希望将膳食规划纳入 Home Assistant、Node-RED 等自动化工作流的极客用户。多应用协同需求者：需要在 Cookidoo 与 Bring!、Notion、日历应用等之间手动同步购物清单的效率追求者。健康饮食规划者：关注时令食材推荐、希望基于现有食材反向搜索食谱的营养管理用户。
使用风险说明
依赖包维护风险：cookidoo-api 当前 GitHub 可见且 PyPI 可安装，但社区维护项目存在长期弃用可能。建议用户在使用前验证包可用性，并关注仓库更新动态。凭证泄露风险：配置文件以明文存储密码，若多用户共享设备或备份策略不当，存在非授权访问可能。务必设置 600 文件权限，避免提交至版本控制。网络可用性风险：API 调用无超时配置，弱网环境下可能长时间挂起。服务条款合规风险：非官方 API 使用可能违反 Cookidoo 用户协议，存在账号限制或封禁的理论可能，建议控制调用频率，避免高频自动化请求。