Tourmind-Booking-Skills
AI agent skills for end-to-end hotel and flight booking—compare live hotel rates across leading OTAs and suppliers, search and verify real-time airfares worldwide, book stays and flights, and manage reservations, hotel cancellations, and payments via the TourMind API.
原始仓库简介 · 中文摘要待补充 · agent-skills / ai-agent / booking-api / codex-skills / flight-api / flight-booking
README / 项目原文
TourMind Booking Skills
Let Your Agent Search and Book Hotels & Flights Worldwide
Bring Your Customers Into Intelligent Travel
Give your AI Agent end-to-end hotel booking and worldwide flight search and booking capabilities. Without leaving your preferred Agent client, you can search global hotel and flight inventory, compare live prices from leading OTAs and suppliers, verify availability and final prices, and use TourMind Booking Skills to complete bookings and payments and check order status.
Hotel Skill demo
The examples below show the hotel Skill experience.
1. Search live hotels
2. Compare real room options
3. Verify the final rate and pay
What you can do
- Hotels: Search worldwide hotel inventory, compare live rooms and prices, view photos, facilities, meals and cancellation terms, recheck availability, and manage booking, payment and cancellation.
- Flights: Find airports and live one-way, round-trip or multi-city flights; compare schedules, cabins, connections, baggage and total prices; then recheck a selected fare and continue to booking, order lookup and payment.
- Complete trip planning: Ask your Agent to plan an itinerary and search both flights and hotels around your dates, budget and preferences.
- Safer transactions: Searching never creates an order. Before creating a hotel or flight booking, cancelling an eligible hotel booking, or starting a payment, the Agent shows the important details and waits for your explicit confirmation.
- Natural conversation: Speak to the Agent in your preferred language instead of filling out complicated search forms.
Supported Agent clients
TourMind Booking Skills can be used with ChatGPT (Work or Codex mode), Claude Code, WorkBuddy, QClaw, Marvis, OpenClaw, Kimi Work, Doubao Work Mode, Qwen Work Mode, Hermes, Cursor, and other Agent clients that support Skills.
Choose the right TourMind integration
This Skill repository combines hotel and flight support for both personal (ToC) and business (ToB) users. MCP packages use a different structure, so choose the option that matches your use case.
| Integration | Users | Capabilities | Repository |
|---|---|---|---|
| TourMind Booking Skills | ToC and ToB | Hotel and flight Skills | This repository |
| Hotel MCP — Personal (ToC) | ToC | Hotel search and booking for personal users | Hotel Booking AI MCP |
| Hotel MCP — Business (ToB) | ToB | Hotel search and booking for business users | TourMind Booking MCP |
| Flight MCP — Personal and Business | ToC and ToB | One flight MCP shared by personal and business users | Flight Booking AI MCP |
Install in 1 minute
Choose either of the following methods.
Ask your Agent to install it
Copy and send this message to your Agent:
Please help me install TourMind Booking Skills. Skill repository: git@github.com:tourmind-com/Tourmind-Booking-Skills.git.
Or run one command
npx skills add tourmind-com/tourmind-booking-skills --all
This command installs both Skills—tourmind-booking for hotels and flight-booking-ai for flights—to all detected Agent clients without additional selection prompts.
You can search and compare hotels, look up airports, and search live flights without a Token. A configured flight-search Token is still validated. Verification and any real booking, order, or payment action require a Token.
If you already have a TourMind account, you can use its Skill Token. If you do not have an account, sign up for a TourMind account and Token. Send it only to your trusted Agent in a private conversation:
Please use the following TourMind Skill Token when calling the AI Skills:
<YOUR_SKILL_TOKEN>
This Token is only for TourMind AI Skill authentication. Do not expose the complete Token in public conversations, public code repositories, or shared documents.
The Agent will save and configure the Token for the installed Skills. You do not need to create or edit a Token file yourself.
After installation, simply ask the Agent to find a hotel, search for a flight, or plan both together.
Try these prompts
Search for a hotel
Find a hotel in Tokyo for two adults from December 9 to December 13, 2026. We want a twin room near a convenient station, an average price below JPY 18,000 per night, free cancellation, and breakfast if possible. Show me the five best live options with room photos, total stay price, meals, cancellation terms, and the main trade-offs. Do not book yet.
Search for a flight
Find round-trip flights from Shanghai to Tokyo for two adults, departing December 9 and returning December 13, 2026. Economy Class, preferably nonstop. Compare the available options by total price, departure and arrival times, airports, connections, duration, and baggage. Show the checked-baggage allowance for each option and highlight any that include at least one checked bag per person. Do not book yet.
Plan flights and a hotel together
Plan a five-day Osaka trip for two people. First compare practical round-trip flights, then find a well-located hotel that fits our dates and budget. Explain the best flight-and-hotel combinations and show the expected flight and hotel costs separately. Let me choose before you book anything.
Continue with a hotel you like
I like the hotel near Shinjuku Station that you just recommended. Please check which twin rooms are still available, then recheck the best-value option and show me the final price, meals, and cancellation terms. Tell me what information you need from me next and wait for my confirmation before booking.
Continue with a flight you like
The morning nonstop flight you just showed me works best. Please recheck its latest total price, then summarize the itinerary and checked-baggage allowance. Tell me which passenger and contact details you need, show me the complete booking summary, and wait for my confirmation before booking it.
Check an order
Please check the hotel or flight booking we just made and explain its current status. If it can still be paid, show me the available payment methods and final amount first, then wait for my confirmation before continuing.
Booking workflows
The Agent handles these steps inside the conversation. You do not need to call APIs or manage local files yourself.
Hotel search and booking
Destination, dates, occupancy, room count, budget and preferences
→ Resolve the location, POI or exact hotel (search_location / keyword search)
→ Search up to 20 candidate hotels (search_hotels)
→ Batch-check live rooms and stay totals (batch_query_room_rates; query_room_rates for one hotel)
→ Rank and show up to five verified hotels
→ Show the selected hotel's details, room images and live room options (get_hotel_detail + room-rate query)
→ Review mandatory fees from the hotel details, then recheck the chosen room's final price, availability and cancellation terms (check_room_availability)
→ If an order action requires authentication, configure the Token; refresh room rates first if the channel changes, then always repeat the final price and availability check with the new Token
→ Provide the guest's full legal name and contact email
→ Show the complete booking summary and wait for explicit confirmation
→ Create the hotel booking (create_booking)
→ Query the booking on request; start payment or cancel an eligible hotel booking only after separate explicit confirmation (query_booking / pay_order / cancel_booking)
The cached candidate price from search_hotels is only an initial signal. User-visible bookable prices come from the live room-rate query, and the booking uses the latest values returned by check_room_availability. Selecting a hotel or room does not confirm a booking. Payment and cancellation each require a separate review and confirmation. If Stripe is selected, the Agent first explains its additional 3.5% processing fee and that the charged fee is non-refundable.
Flight search and booking
Route, dates, trip type, cabin, preferences and adult / child / infant counts
→ Resolve airports and validate dates and passenger composition (search_airports)
→ Search live flights (search_flights); a Token is optional
→ Compare up to the first 10 offers by schedule, airports, cabin, connections, baggage and total price
→ Select a quotation before 20 minutes have elapsed since the search
→ Configure a Token before verification. If the business Token changed after search, the Agent retrieves updated quotations, explains the change and asks you to select again before verification (verify_offer)
→ Provide passenger, travel-document and contact details
→ Review the complete itinerary, price and traveller details, then explicitly confirm the booking
→ Create the flight booking (create_booking)
→ Query the order and continue only if it is still payable (query_order)
→ Choose a payment method, review the complete payment summary and confirm payment separately
→ Query the order again; only if it is unchanged and still payable, create one payment link (create_payment)
→ Query the order or payment status as needed (query_order / query_payment)
Selecting a flight authorizes only the price recheck, not the booking. If the search criteria change or 20 minutes have passed since the search, the Agent requests approval for a new live search. A payment link is not proof of payment or ticket issuance. Stripe adds a separate 3.5% non-refundable processing fee; WeChat Pay, Alipay and Online Banking are available only for CNY orders.
The flight Skill currently supports airport lookup, live flight search and verification, booking, order lookup, and third-party payment creation and lookup. It does not perform flight cancellation, changes, refund initiation, ancillary-service purchases or manual ticketing actions; contact flight customer service for those requests.
Token and security
- The hotel and flight Skills use the same TourMind Skill Token. Each user only needs to obtain one Token; there is no need to apply twice.
- When either installed Skill needs authentication, the Agent saves the same Token in that Skill's local
skill_token.txt. Every ToB Skill API call must use the Token stored in its local file, and you do not need to create or edit the files yourself. - Never expose the complete Token in prompts, logs, screenshots, URLs, Git commits, or GitHub issues.
- On macOS or Linux, the Agent runs
chmod 600 skill_token.txtso only the current user can read or write the Token file. - If an authenticated request returns HTTP 401 or
unauthorized, the Agent deletes the invalid local Token and stops the authenticated operation. A separate permission-not-enabled response is not treated as an invalid Token. - Returned hotel result pages are read-only and can be reopened until they expire.
- Creating a hotel or flight booking, cancelling an eligible hotel booking, or starting a payment requires the user's explicit confirmation in an authenticated AI conversation.
FAQ
Common Questions About Using TourMind Skill
Help and support
- Product page: tourmind.com/skills
- Get a TourMind account and Token: TourMind sign-up
- GitHub support: open an issue
- Hotel support: hotel@tourmind.com
- Flight customer service (24/7): flightcs1@tourmind.com
- Business cooperation: bp@tourmind.com
- AI product cooperation: ai@tourmind.com
License
MIT © 2026 TourMind
让你的 AI Agent 同时具备端到端的酒店预订能力和覆盖全球的机票搜索与预订能力。无需离开常用的 Agent 客户端，即可搜索全球酒店与航班资源，对比主流 OTA 和供应商的实时价格，核验库存与最终价格，并通过 TourMind Booking Skills 完成预订与支付、查询订单。
酒店 Skill 示例展示
以下 GIF 展示酒店 Skill 的使用体验。
1. 搜索实时酒店
2. 对比真实房型
3. 核验最终价格并支付
核心能力
- 酒店： 搜索全球酒店和实时房型，对比价格，查看图片、设施、餐食与取消政策，重新核验库存，并完成预订、支付和取消。
- 机票： 查询机场及单程、往返或多城市航班，对比时间、舱等、中转、行李和总价，重新核验选中的票价，并继续下单、查询订单和支付。
- 完整行程规划： 让 Agent 根据日期、预算和偏好规划行程，同时搜索适合的机票与酒店组合。
- 更安心的交易流程： 搜索不会自动创建订单。创建酒店或机票预订、取消符合条件的酒店订单或发起支付前，Agent 会展示重要信息并等待你明确确认。
- 自然语言交流： 直接用你习惯的语言描述需求，不必自己填写复杂的搜索表单。
支持的 Agent 客户端
TourMind Booking Skills 支持 ChatGPT（Work / Codex 模式）、Claude Code、WorkBuddy、QClaw、Marvis、OpenClaw、Kimi Work、豆包工作模式、千问工作模式、Hermes、Cursor，以及其他支持 Skill 的 Agent 客户端。
选择合适的 TourMind 接入方式
本 Skill 仓库已经整合酒店和机票的个人用户（ToC）与企业用户（ToB）能力。MCP 的组织方式不同，请根据使用场景选择合适的接入方式。
| 接入方式 | 适用用户 | 能力 | 仓库 |
|---|---|---|---|
| TourMind Booking Skills | ToC 与 ToB | 酒店与机票 Skill | 本仓库 |
| 酒店 MCP — 个人用户（ToC） | ToC | 面向个人用户的酒店搜索与预订 | Hotel Booking AI MCP |
| 酒店 MCP — 企业用户（ToB） | ToB | 面向企业用户的酒店搜索与预订 | TourMind Booking MCP |
| 机票 MCP — 个人与企业共用 | ToC 与 ToB | 个人和企业用户共用同一个机票 MCP | Flight Booking AI MCP |
1 分钟安装
任选下面一种方式即可。
让 Agent 帮你安装
复制下面这段话，发送给你的 Agent：
请帮我接入 TourMind Booking Skills。Skill 仓库地址：git@github.com:tourmind-com/Tourmind-Booking-Skills.git。
或者使用一条命令安装
npx skills add tourmind-com/tourmind-booking-skills --all
该命令会跳过选择，将酒店 tourmind-booking 和机票 flight-booking-ai 两个 Skill 安装到所有已检测到的 Agent 客户端。
搜索和比较酒店、查询机场、机票实时搜索不需要 Token。搜票时已配置的 Token 仍须校验。验价及任何真实预订、订单或支付操作仍需要 Token。
如果你已有 TourMind 账号，可以使用账号中的 Skill Token。如果还没有账号，请前往 TourMind 账号及 Token 申请页面。请只在私密对话中发送给你信任的 Agent：
请使用以下 TourMind Skill Token 调用 AI Skill：
<YOUR_SKILL_TOKEN>
Token 仅用于 TourMind AI Skill 鉴权，请不要在公开对话、公开代码仓库或共享文档中暴露完整 Token。
Agent 会自动为已安装的 Skill 保存并配置 Token，你不需要自己创建或修改 Token 文件。
安装完成后，直接让 Agent 帮你找酒店、查机票，或者把两者放在一起规划即可。
示例 Prompt
搜索酒店
帮我找 2026 年 12 月 9 日至 13 日东京的酒店，两位成人入住。希望是靠近交通便利车站的双床房，平均每晚不超过 18,000 日元，优先免费取消，最好含早餐。请展示当前最合适的 5 个选项，包括房型图片、入住总价、餐食、取消政策和各自优缺点。暂时不要预订。
搜索机票
帮我查 2026 年 12 月 9 日从上海前往东京、12 月 13 日从东京返回上海的往返机票，两位成人，经济舱，优先直飞。请按总价、起降时间、机场、中转次数、飞行时长和行李额度对比可选航班，展示每个选项的托运行李额度，并标出包含每人至少一件托运行李的航班。暂时不要预订。
一起规划机票和酒店
帮两个人规划一次大阪五日游。先对比时间合适的往返机票，再根据日期和预算找交通方便的酒店，说明最值得考虑的机票与酒店组合，并分别列出预计机票和酒店费用。先让我选择，不要自动下单。
继续查看喜欢的酒店
我比较喜欢你刚才推荐的那家靠近新宿站的酒店。请看看现在还有哪些双床房，重新核验最划算的房型，并告诉我最终价格、餐食和取消政策。然后告诉我接下来需要提供哪些信息，等我确认后再预订。
继续查看喜欢的航班
刚才那个上午出发的直飞航班最适合我。请重新核验最新总价，再汇总行程和托运行李额度，并告诉我需要提供哪些乘机人与联系人信息。把完整预订信息给我核对，等我确认后再帮我预订。
查询订单
请帮我查一下刚才预订的酒店或机票现在是什么状态。如果还可以支付，先告诉我可用的支付方式和最终金额，等我确认后再继续。
工作流程
以下步骤均由 Agent 在对话中完成，你不需要自己调用接口或管理本地文件。
酒店搜索与预订
目的地、日期、入住人数、房间数、预算和偏好
→ 解析城市、区域、地点或指定酒店（search_location / 酒店名称搜索）
→ 搜索最多 20 家候选酒店（search_hotels）
→ 批量核验实时房型与入住总价（batch_query_room_rates；单家酒店使用 query_room_rates）
→ 排序并展示最多 5 家经过核验的酒店
→ 展示所选酒店的详情、图片和实时房型（get_hotel_detail + 实时房价查询）
→ 根据酒店详情核对必要费用，再重新核验所选房型的最终价格、库存和取消政策（check_room_availability）
→ 订单操作需要认证时配置 Token；如果渠道发生变化，先重新查询房价；无论渠道是否变化，都要使用新 Token 重新核验最终价格和库存
→ 提供住客的证件姓名和联系邮箱
→ 展示完整预订信息并等待明确确认
→ 创建酒店订单（create_booking）
→ 按用户要求查询订单；发起支付或取消符合条件的酒店订单前，需要分别获得明确确认（query_booking / pay_order / cancel_booking）
search_hotels 返回的候选起价只用于初步筛选。向用户展示的可订价格来自实时房价查询，最终下单使用 check_room_availability 返回的最新结果。选择酒店或房型不等于确认预订；支付和取消都需要分别核对并再次确认。选择 Stripe 时，Agent 会先说明额外收取的 3.5% 处理费，以及该费用一旦收取便不可退款。
机票搜索与预订
航线、日期、行程类型、舱等、航班偏好及成人 / 儿童 / 婴儿人数
→ 查询机场并核对日期和乘客组成（search_airports）
→ 搜索实时航班（search_flights），Token 可选
→ 对比前 10 个航班报价的时间、机场、舱等、中转、行李和总价
→ 在搜索结果生成后未满 20 分钟时选择一个报价
→ 验价前配置 Token；搜索后更换企业 Token 时，会重新获取报价并说明原因，请从新结果中重新选择后再验价（verify_offer）
→ 提供乘机人、旅行证件和联系人信息
→ 核对完整行程、价格和乘机人信息，并明确确认预订
→ 创建机票订单（create_booking）
→ 查询订单，仅在订单仍可支付时继续（query_order）
→ 选择支付方式，核对完整支付信息，并单独确认支付
→ 再次查询订单；只有信息未变化且订单仍可支付时，才创建一次支付链接（create_payment）
→ 按需查询订单或支付状态（query_order / query_payment）
选择航班只代表允许重新验价，不代表确认预订。如果搜索条件发生变化或距离搜索完成已经达到 20 分钟，Agent 会先征得同意再重新搜索。支付链接不代表已经支付成功或已经出票。Stripe 会额外收取 3.5% 且不可退款的处理费；WeChat Pay、Alipay 和 Online Banking 仅适用于 CNY 订单。
机票 Skill 当前支持机场查询、实时航班搜索与验价、预订、订单查询，以及第三方支付创建和查询。暂不执行机票取消、改签、发起退款、购买附加服务或人工出票操作；这些需求请联系机票客服。
Token 与安全说明
- 酒店和机票 Skill 共用同一个 TourMind Skill Token；每位用户只需申请一次，无需重复申请。
- 任一已安装的 Skill 需要鉴权时，Agent 都会将同一个 Token 保存到该 Skill 本地的
skill_token.txt中。所有 ToB Skill API 调用都必须使用对应本地文件中的 Token，你无需自行创建或编辑文件。 - 不要在 Prompt、日志、截图、URL、Git 提交或 Issue 中暴露完整 Token。
- 在 macOS 或 Linux 上，Agent 会执行
chmod 600 skill_token.txt，将 Token 文件权限限制为仅当前用户可读写。 - 收到 HTTP 401 或包含
unauthorized的认证响应时，Agent 会删除失效的本地 Token，并停止本次认证操作。单独的“权限未开通”响应不会被当作 Token 失效。 - 返回的酒店查询结果页面是只读的，在过期前可重复打开。
- 创建酒店或机票预订、取消符合条件的酒店订单或发起支付前，必须在已认证的 AI 对话中获得用户明确确认。
FAQ
帮助与支持
- 产品页面：tourmind.com/skills
- 申请 TourMind 账号和 Token：TourMind 申请页面
- GitHub 支持：提交 Issue
- 酒店支持：hotel@tourmind.com
- 机票 24 小时客服：flightcs1@tourmind.com
- 商务合作：bp@tourmind.com
- AI 产品合作：ai@tourmind.com
开源许可
MIT © 2026 TourMind