豆果美食菜谱大全:给 Agent 接上菜谱检索能力

前言

给 Agent 加「今天吃什么」「这道菜怎么做」这类问题时,通常有两个绕不过的选择:自己去爬菜谱站点,或者接一个搜索 API。前者要维护页面结构和反爬规则,后者要申请账号、管理密钥和额度。下面介绍的这个 Skill 走的是第三条路:它把豆果美食的菜谱检索封装成一个 SKILL.md 格式的技能,Agent 只要按技能声明调用,就能按菜名、食材或菜系拿到结构化的菜谱结果,不需要自己写爬虫。

这是什么

「豆果美食菜谱大全」是一个社区来源(source: community)的 Skill,坐标 @user_aa2ec429/douguo-mcp,当前版本 1.0.4,发布者为 user_aa2ec429,归在 life-service 分类下。它解决的问题很单一:把「找菜谱、看做法」这个动作变成 Agent 可以稳定调用的技能,而不是每次都靠模型凭空生成。

它不需要 API Key(标签 requires_api_key=false),也就是说在依赖层面没有额外的鉴权前置条件。

核心功能

根据官方简介,这个 Skill 的能力范围如下。

1、菜谱搜索。在用户搜索菜谱、查询菜品做法时触发,支持按菜名搜索。
2、食材找菜。根据用户手头有的食材,推荐可做的菜品。
3、按菜系检索。支持按菜系分类搜索。
4、菜谱详情。可以查看完整菜谱详情,包含食材、步骤、烹饪时间、难度。

触发词为:搜菜谱、怎么做菜、豆果美食、菜谱搜索、找菜谱、recipe search、有什么好吃的。在 Agent 侧做意图匹配时,这些词可以直接作为路由依据。

安装与启用

官方地址为 https://api.skillhub.cn/user_aa2ec429/douguo-mcp ,SkillHub 页面为 https://www.skillhub.cn/skills/user_aa2ec429/douguo-mcp 。

需要说明的是:本次核对时,上述两个页面均无法正常打开,已抓取资料里也没有提供具体的安装命令、配置文件路径或各 Agent 工具(Cursor、Codex CLI、Claude Code)的差异说明。因此这里不给出未经核实的命令。实际使用时,请以官方页面或 SkillHub 页面当前展示的安装方式为准,不要把下面的地址当作可执行指令直接粘贴。

启用方式上,既然它遵循通用 SKILL.md 格式,通常的做法是把技能声明挂载到 Agent 的技能目录下,由 Agent 在运行时按触发词加载。具体目录约定取决于你所用的 Agent 运行时,建议对照官方文档确认。

典型用法

从官方简介还原的典型调用场景如下,实际参数名以技能声明为准。

# 场景一:按菜名找做法
用户:「红烧肉怎么做」
匹配触发词:怎么做菜 / 菜谱搜索
结果:返回菜谱详情(食材、步骤、烹饪时间、难度)

# 场景二:按食材反推菜品
用户:「家里有西红柿和鸡蛋,能做什么」
匹配触发词:有什么好吃的
结果:按食材搜索并推荐菜品

# 场景三:按菜系浏览
用户:「有什么川菜」
匹配触发词:找菜谱
结果:按菜系分类搜索

这三个场景覆盖了简介里列出的三类搜索入口,可以作为接入后的自测用例。

适用场景与注意

适合的场景:做菜谱类助手、厨房类工具、需要「根据现有食材给建议」的对话机器人,以及想在 Agent 里补充生活服务类检索能力、又不想自建数据源的开发者。

需要注意的几点。

1、数据依赖豆果美食。搜索结果的范围和质量受上游菜谱库约束,模型自己生成的做法和它返回的做法可能是两套来源,混用时要在输出上做区分。
2、触发词偏中文口语。recipe search 是唯一的英文触发词,如果面向英文用户,覆盖会很有限。
3、当前版本的热度数据:评分 100000,下载 686,安装 0。安装数为 0 意味着公开可查的使用样本很少,接入前建议自己先跑一遍上面的三个场景。
4、官方简介中未说明调用频率限制、返回字段的完整 schema 和错误码,这些需要在首次接入时实测确认。

结尾

这个 Skill 的价值在于把菜谱检索这件具体的事封装成一个可直接加载的技能:三类搜索入口加详情查看,不依赖 API Key,接入成本比自建爬虫低得多。适合作为生活服务类 Agent 的一个补充模块,但不适合当作通用菜谱知识库——它管的是检索,不管知识。

官方地址:https://api.skillhub.cn/user_aa2ec429/douguo-mcp

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

Xiaoye