iPhone Duo 到店取货监控:一个 NAS 小脚本的诞生记
副标题:从「几分钟就没了」到「抢到手机」,只用了一个纯 Python 脚本 + Bark 推送
起因:iPhone Duo 到底有多难抢
iPhone Duo 512GB 上市后热度极高,Apple 官网「到店取货」的库存是动态释放的——实测中,一个门店的可取货窗口往往只有 3~5 分钟:今天上午 10:12 查南京东路有货,10:15 再查就没了;10:31 七宝店出现货,10:34 也消失。人工刷新网页根本来不及。
于是我想:能不能写个脚本,每两分钟查一次 Apple 的取货接口,一旦有货就立刻推送到手机,直到我抢到为止?
思路:监控什么、怎么通知、什么时候安静
整个监控围绕三个问题设计:
- 查什么:iPhone Duo 512GB 星光白 / 夜空色,上海 8 家 Apple Store(南京东路、环球港、静安、环贸 iapm、香港广场、浦东、五角场、七宝)的「到店取货」状态。
- 怎么通知:手机推送用 Bark(iOS 上免费的推送 App,一个 HTTP POST 就能推)。策略上做「猛攻」——新发现有货连续推 3 条,之后进入每分钟热循环,只要还有货就每分钟再推 1 条,直到没货。因为这种热门货可能几秒就被锁单,宁可轰炸也不能漏。
- 什么时候安静:每天 00:00–07:00 不推送(扫描照常,早上起来看结果就行);没货时保持安静;查询失败绝不当作无货(unknown ≠ 无货,这是铁律)。
接口探秘:Apple 未公开的 pickup-message 接口
Apple 中国官网的库存查询走的是一个未公开的内部端点:
https://www.apple.com.cn/shop/retail/pickup-message
?pl=true&mts.0=regular&searchNearby=true&store=R683&parts.0=MK2P4CH/A&parts.1=MK2Q4CH/A
返回 JSON 里,每个门店 × 每个 SKU 的关键字段是:
{
"storeNumber": "R705",
"storeName": "七宝",
"city": "上海",
"partsAvailability": {
"MK2P4CH/A": {
"pickupDisplay": "available", // available / unavailable / ineligible
"pickupSearchQuote": "今天可取货",
"messageTypes": { "regular": { "storePickupQuote": "今天;Apple 七宝" } }
}
}
}
判断逻辑很简单:pickupDisplay == "available" 就是有货。注意旧接口 /shop/fulfillment-messages 已废弃(恒返回 HTTP 541 拦截页),别用。
一个诚实的结论:这个接口查不到库存数量——只有「有/无」和文本提示(「今天可取货」「暂无供应」),没有「剩几台」。数量属于 Apple 内部系统,公开接口不暴露。
实现:100% 纯 Python 标准库
脚本零第三方依赖(只用 json/os/sys/urllib/datetime/subprocess),Python 3.8+ 直接跑,方便在 NAS / 服务器 / Mac 上部署。三个文件各司其职:
| 文件 | 作用 |
|---|---|
apple_duo_pickup_monitor.py |
主程序:查库存 → 判状态 → 按策略推 Bark → 写结果 |
state.json |
去重状态:16 个 slot 的历史状态 + last_notified(必须持久化,否则会重复推送或漏报) |
result.json |
每轮覆盖的最新结果(ok / has_stock / should_notify / summary_text),给外部工具做决策 |
核心设计:查询失败 = unknown,绝不静默当成无货;推送失败不标记已提醒,下一轮自动重试(防漏报);JSON 全部原子写(.tmp + os.replace),防中途断电写坏。
通知策略的两次演化
- V1(单次提醒):新发现有货推 1 条,之后 60 分钟去重。太容易错过。
- V2(猛攻模式):新到货连发 3 条 → 每分钟热循环推 1 条 → 直到没货。实测窗口只有几分钟,这个策略是必要的。
- V2.1(静默时段):00:00–07:00 不推 Bark,早上恢复后如有货自动补提醒。
在 fnOS NAS 上的调度:一波三折
监控跑在飞牛 fnOS 上,想让它每 2 分钟自动跑一轮,遇到几个坑:
- 没有 root / 用户 cron 被禁:fnOS 环境禁用了 sudo 和 setuid(
crontab装不上)。最后方案:setsid nohup起一个完全脱离会话的守护循环进程,每 120 秒调一次脚本。 - flock 幽灵锁:用
flock做单实例锁时,/proc/locks显示锁被一个「看不见的进程」持有(跨命名空间),重启守护失败。换成mkdir + PID 文件原子锁,还能自动清理僵死实例。 - SIGTERM 杀不死守护:bash 在前台子进程(
sleep)运行时会推迟执行 trap,优雅停止无效。改用 SIGKILL 停止,状态反正都在磁盘上。 - bash 陷阱:
trap ... TERM会让进程「捕获信号后继续跑」,停止脚本里必须显式exit或直接 SIGKILL。
最终守护脚本三件套:start_monitor.sh(防双开 + 等旧进程退出)、run_monitor.sh(120s 循环)、stop_monitor.sh(SIGKILL + 清理锁目录)。
结果:抢到了 ✅
监控上线当天下午,手机收到了「✅ 发现可取货组合」的推送,成功下单。从思路到落地不到一天,全程:
- 无 pip 依赖、无第三方服务(Bark 免费)
- 无货时安静,每天约 720 次请求,接口毫无压力
- 日志全留痕:每轮 3 行,有货时记录推送明细,一个月也才几 MB
复用价值
这套模式(轮询公开接口 → 状态去重 → 条件推送 → 守护循环)可以平移到任何「抢库存 / 抢票 / 盯价格」的场景:改改 URL、解析字段、推送文案即可。要点就三条:
- unknown ≠ 无货:查询失败要保留状态,别误报也别漏报;
- 去重状态必须持久化:推送成功才记
last_notified,失败自动重试; - 通知节奏跟着货源走:平时低频,一旦有货立刻高频轰炸,直到尘埃落定。
后记:所有代码与文档(含 Bark 配置模板)保留在项目目录 apple_duo_monitor_export/,README 里有完整的迁移交接文档,方便任何 AI/人接手。