为什么没人算出你白扔了多少钱?mcd-coupon-strategist 的券沉默成本概念与量化方法
为什么没人算出你白扔了多少钱?mcd-coupon-strategist 的券沉默成本概念与量化方法
市面上大多麦当劳省钱工具只能回答「这一单怎么点最省」,却从没人算过你正在白扔多少钱。mcd-coupon-strategist(麦麦省钱助手)是一个基于麦当劳官方 MCP 的点餐成本优化 Skill,它提出了「券的沉默成本」这一概念,把即将过期的优惠券量化成正在流失的钱,并给出三步可执行的挽损方法。本文用真实数据带你拆解这套量化方法。
什么是「券的沉默成本」?一个没人告诉你的隐形损失
想象这样一个场景:你的麦当劳卡包里躺着 9 张优惠券,其中 3 张明天到期、4 张本周到期——而它们没有任何推送提醒。到期那天,它们悄悄从卡包里消失,就像从来没存在过。
这笔钱既不是消费,也不是退款,它无声无息地蒸发了,这就是「券的沉默成本(Coupon Silent Cost)」:
你手里即将过期却没用掉的券,面值合计就是正在流失的钱。
它和「这一单省几块钱」有本质区别:
| 对比项 | 单次省钱 | 券的沉默成本 |
|---|---|---|
| 影响范围 | 只影响当前这一单 | 持续性的、逐日发生的 |
| 钱的性质 | 收益(省下的) | 损失(白扔的) |
| 工具覆盖 | 多数省钱工具都能做 | 几乎没有工具在算 |
行为经济学里有个经典结论:人对损失的敏感度是对收益的两倍。一次省 13 元很爽,但眼睁睁看着 21 元随券作废更让人难受——可惜这个数字,从来没人替你算过。
mcd-coupon-strategist 把「算清这个数」作为核心指标,实现位于 src/auditor.py 的 coupon_silent_cost() 函数。
量化方法第一步:把「快过期的券」从卡包里捞出来
沉默成本要成立,先要知道哪些券在倒计时。这一步的数据来自两个 MCP 工具:
query-my-coupons:你卡包里持有的全部券(含时段、渠道限制)order-list:历史订单(用于后续的消费基准)
这里有一个新手最容易踩的坑:统计口径。项目实测发现,「当前门店可用券」接口只返回 2 张,而卡包实际持有 9 张——差出来的 7 张,全是即将过期的早餐券。拿门店口径算沉默成本,会整整漏掉一半的损失。所以沉默成本必须按「卡包持有」口径计算,这个细节也记录在 fixtures/my_coupons.md 的数据说明里。
量化规则很直白(见 src/auditor.py 的 is_expiring_soon()):
- 已过期 → 钱已经扔掉了,单独列出;
- 今天到期 → 最紧迫,单独强调;
- 7 天内到期 → 计入「白扔风险」,按剩余天数排序,最紧的排前面。
另外还有一层诚实:如果某张券的面值算不出来(后面会讲为什么),会明确标注「价值未知」并计入张数,绝不让它们在汇总里隐身——否则你会误以为「处理完 21.1 元就完事了」。
量化方法第二步:每张券到底值多少钱?
「9 张券即将过期」还不够扎心,得知道每张值多少钱。难点在于:MCP 返回的券通常只有名字,没有面值:
「中薯条买一送一」 → 值多少钱?
「9.9元中杯冰美式」 → 值多少钱?
「王牌小食拼」 → 值多少钱?
项目用两条腿走路,优先级不同:
首选:带券计价实测(问收银台)
把券自带的商品码和 couponId 传给 MCP 的 calculate-price,返回的 discount 字段就是这张券的精确价值。实测录制在 fixtures/coupon_probe.json 中,结果:
| 券 | 菜单反查 | 带券计价 |
|---|---|---|
| 中薯条买一送一 | 14.5 元 | 14.5 元 |
| 王牌小食拼 | 0(查不到) | 6.6 元 |
兜底:菜单反查原价(拿不到券的商品码时用),规则按券型分四种:
| 券形态 | 推算公式 | 示例 |
|---|---|---|
| 满减券 | 直接取减免额 | 满50减12 → 12 元 |
| 买一送一 | 取商品菜单单价 | 中薯条 14.5 元 |
| 免费券 | 取商品菜单单价 | 免费脆薯饼 → 脆薯饼单价 |
| 固定价券 | 菜单原价 − 固定价 | 23.0 − 9.9 = 13.1 元 |
为什么首选实测?「王牌小食拼」标题里没有数字、菜单里也没有对应商品,反查只能返回 0——而它实际值 6.6 元。反查不只是可能低估,还会把真实存在的价值报成 0。两条路都走不通时,一律取 0 并标注「价值未知」,宁可少报,不可编造。
量化方法第三步:净价值与用券排程——算得出,未必用得上
知道「正在白扔 21.1 元」后,下一个问题是:这笔钱怎么不白扔?
答案取决于一个反直觉的事实——券的名义面值,从来不是它对你的真实价值。核心公式(实现见 src/planner.py 的 classify_coupon()):
净价值 = 券面价值 − 为用这张券、你本来不会花的那部分钱
一张「满50减12」的券,如果你客单价只有 13 元:为用它得点到 50 元,名义省 12、实际多花 37,净亏 25。按这个公式,券包会被切成四类:
| 类别 | 判定条件 | 工具的态度 |
|---|---|---|
| 顺手可用 | 你本来就会花到门槛 | 直接用 |
| 努一把 | 差额 < 券面价值 | 凑单后仍净赚 |
| 纸面富贵 | 差额 ≥ 券面价值 | 明确劝退,算出硬用会亏多少 |
| 无法判断 | 反查不到原价 | 如实标注,不估算 |
这还不够。最后一层是用券排程:券会过期,而你点单的次数有限。工具先用历史订单推算「券全部过期前你还会点几单」,再在这个约束下分配券。真实数据的结论相当扎心:
窗口 2 天(券全部过期前) · 点单频率 0.089 单/天
→ 这期间你大概只会点 1 单,最多用掉 1 张券
券包可实现 ¥21.1,但机会只够用掉 ¥14.5
—— 剩下 ¥6.6 注定随券过期浪费
可实现的券,未必用得上。 这是比「券面价值加总」更硬的一层,也是大多数工具没碰到的地方。
一个真实例子:21.1 元的沉默成本是怎么算出来的
上面的数字全部来自 fixtures/ 里录制的真实 MCP 响应(采集于南京东城汇餐厅门店),完整复现说明见 fixtures/README.md。其中有一处口径修正在量化方法里非常关键:
- 0 元订单(多为券核销、积分兑换)不计入客单价,但仍算一次点单机会;
- 整单退款直接过滤,部分退款如实提示「支出可能略偏高」。
仅这一处修正,客单价就从按 8 单摊薄的 12.94 元变成按 6 笔有支出订单算出的 17.25 元,结论随之从「两张券都得凑单」翻转为「两张都顺手可用」,可实现金额从 ¥17.58 变成 ¥21.1。基准算错,后面所有券的判定都会跟着偏。
最终,审计输出会收敛成一句可以直接行动的话:
本月最该做的事:先把 21.1 元的券用掉,这笔钱不用就是纯损失。
30 秒亲自动手算一算
想验证整套量化方法?零第三方依赖、不需要 MCP Token、不联网:
git clone https://gitcode.com/gh_mirrors/mc/mcd-coupon-strategist.git
cd mcd-coupon-strategist
python demo.py
demo.py 读取录制的真实 MCP 响应跑通「单次省钱 + 消费审计」两条链路,输出与本文示例逐字一致;接上真实 Token 后(配置指引见 docs/TOKEN_GUIDE.md),这些响应由 MCP 实时返回,业务逻辑一字未改。
关键文件导航
| 文件 | 作用 |
|---|---|
| src/auditor.py | 沉默成本计算 + 消费习惯画像(双口径设计) |
| src/planner.py | 券的净价值判定、券包体检与用券排程 |
| src/mcd_adapter.py | MCP 响应适配层:单位换算、券面价值反查 |
| fixtures/README.md | 录制数据来源、采集时间与口径验证素材 |
| MCP_INTEGRATION.md | 12 条实测调用契约,MCP 开发避坑 |
| demo.py | 零配置端到端演示(同时是回归测试) |
小结
mcd-coupon-strategist 的「券的沉默成本」给了省钱工具一个新视角:别处都在帮用户花钱,它在帮用户止损。三步量化——按卡包口径捞取临期券、用带券计价算出每张券的真实价值、再用净价值和排程告诉你哪些注定浪费——把「券悄悄过期」这件隐形的事,变成了一个具体到元、具体到天、可以直接行动的数字。
