whentofly

whentofly — 面向 AI Agent 的航班搜索（MCP）

whentofly.io 是一款灵活日期航班搜索工具，你的 AI Agent 可以直接使用。问 Agent：“10 月从新加坡到东京，往返 5–9 天，最便宜的行程”——它会搜索整个日期范围，返回价格最低的真实票价和预订链接，并告诉你这个价格处于该航线通常价格区间的什么位置。

无需 API 密钥。无需注册。两个工具，托管在远程服务上——无需在本地运行任何内容。

安装

Claude Code

claude mcp add whentofly https://whentofly.io/mcp?ch=github

Claude Desktop / claude.ai — 设置 → 连接器 → 添加自定义连接器 → https://whentofly.io/mcp?ch=github

Cursor — 添加到 mcp.json：

{
  "mcpServers": {
    "whentofly": { "url": "https://whentofly.io/mcp?ch=github" }
  }
}

任何其他支持远程（可流式传输的 HTTP）的 MCP 客户端：将其指向 https://whentofly.io/mcp。

ChatGPT — 使用 whentofly Custom GPT（目前 MCP 连接器仅适用于 Claude/Cursor）。

工具的功能

search_locations — 将地点名称转换为确切的标识

返回可直接传递给 search_flights 的类型化值：

• city:SHA — 上海市场的所有机场
• airport:SHA — 特指虹桥，而非浦东

许多 IATA 代码既指机场，也指整个城市市场——SHA 就同时代表两者——因此，如果有多个结果看起来都合理，你的 Agent 应该询问你指的是哪一个。其背后的目录涵盖 3,614 个机场和 3,465 个城市，因此小型区域机场也能解析。

已经知道代码？直接传入即可。此工具适用于不常见地点，以及需要区分城市与机场的情况。

search_flights — 在灵活日期范围内查找最便宜的往返航班

提供月份或日期范围，以及行程最短/最长天数（“10 月，5–9 天”），它就会扫描所有有效的出发/返程日期组合，然后按价格排序。每个票价都附有预订链接，并会解析航空公司名称。

省略目的地——或说“任意目的地”——就能找到从出发地起飞最便宜的目的地。“9 月从柏林出发，飞往哪里最便宜？”

每个票价还会标注价格水平：划算、通常、偏高；如果该航线没有可用的价格区间，则标注为数据不足。这表示当前价格相对于该航线通常价格区间的位置。它不反映票价走势，也绝不会建议你等待。

示例提示词

• “查找 10 月新加坡 → 东京最便宜的往返行程，5 到 9 天。”
• “9 月从柏林出发，飞一周的话去哪里最便宜？”
• “纽约 → 里斯本 11 月的机票卖 450 美元算贵吗？查查灵活日期。”
• “帮我规划未来 3 个月内最便宜的日本 10–14 天行程。”
• “从张家界出发的航班——先解析机场。”

目前尚不支持的功能

高级舱位尚不可预订。请求 cabin=business 或 first，你可能会在 metadata.route_price_check 中获得航线级价格参考，但不会得到带有预订链接的排序票价。我们的可预订票价来源仅涵盖经济舱。我们可以在一个跳转到其他地方的链接旁显示来自其他来源的商务舱价格——但我们宁愿什么都不显示，也不愿提供一个链接无法兑现的价格。

价格是缓存的参考信息。每个响应都包含 metadata.freshness，让你的 Agent 能查看票价有多陈旧；请在预订页面确认最终价格。

定价与资金来源

排序以你为先，而非以我们为先。 结果按我们找到的最低真实价格排序，无论卖家是否向我们付费——卖家无法通过付费来提高排名。

免费使用，无需密钥。部分预订链接是联盟链接：如果你通过其中的链接预订，合作伙伴可能会向我们支付佣金，且不会加到你的票价中。每个结果都会单独报告其变现方式，因此 Agent 可以分辨其中的区别。票价来自缓存的机票数据；请务必在预订页面核实最终价格。

面向开发者

同一搜索功能也提供纯 JSON API — https://whentofly.io/search （文档），以及用于解析地点的 https://whentofly.io/locations?q=Shanghai。此仓库托管的是托管式 MCP 服务的文档；服务本身为闭源。

如有问题或反馈，请联系：[email protected]，或在此处提交 issue。