Recipes

核心功能

recipes 是一款面向AI Agent的轻量级食谱查询命令行工具，封装了TheMealDB免费API，支持零认证调用。核心能力包括：

• 智能搜索：通过关键词（食材/菜名）检索食谱，返回ID与基础信息
• 详情获取：通过Meal ID拉取完整配方，含食材清单、烹饪步骤、视频链接
• 随机推荐：解决"今晚吃什么"的决策疲劳
• 按菜系探索：覆盖29种全球 cuisine（意式、墨西哥、泰式等）

显著优点

1. 零门槛接入：无需API Key或账户注册，curl + jq即可运行
2. 结构化输出：食材清单与步骤分离，便于Agent解析执行
3. 多维度检索：支持模糊搜索、精确ID查询、分类浏览三种模式
4. 人类友好：输出格式含emoji分隔，YouTube视频链接增强可操作性

局限性与风险

| 局限 | 说明 |

|------|------|

| 数据深度不足 | API不提供营养信息、卡路里、过敏原标注 |

| 饮食限制支持 | 无法满足素食、清真、生酮等特定饮食需求 |

| 数据源单一 | 依赖TheMealDB，食谱覆盖度与更新频率受限 |

| 网络依赖 | 纯在线工具，无离线缓存机制 |

适用人群

• 家庭场景AI助手（智能音箱、家居中控）
• 需要快速食谱查询的Agent工作流
• 厨艺初学者探索全球菜系

安全与合规

• 数据来源：TheMealDB为公开食谱聚合站，内容非医疗/营养专业建议
• 隐私：无用户数据收集，纯匿名API调用
• 风险提示：输出内容可能含未标注的常见过敏原，敏感人群需二次确认

核心用法

该 Skill 为 AI Agent 提供命令行食谱查询能力，通过调用 TheMealDB 免费 API 实现。主要功能包括：按食材或菜名搜索食谱（recipes search）、按 ID 获取完整食谱详情含配料和步骤（recipes info）、随机推荐菜品（recipes random）、按地区菜系筛选（recipes area）以及浏览全部分类（recipes categories）。输出格式清晰，包含食材清单、烹饪步骤、视频链接等完整信息，支持 28 种国际菜系查询。

显著优点

零门槛使用：无需注册账号或 API 密钥，开箱即用。CLI 设计简洁直观，适合集成到自动化工作流中。数据丰富：覆盖全球主流菜系，从美式到越南菜，满足多样化饮食需求。输出友好：结构化展示食材用量、分步说明，部分食谱附带 YouTube 视频教程。轻量依赖：仅依赖 bash、curl、jq 等标准工具，无复杂运行时要求。开源免费：MIT 许可证，可自由修改和扩展。

潜在缺点与局限性

功能单一：仅提供基础食谱查询，不包含营养信息、卡路里计算、过敏原标注或饮食限制筛选（如素食、无麸质），无法满足健康管理需求。数据来源依赖：完全依赖 TheMealDB 的公开数据质量和可用性，若 API 服务中断或限流则无法使用。交互体验有限：纯 CLI 输出，无图形界面或收藏、计划餐单等进阶功能。外部代码风险：Skill 本身为文档包，实际可执行代码托管于外部 GitHub 仓库，存在供应链安全风险。

适合的目标群体

家庭烹饪爱好者：需要快速获取家常菜灵感和详细做法。AI Agent 开发者：为智能助手集成食谱查询能力，响应"今晚吃什么"类自然语言请求。内容创作者：美食博主、视频创作者需要查询多菜系菜品作为选题参考。轻量自动化场景：希望在脚本或工作流中嵌入随机菜品推荐功能的用户。

使用风险

供应链安全风险：该 Skill 本质为文档引用包，实际执行的 bash 脚本来自外部个人开发者仓库（jeffaf/recipes-skill），存在代码注入、恶意功能植入可能，使用前需单独审查。隐私合规风险：虽然当前版本不收集用户数据，但外部代码的行为无法完全保证，建议在隔离环境中运行。网络可用性风险：依赖 TheMealDB 第三方服务，无 SLA 保障。维护风险：个人开发者项目（T3 来源）存在弃坑、账号被盗、维护中断等不确定性。建议以非特权用户运行，监控网络请求，定期关注仓库更新动态。