核心用法
jisu-recipe 是基于极速数据菜谱大全 API 的 OpenClaw 技能,提供四大核心能力:
1. 菜谱搜索(/recipe/search):按关键词检索菜谱,支持分页控制
2. 菜谱分类(/recipe/class):获取功效、减肥、美容等分类树结构
3. 按分类检索(/recipe/byclass):通过分类ID拉取特定类别菜谱
4. 菜谱详情(/recipe/detail):根据菜谱ID获取完整做法、材料清单和步骤图解
典型交互流程:用户提出「帮我找减肥白菜做法」→ 代理调用搜索或分类接口 → 解析返回字段(name/tag/material/process)→ 生成自然语言烹饪指导 → 可选调用详情接口进行分步讲解。
显著优点
- 数据覆盖较全:菜谱分类体系包含功效、场景、口味等多维度标签
- 字段结构化:材料用量、准备时间、烹饪时间、步骤图解均有独立字段,便于AI解析重组
- 中文场景优化:API设计和示例均以中文菜谱为核心,本土化程度高
- 调用方式灵活:支持关键词模糊匹配与分类精确筛选两种检索路径
潜在局限
- 依赖外部API:需单独申请极速数据 APPKEY,存在服务可用性风险
- 数据质量不可控:菜谱内容由第三方平台聚合,可能存在步骤描述不规范、图片链接失效等问题
- 无用户偏好学习:当前版本不支持收藏历史、口味偏好等个性化数据积累
- 配额限制:免费/付费套餐均有调用次数上限,高并发场景需关注错误码104、106
适合人群
- 智能家居/语音助手开发者,需快速集成菜谱问答能力
- 健康饮食类应用,需要结构化菜谱数据进行营养分析或推荐
- 烹饪教学场景,需要图文并茂的步骤拆解素材
常规风险
- API密钥泄露:JISU_API_KEY 需妥善保管,避免硬编码提交至版本控制
- 内容合规风险:菜谱标签含「减肥」「排毒」等健康声明,需符合广告法及医疗内容规范
- 服务稳定性:错误码107(接口维护)、108(接口停用)提示存在服务中断可能,生产环境建议实现降级策略
- 数据准确性:材料用量标注「适量」等模糊描述,自动化营养计算时需人工校验