基于 Gousto 官方 API 的食谱搜索工具,支持 9,000+ 菜谱本地缓存与快速检索,为烹饪爱好者提供即查即用的食材清单与分步指导。
说明:
## 核心用法
Gousto Recipe Skill 是一款命令行食谱查询工具,通过调用 Gousto 官方公开 API,实现 9,000+ 菜谱的搜索与浏览。首次使用需运行 `./scripts/update-cache.sh` 构建本地缓存(约 3 分钟),后续搜索通过 `./scripts/search.sh >` 在本地瞬时完成,获取完整食谱则使用 `./scripts/recipe.sh >` 从官方 API 拉取食材清单与烹饪步骤。
## 显著优点
1. **极速本地搜索**:基于 jq 的本地 JSON 过滤,无需网络即可秒级检索海量菜谱
2. **数据权威可靠**:直接对接 Gousto 官方 API,食谱信息包含评分、备餐时长、营养数据等完整元数据
3. **轻量无依赖**:仅依赖 curl 与 jq 两个标准系统工具,无复杂运行时或第三方库
4. **透明可审计**:纯 Shell 脚本实现,代码简洁可读,安全行为完全透明
## 潜在缺点与局限性
– **首次启动成本**:必须联网构建缓存,初始等待约 3 分钟
– **离线功能受限**:获取完整食谱详情仍需网络连接,非完全离线可用
– **数据时效性**:本地缓存需手动更新,可能无法实时反映 Gousto 平台最新菜谱
– **功能边界明确**:仅支持公开 API 的只读访问,无法获取付费会员专属内容或个性化推荐
## 适合的目标群体
– 命令行爱好者与效率工具用户
– 需要快速查询菜谱食材与步骤的家庭烹饪者
– 构建 AI Agent 或自动化工作流的开发者(OpenClaw 兼容)
– 对数据隐私敏感、希望避免使用商业 App 的用户
## 使用风险
– **网络依赖**:API 访问受 Gousto 服务端可用性影响,存在单点故障风险
– **缓存一致性**:长期不更新缓存可能导致搜索结果与官网不一致
– **API 变更风险**:Gousto 官方 API 接口调整可能导致功能失效,需关注上游更新








