SuperAPI AI 工具集

pricewin-flight-search

通用与其它

查看项目

更新于 10-16 03:48

技能介绍

用途:实时查询某条航线与日期在 Agoda、Trip.com、Traveloka 三个平台的机票票价,支持单程和往返、任意舱位,仅作比价,不能订票或付款。

依赖与安装:需要先注册 pricewin MCP 服务器,否则技能无效(提示调用不存在的工具)。使用 bash install.sh(可先加 --dry-run)把托管服务器 https://mcp.price.win/mcp(Streamable HTTP,无需凭据)注册到已有的 Claude Code、Cursor、Windsurf、Gemini CLI、VS Code、Codex 等 agent,写入前生成 .bak,无法解析的配置会跳过,重复运行无变化,之后需重启 agent。

主要能力与用法:工具 search_flights_live 会异步抓取三个平台,立即返回 sessionId 且无航班;随后用 poll_flight_results(sessionId) 轮询,内部阻塞约 30 秒,返回合并后的每航班最低价。状态为 pending|searching|completed|failed,若仍为 searching 可再调最多 4 次。会话在最后一次轮询后 15 分钟过期,需重新发起搜索。搜索参数为 origin、destination、departureDate(YYYY-MM-DD),往返时再传 returnDate,另可按需传 adults、cabin、language="vi"。

关键限制:起降机场必须使用 3 位 IATA 代码,服务器没有机场查询工具,需自行解析城市代码;多机场城市且用户未指明时要简短询问,不得猜测或编造代码。价格是所有成人的合计总额,单位为 USD(仅在实时汇率不可用时回退为 VND),人员均价需自行除以人数(往返票价并非两段合计)。bookingUrl 为最便宜代理的深链,需原样使用,不得追加或改写参数;若恰为 https://www.price.win/ 表示未捕获深链,需说明需到提供方网站复核;来源只按 URL 主机判断。stopCities 始终为空、departure.city/arrival.city 重复 IATA 代码、legs 通常缺失,不要承诺航段明细。输出按要求展示每段前 5-7 个航班,按价格排序,最便宜者标注,最长往返分别列出并注明是两张单程票,而非报价的往返票价。数据仅发送航线查询(IATA 代码、日期、乘客数、舱位),不含姓名、PII 或凭据。