Swiggy 技能

通过 Swiggy 的 MCP 服务器，在印度订购餐食、杂货，并预订餐厅。

安装

该技能包含一个 swiggy CLI 可执行文件。安装技能后：

cd skills/swiggy
npm link

这将创建一个全局可用的 swiggy 命令。可通过 which swiggy 验证是否安装成功。

适用场景

• 外卖订餐：例如“点一份 Biryani”、“附近哪些店营业到很晚？”、“为 8 人安排团队午餐”
• 杂货采购（Instamart）：例如“买鸡蛋和牛奶”、“本周日常杂货”、“某道菜所需的食材”
• 餐厅预订（Dineout）：例如“预订本周六晚上 8 点的晚餐”、“科拉曼加拉（Koramangala）的意大利餐厅”

可用命令

外卖订餐

# 搜索餐厅
swiggy food search "biryani" --location "Koramangala, Bengaluru"

# 查看菜单
swiggy food menu 

# 购物车管理
swiggy food cart add  --quantity 2
swiggy food cart show
swiggy food cart clear

# 下单（需用户确认）
swiggy food order --address "home" --confirm

Instamart（杂货采购）

# 搜索商品
swiggy im search "eggs" --location "HSR Layout, Bengaluru"

# 购物车操作
swiggy im cart add  --quantity 3
swiggy im cart show
swiggy im cart clear

# 结账（需用户确认）
swiggy im order --address "home" --confirm

Dineout（餐厅预订）

# 搜索餐厅
swiggy dineout search "Italian Indiranagar"

# 获取详情
swiggy dineout details 

# 查询可预订时段
swiggy dineout slots  --date 2026-01-30

# 预订座位（仅支持免费预订，且需用户确认）
swiggy dineout book  --date 2026-01-30 --time 20:00 --guests 2 --confirm

重要安全规则

⚠️ 绝不允许自动下单

下单前必须获得用户的明确确认。

1. 首先展示购物车预览：

   • 所有商品及其数量与单价
   • 订单总金额
   • 配送地址
   • 预计送达时间（适用于外卖与杂货）

2. 向用户请求确认：

   准备下单：
   - 2x Chicken Biryani（₹500）
   - 1x Raita（₹60）
   总计：₹560 + 配送费
   配送至：Home（HSR Layout）
   预计送达时间：30–40 分钟
   
   确认下单？（yes/no）
   

3. 仅当用户明确回答 YES 后才执行：

   • 使用 --confirm 参数运行下单命令
   • 将订单记录写入 memory/swiggy-orders.json

COD 提示

当前 Swiggy MCP 仅支持货到付款（Cash on Delivery）。订单一旦提交即不可取消。请务必在确认前仔细核对全部信息。

地址处理

• 用户可能使用“home”、“office”等简称——需映射为 USER.md 中的实际地址，或主动向用户询问
• 预览阶段必须再次确认配送位置
• 对于 Dineout，地址仅用于搜索（不涉及配送）

工作流示例

外卖订餐流程

# 1. 搜索餐厅
swiggy food search "biryani near Koramangala"

# 2. 浏览菜单（使用上一步返回的 restaurant ID）
swiggy food menu rest_12345

# 3. 加入购物车
swiggy food cart add item_67890 --quantity 1

# 4. 预览购物车
swiggy food cart show

# 5. 向用户展示预览内容，并请求确认

# 6. 若获确认，则执行下单
swiggy food order --address "HSR Layout, Sector 2, Bengaluru" --confirm

杂货采购流程

# 1. 搜索商品
swiggy im search "eggs" --location "Koramangala"
swiggy im search "milk" --location "Koramangala"

# 2. 加入购物车
swiggy im cart add item_11111 --quantity 2
swiggy im cart add item_22222 --quantity 1

# 3. 预览购物车
swiggy im cart show

# 4. 与用户确认

# 5. 结账
swiggy im order --address "Koramangala, Bengaluru" --confirm

餐厅预订流程

# 1. 搜索餐厅
swiggy dineout search "Italian Indiranagar"

# 2. 查看详情
swiggy dineout details rest_99999

# 3. 查询可预订时段
swiggy dineout slots rest_99999 --date 2026-01-30

# 4. 向用户展示可选时段并确认选择

# 5. 执行预订
swiggy dineout book rest_99999 --date 2026-01-30 --time 20:00 --guests 2 --confirm

错误处理

• 无搜索结果：建议扩大关键词范围或更换地理位置
• 缺货：提供替代商品选项
• 无可预订时段：推荐其他时间段或日期
• 需要身份验证：用户需通过 OAuth 完成认证（由 MCP 自动处理）

使用技巧

• 团队订餐：逐步构建购物车，适时征求成员偏好
• 预算型采购：按价格筛选结果，并实时显示累计金额
• 菜谱转购物车：逐项搜索所需食材，并分步加入购物车
• 深夜订餐：在搜索条件中注明“深夜”或“late night”，以便优先匹配营业至较晚的商家

订单日志记录

订单成功提交后，向 memory/swiggy-orders.json 追加一条记录：

{
  "timestamp": "2026-01-28T21:16:00+05:30",
  "type": "food",
  "items": [...],
  "total": "₹560",
  "address": "HSR Layout",
  "orderId": "..."
}

身份认证

Swiggy MCP 使用 OAuth 认证机制。首次使用时将自动触发授权流程。swiggy CLI 通过 mcporter 实现该流程。

依赖项

• 依赖 mcporter 技能（底层调用）
• CLI 封装层需 Node.js 运行环境

已知限制

• 仅支持货到付款（暂不支持在线支付）
• 订单提交后不可取消
• Dineout 功能仅支持免费预订
• 使用 MCP 期间请勿手动打开 Swiggy App（可能导致会话冲突）

切记：每次下单前，必须获得用户确认。每一次。都必须。