Travel Search
Search flights, hotels, car rentals, and ferries across multiple free providers via MCP protocol.
Quick Reference
| Need | Provider | Reference |
|---|
| Flights (creative routing) | Kiwi.com | flights.md |
| Flights + Hotels + Cars |
Skiplagged |
skiplagged.md |
| Hotels (price comparison) | Trivago |
hotels.md |
| Ferries | Ferryhopper |
ferries.md |
| Flights (Google Flights) | fli |
google-flights.md |
| Full trip itinerary | Multi-provider |
trip-planner.md |
| Best deal / price compare | Multi-provider |
price-tools.md |
| Airbnb / apartment stays | Airbnb MCP |
airbnb.md |
| Multi-city route optimizer | Multi-provider |
multi-city.md |
| Destination intel (weather, visa, transport) | General knowledge + wttr.in |
travel-intel.md |
How It Works
All providers use the MCP protocol (JSON-RPC 2.0 over HTTP). Call them with curl:
CODEBLOCK0
Response format: SSE with event: message + data: {JSON}. Parse the data line.
Decision Guide
User wants flights, hotels, cars, ferries, or trip planning
Read
price-tools.md for the
decision tree and comparison engine. It covers:
- - Which providers to search and when
- How to compare and score results across providers
- How to present the single best recommendation + alternatives
- Flexible dates, anywhere destinations, round-trip optimization
For full trip itineraries, also read trip-planner.md. It includes a guided intake questionnaire (7 quick questions in one message) for when users want help figuring out what they want.
User wants to visit multiple cities
Read
multi-city.md for route optimization. It finds the cheapest city order, allocates days, and handles open-jaw flights.
Core principle
Always search multiple providers, score results, and present ONE best recommendation with alternatives. The user should never have to compare — that's the agent's job. See
price-tools.md for the value scoring system.
Presenting Results
Use bullet lists (no markdown tables on Discord/WhatsApp). For each option show:
- - Route with stops (e.g., OVD → BCN → FCO)
- Times and duration
- Price
- Booking link
Group by: 💸 Cheapest → ⚡ Fastest → 🎯 Best value
Always include booking deep links so the user can act immediately.
Provider Endpoints
CODEBLOCK1
Notes
- - All Tier 1 providers are free, no API key needed
- Kiwi uses
dd/mm/yyyy date format - Skiplagged uses
YYYY-MM-DD date format - Always resolve city names to IATA codes first when using Skiplagged
- Rate limit: be reasonable, don't spam requests
- MCP sessions may expire; re-initialize if you get errors
旅行搜索
通过MCP协议，在多个免费提供商中搜索航班、酒店、租车和轮渡。
快速参考
Skiplagged |
skiplagged.md |
| 酒店（比价） | Trivago |
hotels.md |
| 轮渡 | Ferryhopper |
ferries.md |
| 航班（Google Flights） | fli |
google-flights.md |
| 完整行程规划 | 多提供商 |
trip-planner.md |
| 最佳优惠/比价 | 多提供商 |
price-tools.md |
| Airbnb/公寓住宿 | Airbnb MCP |
airbnb.md |
| 多城市路线优化 | 多提供商 |
multi-city.md |
| 目的地信息（天气、签证、交通） | 通用知识 + wttr.in |
travel-intel.md |
工作原理
所有提供商均使用MCP协议（基于HTTP的JSON-RPC 2.0）。通过curl调用：
bash
1. 初始化会话
curl -s -X POST $MCP_URL \
-H Content-Type: application/json \
-H Accept: application/json, text/event-stream \
-d {jsonrpc:2.0,id:1,method:initialize,params:{protocolVersion:2025-06-18,capabilities:{},clientInfo:{name:openclaw,version:1.0}}}
2. 从响应头中提取Mcp-Session-Id（如果返回）
3. 调用工具
curl -s -X POST $MCP_URL \
-H Content-Type: application/json \
-H Accept: application/json, text/event-stream \
-H Mcp-Session-Id: $SESSION_ID \
-d {jsonrpc:2.0,id:2,method:tools/call,params:{name:TOOL_NAME,arguments:{...}}}
响应格式：SSE，包含event: message + data: {JSON}。解析data行。
决策指南
用户需要航班、酒店、租车、轮渡或行程规划
阅读
price-tools.md了解
决策树和比价引擎。涵盖：
- - 何时搜索哪些提供商
- 如何跨提供商比较和评分结果
- 如何呈现单一最佳推荐及备选方案
- 灵活日期、任意目的地、往返优化
对于完整行程规划，还需阅读trip-planner.md。其中包含引导式需求问卷（一条消息内7个快速问题），适用于用户需要帮助明确需求的情况。
用户需要访问多个城市
阅读
multi-city.md了解路线优化。可找到最便宜的城市顺序、分配天数，并处理缺口航班。
核心原则
始终搜索多个提供商，对结果评分，呈现一个最佳推荐并附备选方案。用户无需自行比较——这是智能体的职责。评分系统详见
price-tools.md。
结果展示
使用项目符号列表（Discord/WhatsApp上不使用Markdown表格）。每个选项展示：
- - 含经停的路线（例如：OVD → BCN → FCO）
- 时间和时长
- 价格
- 预订链接
按以下顺序分组：💸 最便宜 → ⚡ 最快 → 🎯 最佳性价比
始终包含预订深度链接，方便用户立即操作。
提供商端点
Kiwi: https://mcp.kiwi.com
Skiplagged: https://mcp.skiplagged.com/mcp
Trivago: https://mcp.trivago.com/mcp
Ferryhopper: https://mcp.ferryhopper.com/mcp
注意事项
- - 所有一级提供商均免费，无需API密钥
- Kiwi使用dd/mm/yyyy日期格式
- Skiplagged使用YYYY-MM-DD日期格式
- 使用Skiplagged时，务必先将城市名称解析为IATA代码
- 速率限制：合理使用，避免频繁请求
- MCP会话可能过期；如遇错误请重新初始化
