美团外卖优惠券助手

要解决什么

美团外卖的优惠券大多通过移动端 H5 发放，手动抢券有几个实际痛点：页面加载慢、券位分散在长页面里、热门券开抢即倒计时，人很难在第一时间走完识别、选择、点击的链路，反复手动刷新还容易触发风控。这个技能不是帮用户绕过限制，而是把领取流程里重复、易错的步骤自动化：登录状态检查、候选按钮识别、真实点击、倒计时券位监控与定时唤醒。

工作流程

核心是三条命令：

• claim：打开页面、检查登录、识别候选按钮并执行真实领取点击；只想看结果不点击时用 claim --dry-run
• inspect：只识别倒计时券位，不做任何点击
• rush：到点抢单张券，必须带 --confirm-rush，且用户已明确选中券位和唤醒时间

主流程大致是：先跑 status 检查本地登录状态，缺失时用 login 打开移动端模拟的 Chromium 窗口（默认深圳龙岗坐标），由用户在窗口里手动登录；回到终端后执行 claim 自动领取。若 inspect 返回 countdownDetected=true，技能会展示每个券位的 index、金额、门槛和开抢时间，要求用户只选一张，再询问是否创建定时唤醒。被唤醒后重新检查登录状态，只对选中的券位执行一次 rush，遇到抢光、超时或验证阻断立即停止。

适用边界

它有几条明确的红线：

• 不索要也不保存密码、短信验证码、Cookie 或 localStorage 明文，登录必须由用户在打开的浏览器里手动完成
• 不进入美团 App 流程，遇到 App-only 提示直接关闭或忽略
• 不支持批量账号、长时间循环领取或激进重试
• 页面没有明确成功文本时，按钮消失只能算未知状态，不能报成功
• 默认只跑一次 rush，不为追券突破脚本重试上限
• 修改真实浏览器行为前必须先用 npm test 覆盖验证

运行需要 Node.js 18+ 和 Playwright；环境缺依赖时按清华 TUNA 或 npmmirror 镜像处理。