用途:回答“某条航线在灵活日期下何时用里程兑换最便宜”这类问题,例如 SFO→NRT 商务舱哪几天最划算,或在指定月份查看 SFO-CDG 的里程票可用性。
主要能力:在给定日期范围内查询 seats.aero 缓存搜索接口,支持起降机场逗号分隔(如 SFO,SJC,OAK、NRT,HND),可按 economy、premium、business、first 过滤舱位,并可只返回里程最低的结果。结果按日期分组并跨所有常旅客计划取每日每舱位的最低价,再结合 transfer-partners.json 换算为可转点货币的有效成本,最终用 Markdown 表格逐舱位展示日历网格,标注当月最佳日期、次优选择、最差时段与最便宜经济舱,并可附现金票价对比、CPP、订票提示、放票说明与数据新鲜度提醒。
必要用法:调用 seats.aero 缓存搜索接口,示例为:
curl -s -H "Partner-Authorization: $SEATS_AERO_API_KEY"
"https://seats.aero/partnerapi/search?origin_airport={ORIGIN}&destination_airport={DEST}&start_date={START}&end_date={END}&cabin={CABIN}"
日期用 YYYY-MM-DD,范围建议 60 天内;超过 60 天拆成两次查询再合并。order_by 用 lowest_mileage,take 设为 1000 以便一页取全。
适用场景:日期灵活的单程里程票搜索,可按月查看某航线并比较不同常旅客计划与转点成本。
限制:仅使用缓存数据,结果可能滞后 1-48 小时,转移点数前须自行核实;单次查询上限约 60 天;不做往返优化,往返需分别跑去程与回程;不做现金票价日历,现金日期灵活性请用 Google Flights 的 Date grid 或 Skiplagged;不支持酒店日期灵活性;可能出现幽灵座位,部分结果实际不可订。特定日期搜索应直接使用 seats-aero,实时搜索需配合 seats-aero-web 且仅限本地环境。数据缺失时不得静默失败,需明确提示重试、扩大机场范围、更换月份或舱位。