SuperAPI AI 工具集

swiggy-mcp-instamart

办公与效率

查看项目

更新于 10-15 22:13

技能介绍

用途:帮助用户在 Swiggy Instamart 上完成杂货购物,覆盖从选地址到下单跟踪的完整流程。

主要能力与流程:get_addresses → your_go_to_items 或 search_products → update_cart → get_cart → list_coupons/apply_coupon → get_payment_options → checkout → track_order。get_addresses 只需调用一次,之后每次搜索都要传 addressId,因为库存与服务范围按地址判定;无合适地址时用 create_address(只需完整地址、姓名、电话、类别,不需要坐标)。老用户可先用 your_go_to_items { addressId } 复购,一次调用可替代 3–5 次搜索。

关键规则:search_products { addressId, query } 返回带 variations[] 的商品,购物车使用 variation 的 spinId(加 skuId),不能用 productId;提供前检查 isInStockAndAvailable 与 maxQuantity;可用 nextOffset 分页。update_cart 会整体替换购物车,必须提交用户想要的全部商品;加一件商品需先 get_cart 合并后发送完整列表;响应中的 removedOutOfStockItems 与 reducedQuantityItems 要逐项告知原因。每次变更后用 get_cart 展示 items[]、billBreakdown.toPay、unserviceableItems、cartWarning,结账前再读一次。购物车绑定配送地址,不可中途换地址,需先 clear_cart 再在新地址重建。优惠券用 list_coupons { addressId } 与 apply_coupon { couponCode }(不区分大小写),优惠金额只以返回的购物车为准;这两个工具与 get_order_details 按账号灰度,若工具列表中没有则如实说明。

结账与支付:结账前需说明商品、billBreakdown.toPay、确切配送地址、支付方式,若跨多店需提示“购物车含 N 家店商品,Swiggy 将按店分别创建订单”,并询问“是否确认下单到此地址?”等待明确同意。最低订单 ₹99。checkout { addressId, paymentMethod?, intentApp?, generateUPIQR? } 中 paymentMethod 是分组值("UPI"、"Cash"/"COD"、"SwiggyPay"),不是应用 id;应用 id 放在 intentApp 并配 paymentMethod: "UPI"。现金支付即下单成功,使用原文消息;UPI 返回 PENDING_PAYMENT,尚未下单,需转 swiggy-mcp-payments。多店结果按订单分别报告。

跟踪与取消:track_order { orderId, lat, lng } 必须提供坐标,遵守 pollingIntervalSeconds,不得快于 10 秒;get_delivery_status { orderId, addressId } 获取结构化 ETA;历史用 get_orders,详情用 get_order_details。取消无对应工具,需提示拨打 Swiggy 客服 080-67466729。

失败处理:缺货则重新搜索替代品;地址不可服务则换地址或改用 Food 配送;未达最低金额则请用户加购;购物车过期则按用户确认清单重建并再次确认;checkout 出现 5xx 时先 get_orders { activeOnly: true } 再重试。

限制:部分工具按账号灰度;UPI 支付不会立即下单;坐标、地址与库存均依赖上下文,缺失事实暂未提供。