Skills travel-search

Find the best travel deals by searching and comparing flights, hotels, Airbnb stays, car rentals, and ferries across multiple providers simultaneously. Smart value scoring picks the optimal price-quality-convenience balance automatically. Plan complete trip itineraries with real prices and direct booking links. Use when: user asks about flights, travel, hotels, accommodation, Airbnb, apartments, villas, car rentals, ferry routes, trip planning, vacation planning, itinerary generation, finding cheap flights, best deals, comparing travel options, flexible dates, cheapest time to fly, price calendars, planning multi-city routes, or budget travel. Covers Kiwi.com (flights), Skiplagged (flights + hotels + cars), Trivago (hotels), Ferryhopper (ferries), optional Airbnb via local MCP, and Google Flights via fli. All primary providers are free with no API key required.

install
source · Clone the upstream repo
git clone https://github.com/openclaw/skills
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/adrianetti/travel-search" ~/.claude/skills/openclaw-skills-travel-search && rm -rf "$T"
OpenClaw · Install into ~/.openclaw/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.openclaw/skills && cp -r "$T/skills/adrianetti/travel-search" ~/.openclaw/skills/openclaw-skills-travel-search && rm -rf "$T"
manifest: skills/adrianetti/travel-search/SKILL.md
source content

Travel Search

Search flights, hotels, car rentals, and ferries across multiple free providers via MCP protocol.

Quick Reference

NeedProviderReference
Flights (creative routing)Kiwi.comflights.md
Flights + Hotels + CarsSkiplaggedskiplagged.md
Hotels (price comparison)Trivagohotels.md
FerriesFerryhopperferries.md
Flights (Google Flights)fligoogle-flights.md
Full trip itineraryMulti-providertrip-planner.md
Best deal / price compareMulti-providerprice-tools.md
Airbnb / apartment staysAirbnb MCPairbnb.md
Multi-city route optimizerMulti-providermulti-city.md
Destination intel (weather, visa, transport)General knowledge + wttr.intravel-intel.md

How It Works

All providers use the MCP protocol (JSON-RPC 2.0 over HTTP). Call them with

curl
:

# 1. Initialize session
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. Extract Mcp-Session-Id from response headers (if returned)

# 3. Call a tool
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":{...}}}'

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

Kiwi:        https://mcp.kiwi.com
Skiplagged:  https://mcp.skiplagged.com/mcp
Trivago:     https://mcp.trivago.com/mcp
Ferryhopper: https://mcp.ferryhopper.com/mcp

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