mcd-deal-hunter — скилл

---
name: mcd-deal-hunter
description: 麦当劳中国 MCP 的「券 × 商品」到手价优化器。给定想吃的餐品或想用的券，用 calculate-price 做带券/不带券的对照实验，算出真实净省金额与热量代价，输出三栏建议（纯省钱 / 性价比 / 劝退）。Use when 用户问「有什么券能用」「怎么点最便宜」「帮我用券」「这单能省多少」，或在麦当劳下单前想确认优惠是否划算。只做建议，绝不下单或付款。
---

# 券的价值换算

核心洞察：**券本身不含价格。**

`query-store-coupons` 只给 `couponId`、`couponCode`、有效期 `tradeDateTime` 和适用商品 `products[].productCode` —— **没有折扣金额**。`title` 是活动名（实测值为「1024"码"力翻倍」），既不是商品名也不是价格。

因此「省多少钱」只有一个可靠来源：`calculate-price` 带券与不带券的**差值**。禁止用券标题、常识或历史价格推断金额。

## 数据源职责

| 工具 | 给什么 | 陷阱 |
|---|---|---|
| `auto-bind-coupons` | 一键领光麦麦省全部可领券 | 零成本写操作，先领再谈；不要循环调用 |
| `available-coupons` | 可领取券的标题 / 状态 / 图片 | **无 `couponId`**，不能直接用于下单 |
| `query-my-coupons` | 卡包里的全部券 | **不承诺本店本单可用**，不可作为选券依据 |
| `query-store-coupons` | 本店 + 本取餐方式的可用券，含 `couponId` / `couponCode` / 有效期 / `products[]` | 无金额，必须过 `calculate-price` |
| `calculate-price` | 唯一的价格真相 | 金额单位是**分**；对不可售/虚拟 `productCode` 会**静默返回 `price=0` 且 `success:true`**；每次调用计入 600 次/分钟限额 |

选券只认 `query-store-coupons`。用它之外的券去跑价格，会在 `calculate-price` 处失败。

## 流程

1. **定渠道**（决定 `orderType` / `beCode`，详见 `references/ordering.md`）
2. **拿门店**：自取 / 得来速用 `query-nearby-stores`；外送 / 团餐走 `delivery-query-addresses` → `delivery-query-stores`。收藏门店为空会返回 `600050`，改用 `searchType=2` 并索取城市 + 关键词。
3. **领券**：`auto-bind-coupons`
4. **取可用券**：`query-store-coupons(storeCode, orderType, beType)`
5. **取菜单**：`query-meals(storeCode, orderType, beType[, beCode])`，用 `productCode` 对齐
6. **匹配**：券的 `products[].productCode` ↔ 菜单商品 ↔ 用户想吃的。注意券经常把商品锁成一个**套餐**——此时要么引导用户改买，要么直接说这张券用不上
7. **对照实验**：同一购物车跑两次 `calculate-price`，基线（不带券）与带券，差值即净省
8. **输出**，然后停下等用户确认

## 输出（面向用户）

只回答三件事：这单多少钱、怎么更省、代价是什么。**第一句就给实付价**，不铺垫。

```
1. 纯省钱   <方案>   省 X 元    Y kcal
2. 性价比   <方案>   省 X 元    Z 元/100kcal
3. 劝退     <方案>   省 X 元    但 +N kcal ≈ M 碗米饭
```

第三栏是本 skill 的重点：**免费券只免钱，不免热量**。

### 不许出现在回答里