别再把麦当劳优惠券白扔了:mcd-coupon-strategist 券包体检与用券排程使用指南
别再把麦当劳优惠券白扔了:mcd-coupon-strategist 券包体检与用券排程使用指南
你有没有想过,麦当劳优惠券什么时候过期?🤔 mcd-coupon-strategist(麦麦省钱助手)是一个基于麦当劳 MCP 的点餐成本优化工具,核心能力是券包体检与用券排程:先把券包里每张券的"净省价值"算清楚,再结合你的点单频率,排出现在到券过期前该怎么用券——让每一张券都不再白扔。
为什么你的券正在"悄悄过期"?
市面上的省钱工具大多只回答一个问题:"这一单怎么点最省"。而 mcd-coupon-strategist 多回答一个问题:"你正在白扔多少钱?"
关键认知只有一条:券是有保质期的钱。
- 一张「中薯条买一送一」还剩 2 天过期,不用掉 = 白扔 14.5 元
- 一张「满 50 减 12」如果客单价只有 13 元,硬凑单反而净亏 25 元
券包体检与用券排程,就是围绕这两类"看不见的钱"设计的(核心逻辑在 src/planner.py)。
功能一:券包体检——先回答"这些券值多少钱" 💡
体检的核心公式:
净价值 = 券面价值 − 为用这张券、你本来不会花的那部分钱
按净价值,券包会被分成四类:
| 类别 | 含义 | 工具的建议 |
|---|---|---|
| ✅ 顺手可用 | 你本来就会花到门槛 | 直接用,净省 = 券面价值 |
| 👉 努一把 | 差额小于券面价值 | 凑单后仍净赚,会标出赚多少 |
| 🚫 纸面富贵 | 差额 ≥ 券面价值 | 明确劝退,算出硬用会亏多少 |
| ❓ 无法判断 | 券面反查不到原价 | 如实标注,绝不估算 |
真实输出长这样:
券包体检
名义总额 ¥21.1(9 张) → 可实现 ¥21.1
【顺手可用】2 张 · 净省 ¥21.1
· 中薯条买一送一 净省 14.5 元 还剩 2 天
· 王牌小食拼 净省 6.6 元 还剩 2 天
【无法判断】7 张(菜单中无对应商品,未估算)
一句话结论:券包名义 ¥150,按你的消费习惯可能只拿得到 ¥60——这才是体检的意义。
功能二:用券排程——再回答"机会够不够用" ⏳
体检算出"可实现 ¥X"有个隐含前提:你都有机会用掉。但券会过期,而你点单的次数有限。排程分三步:
- 算窗口:券全部过期前的天数
- 算频率:近 90 天订单数 ÷ 90,得到每天点单频率
- 分机会:
机会数 K = max(1, 向下取整(窗口天数 × 点单频率)),按净价值从高到低安排
输出示例:
用券排程
窗口 2 天(券全部过期前) · 点单频率 0.089 单/天
→ 这期间你大概只会点 1 单,最多用掉 1 张券
第 1 单 → 中薯条买一送一 净赚 14.5 元
排不上(1 张 · 可实现 ¥6.6)
· 王牌小食拼 净价值 6.6 元 还剩 2 天
券包可实现 ¥21.1,但机会只够用掉 ¥14.5 —— 剩下 ¥6.6 注定随券过期浪费。
"可实现的券,未必用得上"——这一层结论,是大多数省钱工具给不出的。
快速上手:4 步开始使用 🚀
第 1 步:克隆仓库,30 秒跑通 demo
git clone https://gitcode.com/gh_mirrors/mc/mcd-coupon-strategist
cd mcd-coupon-strategist
python demo.py
零第三方依赖、不需要 MCP Token、不联网。demo.py 读取 fixtures/ 里录制的真实 MCP 响应,完整跑通"单次省钱 + 消费审计"两条链路,你也可以直接看到上面券包体检与用券排程的完整输出。
第 2 步:申请麦当劳 MCP Token
登录麦当劳官方 MCP 开放平台,用手机号验证后进入控制台点击【激活】即可获取 Token,全程约 3 分钟。详细步骤与常见错误(401 / 429)见 docs/TOKEN_GUIDE.md。
⚠️ Token 等同于账号凭证,绝不要提交到任何公开仓库。
第 3 步:配置 MCP 连接
仓库自带脱敏配置样例 mcp-config.example.json,把 ${MCD_MCP_TOKEN} 替换为你的真实 Token,粘贴到 MCP 客户端(如 WorkBuddy →【专家 · 技能 · 连接器】→【自定义连接器】→【配置 MCP】)并保存启用即可。
第 4 步:开口就能用
直接对话提问,例如:
- "我有没有麦当劳优惠券快过期了?"
- "这单用哪张券最划算?预算 40 能吃什么?"
- "我最近在麦当劳花了多少?"
工具会先定位当前门店,拉取实时菜单、可用券与历史订单,所有金额都来自 MCP 真实计价(calculate-price),绝不估算。
体检报告里的三个"额外彩蛋" 🎁
| 能力 | 它会提醒你什么 |
|---|---|
| 可领取券发现 | "你还有 3 张券没领"——领取免费,但会判断哪张值得领,且绝不擅自替你领券 |
| 积分体检 | 积分也是会过期的钱;实测 24 个兑换品中 15 个已过兑换期,状态却仍标"上架" |
| 活动节奏 | 把活动时间线和券的有效期对起来,回答"等活动再买"等不等得起(纯日期比较,不拿营销文案里的价格算账) |
适合谁用?
- 🍟 学生党 / 打工人:预算固定,同样吃饱的前提下花更少
- 🎫 囤券用户:卡包里券很多,不知道哪张快过期、哪张该用、哪张别用
- 📊 记账新好奇:从没算过自己在麦当劳的月度开销
总结
别的工具帮用户花钱,mcd-coupon-strategist 帮用户止损:券包体检告诉你钱正在流失多少,用券排程告诉你怎么在过期前把它救回来。先跑一遍 python demo.py,看看你自己的"沉默成本"是多少吧。
