全球机票查询预订RollingGo

# 机票查询MCP [**中文**](#中文版本) | [**English**](README.md) [](https://github.com/RollingGo-AI/rollinggo-flight-mcp/releases) [](https://modelscope.cn/) [](https://github.com/RollingGo-AI/rollinggo-flight-mcp) [](https://opensource.org/licenses/MIT) [](https://www.python.org/downloads/) 🏠 [官网](https://rollinggo.store/) · 🚀 [快速开始](#快速开始) · 🔧 [工具](#工具) · 💬 [技术支持](#技术支持) ## 项目简介 - **官方出品，全球覆盖**：500+ 合作航司，覆盖全球 200+ 国家和地区、1000+ 全球目的地 - **航线丰富**：千万级航线组合，满足多样化出行需求，支持直飞、中转等多种行程类型 - **价格优势**：整合全球优质机票资源，提供更具竞争力的实时价格 - **服务保障**：专业团队支持，7×24 小时全天候客户服务响应 ## 适用人群 - 有机票监控、酒店查询、酒店比价需求的个人用户 - 正在开发 AI Agent 的团队或个人开发者 - 想在 MCP Client 中接入机票预订能力的开发者 - 正在构建旅行规划、差旅管理、OTA、生活服务类智能体的开发者 - 希望验证 AI Agent 商业交易闭环的产品团队 ## 应用场景 - **通用 AI Agent**：让你的大模型 Agent 直接拥有原生机票预订能力，用户在自然对话中即可完成从需求理解、智能推荐、比价筛选到订单创建的全流程 - **AI 旅行助手**：根据用户出发地、目的地、出行日期、预算和个性化偏好精准推荐航班，支持多维度需求匹配 - **行程规划工具**：把机票搜索和预订能力无缝嵌入对话式行程规划流程，实现 "规划即预订" 的一体化体验 - **MCP / Agent Demo**：快速验证 "AI Agent 直接完成机票交易" 的产品能力，打造可演示的完整闭环 ## 核心功能 - 支持城市名称、机场代码、航空公司名称、航班号等多种关键字精准搜索机场和航班信息 - 提供灵活的出发/返程日期设置、舱等选择（经济舱/超级经济舱/商务舱/头等舱）、乘客人数配置、直飞/中转筛选、航空公司偏好等专业筛选功能 - 基于用户个人偏好提供个性化推荐，生成高性价比、最快到达、最少中转、热门航司等多维度专业榜单 - 全程自然语言交互，智能完成从地点解析、航班查询、比价筛选、个性化推荐到订单生成的完整闭环 - 价格和库存实时同步供应商数据，确保查询结果准确可订 ## 你可以让 Agent 完成以下机票相关任务 - 根据出发地、目的地、出行日期和乘客人数搜索航班 - 查询航班价格、舱位信息和实时库存 - 判断航班或舱位是否可订 - 构建航班推荐、比价、行程规划等 AI 工作流 - 将机票能力接入到 Claude、Cursor、Cherry Studio、ChatGPT MCP Client 或其他支持 MCP 协议的客户端中 - ⚠️如果你使用 ClawHub/扣子/Qclaw等Agent 平台，请使用我们的[Rollinggo全能订机票酒店Skill](https://modelscope.cn/collections/yorklu/RollingGo-quannengdingjiudianjipiao-Skill)。请参考[RollingGo Skill 配置指南](https://rollinggo.store/docs/skill-docs/skill-config). ## 工具 ## 🚀快速开始 > 💡 总结来说，你只需要做两件事：申请API Key+ 在AI助手中一键配置，**无需编写代码**，就能让任何支持MCP的AI助手具备酒店搜索能力，5 分钟内完成第一次 MCP Tool 调用， ### 第一步：获取API密钥 1. [点击进入申请地址](https://mcp.agentichotel.cn/apply) 2. 填写基本信息，1-3 分钟内自动审核通过，收到邮件包含： API Key 伙伴中心账号（登录名 + 初始密码），登录后可配置加价比例、查看订单、查询收益 3. ⚠️ 注意查收邮件，如未收到请检查垃圾邮箱 4. 为了感谢首批愿意尝鲜、快速行动的开发者，我们特别推出限时福利：**所有收到 API Key 后 3 天内完成第一次工具调用，即可自动解锁永久免费无限制调用额度。** 我们希望优先支持真正有需求、有执行力的开发者，让大家零成本体验完整的机票 MCP 能力。 > 邮件中同时包含酒店MCP端点和机票MCP端点，一个Key即可接入。我们同时上架了[RollingGo Hotel MCP](https://github.com/RollingGo-AI/rollinggo-hotel-mcp/tree/main)。 **为什么需要填写信息申请 KEY**？ 酒店价格、库存和订单能力涉及真实交易链路，因此我们需要为每个开发者开通**免费专属的独立 KEY**。申请 KEY 时仅需填写少量信息，这样做主要是为了： - 为你免费开通合适的接口权限 - 在接入过程中提供技术支持 - 判断你的使用场景，减少无效配置成本 - 保护接口稳定性，避免恶意调用或异常流量 - 在测试订单、价格查询、库存校验等问题上能及时联系到你 我们只会将这些信息用于 KEY 开通、接入支持和服务安全，不会对外共享，也不会用于无关用途。若你只是想先体验 MCP，也可以说明你的测试目标，我们会尽量提供轻量的测试支持。 ### 第二步：在AI助手中配置 > 推荐 Claude CLI、Codex、Cursor 三个客户端。其他支持 MCP 的客户端（如 Kiro、豆包等）配置方式类似。 ### Claude CLI 在项目根目录创建 `.mcp.json`： ```json { "mcpServers": { "RollingGo-Flight": { "url": "https://mcp.rollinggo.cn/mcp/flight", "type": "http", "headers": { "Authorization": "Bearer YOUR_API_KEY" } } } } ``` 也可以通过命令行直接添加： ```bash claude mcp add \ --transport http \ --header "Authorization: Bearer YOUR_API_KEY" \ RollingGo-Flight \ https://mcp.rollinggo.cn/mcp/flight ``` ### Codex 配置文件位置：项目根目录 `.codex/config.json` 或全局 `~/.codex/config.json` ```json { "mcpServers": { "RollingGo-Flight": { "url": "https://mcp.rollinggo.cn/mcp/flight", "type": "streamable-http", "headers": { "Authorization": "Bearer YOUR_API_KEY" } } } } ``` ### Cursor 配置文件位置：项目根目录 `.cursor/mcp.json` 或全局 `~/.cursor/mcp.json` ```json { "mcpServers": { "RollingGo-Flight": { "url": "https://mcp.rollinggo.cn/mcp/flight", "type": "streamable-http", "headers": { "Authorization": "Bearer YOUR_API_KEY" } } } } ``` > 将 `YOUR_API_KEY` 替换为你收到的实际 API Key。酒店和机票使用相同的认证方式，区别仅在于 URL（`/mcp/flight`）。 ### cURL 直接测试 > **注意**：cURL 必须带 `-H "Accept: application/json, text/event-stream"` 头，否则服务端返回 400。 ```bash curl -X POST https://mcp.rollinggo.cn/mcp/flight \ -H "Content-Type: application/json" \ -H "Accept: application/json, text/event-stream" \ -H "Authorization: Bearer YOUR_API_KEY" \ -d '{ "jsonrpc": "2.0", "method": "tools/call", "params": { "name": "searchFlights", "arguments": { "adultNumber": 1, "childNumber": 0, "cabinGrade": "ECONOMY", "tripType": "ONE_WAY", "fromCity": "HGH", "toCity": "CTU", "fromDate": "2026-06-01" } }, "id": 1 }' ``` ## 第四步：第一次 MCP 调用 配置完成后，对你的 AI 助手说： > "帮我搜一下杭州到北京的机票"。AI 会自动调用Tool，返回机票列表。 ### 机票查询示例（两步） **Step 1**：搜索机场，获取城市代码 ```json { "jsonrpc": "2.0", "method": "tools/call", "params": { "name": "searchAirports", "arguments": { "keyword": "杭州" } }, "id": 1 } ``` **Step 2**：用城市代码查询航班 ```json { "jsonrpc": "2.0", "method": "tools/call", "params": { "name": "searchFlights", "arguments": { "adultNumber": 1, "childNumber": 0, "cabinGrade": "ECONOMY", "tripType": "ONE_WAY", "fromCity": "HGH", "toCity": "CTU", "fromDate": "2026-06-01" } }, "id": 1 } ``` ## 第五步：查看结果，展示案例 ### 机票查询结果（实测数据） > 杭州→成都，单程，经济舱，共返回 **95 条航班**： | 航班号 | 航线 | 时间 | 价格 | |--------|------|------|------| | CA1741 | 杭州萧山 → 成都天府 | 07:40 - 10:40 | ¥2,869 | | CZ6198 | 杭州萧山 → 武汉 | 13:10 - 15:00 | ¥4,631 | | CA3338 | 杭州萧山 → 深圳 | 12:55 - 15:15 | ¥5,341 | --- ## 附录 ### 推荐调用流程 **机票查询** ``` 1. 用户说"帮我查机票" 2. 调用 searchAirports → 获取城市代码 3. 调用 searchFlights → 返回航班列表 4. 展示给用户（⚠️ 价格和库存实时变化） ``` ### 常见问题 **Q1: 配置后客户端看不到 Tool** 1. 检查 JSON 配置格式是否正确 2. 确认 `url` 和 `type` 是否正确 3. 确认 `Authorization` header 中的 API Key 是否正确 4. 重启客户端（修改配置后需要重启才能生效） **Q2: 返回 401 Unauthorized** API Key 无效或格式错误： 1. API Key 应以 `mcp_` 开头 2. `Authorization: Bearer YOUR_API_KEY` 中 Bearer 后有一个空格 3. API Key 是否有多余的空格或换行 **Q3: 返回 400 Bad Request** cURL 直接调用时常见，检查是否带了 Accept 头： ```bash -H "Accept: application/json, text/event-stream" ``` **Q4: searchFlights 报错** 1. 确认先调用了 `searchAirports` 获取正确的城市代码 2. 确认 `fromDate` 不是过去的时间 3. 往返行程必须传 `retDate` **Q6: 价格和实际不一致** 搜索结果中的价格是参考价，实时价格可能有变动。当前仅支持查询，暂不支持在线下单。 **Q7: 如何获取 API Key？** 前往 [https://rollinggo.store/apply](https://rollinggo.store/apply) 提交申请，1-3 分钟内审核通过，免费无限制。 ### 接入门槛与限制 | 项目 | 说明 | |------|------| | 是否需要注册 | 是，需要在开发者平台提交申请 | | 是否需要 API Key | 是，所有请求需要 `Authorization: Bearer <API_KEY>` | | 调用量限制 | 无限制 | | 费用 | 完全免费 | | 审核周期 | 1-3 分钟自动通过 | | 支持的地区/币种 | 全球酒店和机票，国内用 CNY，海外用 USD | | 下单能力 | 当前仅支持查询，不支持在线下单（规划中） | ### 技术支持 加入微信群，获取技术支持 接入路上有任何问题都别担心！欢迎加入我们的微信技术支持群，我们的核心开发团队会全程在线，手把手帮你搞定环境配置、接口调试，陪你跑通第一个成功的机票查询调用，让你零障碍快速上线。 你可以在群内获得： - 接入配置指导 - API / MCP 调用问题排查 - 机票搜索、价格、库存查询流程说明 - 适合你业务场景的集成建议  | 其他类型 | 方式 | |------|------| | API Key 申请 | [https://rollinggo.store/apply](https://rollinggo.store/apply) | | 商务合作 | contact@rollinggo.cn | | 伙伴中心 | [https://travelportal-partner-center.dida.com](https://travelportal-partner-center.dida.com) | | Skill Hub | [https://rollinggo.store/solutions/skills](https://rollinggo.store/solutions/skills) | | GitHub | [https://github.com/RollingGo-AI/rollinggo-readme](https://github.com/RollingGo-AI/rollinggo-readme) | --- *文档版本：v1.0*