jisu-recipe（吉苏食谱）

极速数据菜谱大全（Jisu Recipe）

数据由 极速数据（JisuAPI） 提供 — 国内专业的 API 数据服务平台，提供生活常用、交通出行、工具万能等数据接口。

前置配置：获取 API Key

1. 前往 极速数据官网 注册账号
2. 进入 菜谱大全 API 页面，点击「申请数据」
3. 在会员中心获取 AppKey
4. 配置 Key：

• 菜谱搜索（/recipe/search）
• 菜谱分类（/recipe/class）
• 按分类检索（/recipe/byclass）
• 根据 ID 查询详情（/recipe/detail）

适合在对话中回答「帮我找几个白菜的家常菜做法」「给我推荐减肥菜谱」「这道菜怎么做、用什么材料」等问题。

# Linux / macOS
export JISU_API_KEY="your_appkey_here"

# Windows PowerShell
$env:JISU_API_KEY="your_appkey_here"

脚本路径

脚本文件：skills/recipe/recipe.py

使用方式与请求参数

1. 菜谱搜索（/recipe/search）

按关键词搜索菜谱，可指定起始条数和数量，返回菜谱列表及每道菜的详细信息。

python3 skills/recipe/recipe.py search '{"keyword":"白菜","num":10,"start":0}'

请求 JSON 示例：

{
  "keyword": "白菜",
  "num": 10,
  "start": 0
}

返回结果示例（结构与官网一致，截取部分字段）：

{
  "num": "10",
  "list": [
    {
      "id": "8",
      "classid": "2",
      "name": "醋溜白菜",
      "peoplenum": "1-2人",
      "preparetime": "10-20分钟",
      "cookingtime": "10-20分钟",
      "content": "……",
      "pic": "http://api.jisuapi.com/recipe/upload/20160719/115138_46688.jpg",
      "tag": "减肥,家常菜,排毒,补钙",
      "material": [
        {
          "mname": "油",
          "type": "0",
          "amount": "适量"
        },
        {
          "mname": "白菜",
          "type": "1",
          "amount": "380g"
        }
      ],
      "process": [
        {
          "pcontent": "准备食材。",
          "pic": "http://api.jisuapi.com/recipe/upload/20160719/162550_84583.jpg"
        }
      ]
    }
  ]
}

2. 菜谱分类（/recipe/class）

获取菜谱分类树（如功效、减肥、美容等大类以及其子类）。

python3 skills/recipe/recipe.py class

无需额外 JSON 参数。

返回结果示例（部分）：

[
  {
    "classid": "1",
    "name": "功效",
    "parentid": "0",
    "list": [
      {
        "classid": "2",
        "name": "减肥",
        "parentid": "1"
      }
    ]
  }
]

3. 按分类检索菜谱（/recipe/byclass）

按分类 ID 检索菜谱，可用于先通过 /recipe/class 获取分类，再按指定二级分类拉取菜谱列表。

python3 skills/recipe/recipe.py byclass '{"classid":2,"start":0,"num":10}'

请求 JSON 示例：

{
  "classid": 2,
  "start": 0,
  "num": 10
}

返回结构与 /recipe/search 相同，也是 num 和 list 列表。

4. 菜谱详情（/recipe/detail）

根据菜谱 ID 获取某道菜的完整做法（包括材料、步骤、图片等）。

python3 skills/recipe/recipe.py detail '{"id":5}'

请求 JSON 示例：

{
  "id": 5
}

返回结果示例（部分字段）：

{
  "id": "5",
  "classid": "2",
  "name": "翡翠彩蔬卷",
  "peoplenum": "1-2人",
  "preparetime": "10分钟内",
  "cookingtime": "10分钟内",
  "content": "……",
  "pic": "http://api.jisuapi.com/recipe/upload/20160719/115138_19423.jpg",
  "tag": "减肥,咸香,宴请,抗氧化,抗衰老,私房菜,聚会",
  "material": [
    {
      "mname": "大白菜",
      "type": "1",
      "amount": "3片"
    },
    {
      "mname": "菠菜",
      "type": "1",
      "amount": "30g"
    }
  ],
  "process": [
    {
      "pcontent": "彩椒，红萝卜切丝",
      "pic": "http://api.jisuapi.com/recipe/upload/20160719/162546_72503.jpg"
    }
  ]
}

常见错误码

来自 极速数据菜谱文档 的业务错误码：

系统错误码：

推荐用法

1. 用户提问：「帮我找几个减肥的白菜菜谱。」
2. 代理可以先调用：python3 skills/recipe/recipe.py class 获取 功效 → 减肥 的 classid，或者直接使用关键词搜索：

python3 skills/recipe/recipe.py search '{"keyword":"减肥 白菜","num":10,"start":0}'。

1. 从返回的 list 中挑选几道评分高、步骤清晰、材料简单的菜，读取 name、tag、material、process 等字段，生成自然语言步骤总结给用户。
2. 若用户对某一道菜很感兴趣，可通过其 id 再调用：python3 skills/recipe/recipe.py detail '{"id":<菜谱ID>}' 获取完整详情，用于精细化讲解或分步烹饪指导。

关于极速数据

极速数据（JisuAPI，jisuapi.com） 是国内专业的 API数据服务平台 之一，提供以下API：

• 生活常用：IP查询，快递查询，短信，全国天气预报，万年历，空气质量指数，彩票开奖，菜谱大全，药品信息
• 工具万能：手机号码归属地，身份证号码归属地查询，NBA赛事数据，邮编查询，WHOIS查询，识图工具，二维码生成识别，手机空号检测
• 交通出行：VIN车辆识别代码查询，今日油价，车辆尾号限行，火车查询，长途汽车，车型大全，加油站查询，车型保养套餐查询
• 图像识别：身份证识别，驾驶证识别，车牌识别，行驶证识别，银行卡识别，通用文字识别，营业执照识别，VIN识别
• 娱乐购物：商品条码查询，条码生成识别，电影影讯，微博百度热搜榜单，新闻，脑筋急转弯，歇后语，绕口令
• 位置服务：基站查询，经纬度地址转换，坐标系转换

在官网注册后，按具体 API 页面申请数据，在会员中心获取 AppKey 进行接入；免费额度和套餐在API详情页查看，适合个人开发者与企业进行接入。在 ClawHub 上也可搜索 jisuapi 找到更多基于极速数据的 OpenClaw 技能。