amadeus-hotelsSearch hotel prices and availability via Amadeus API. Find vacation hotels by city, coordinates, or amenities. Compare prices, view ratings, get offer details. Track prices with alerts. Use when user asks to "find hotels", "search hotels in [city]", "hotel prices", "vacation accommodation", "hotel deals", "track hotel price".
Install via ClawdBot CLI:
clawdbot install kesslerio/amadeus-hotelsSearch hotel prices, availability, and ratings via the Amadeus Self-Service API. Perfect for vacation planning and deal hunting.
export AMADEUS_API_KEY="your-api-key"
export AMADEUS_API_SECRET="your-api-secret"
export AMADEUS_ENV="test" # or "production" for real bookingspip install requestsFree tier: ~2,000 requests/month in test, pay-per-use after in production.
| Task | Script | Example |
|------|--------|---------|
| Search by city | scripts/search.py | --city PAR --checkin 2026-03-15 --checkout 2026-03-20 |
| Get offers | scripts/offers.py | --hotels HTPAR123,HTPAR456 --adults 2 |
| Offer details | scripts/details.py | --offer-id ABC123 |
| Track price | scripts/track.py | --add --hotel HTPAR123 --target 150 |
| Check tracked | scripts/track.py | --check |
Find hotels by city code (IATA) or coordinates:
# By city
python3 <skill>/scripts/search.py --city PAR --checkin 2026-03-15 --checkout 2026-03-20
# By coordinates (near a landmark)
python3 <skill>/scripts/search.py --lat 48.8584 --lon 2.2945 --radius 5 --checkin 2026-03-15 --checkout 2026-03-20
# With filters
python3 <skill>/scripts/search.py --city NYC --amenities WIFI,POOL,SPA --ratings 4,5Common city codes: PAR (Paris), NYC (New York), TYO (Tokyo), BCN (Barcelona), LON (London), LAX (Los Angeles), SFO (San Francisco)
Once you have hotel IDs from search:
python3 <skill>/scripts/offers.py \
--hotels HTPAR001,HTPAR002 \
--checkin 2026-03-15 \
--checkout 2026-03-20 \
--adults 2 \
--rooms 1Returns: Room types, prices, cancellation policies, board types.
Get full details for a specific offer before booking:
python3 <skill>/scripts/details.py --offer-id <offer-id-from-search>Returns: Detailed room info, full cancellation policy, payment terms, hotel contact.
Get aggregated review sentiment:
python3 <skill>/scripts/details.py --hotel-id HTPAR001 --ratingsReturns: Overall score (0-100), category scores (Staff, Location, WiFi, Cleanliness, etc.)
Track hotels and get alerts when prices drop:
# Add hotel to tracking
python3 <skill>/scripts/track.py --add \
--hotel HTPAR001 \
--checkin 2026-03-15 \
--checkout 2026-03-20 \
--adults 2 \
--target 150 # Alert if price drops below $150/night
# Check all tracked hotels (run via cron)
python3 <skill>/scripts/track.py --check
# List tracked hotels
python3 <skill>/scripts/track.py --list
# Remove from tracking
python3 <skill>/scripts/track.py --remove --hotel HTPAR001Add to OpenClaw cron for automatic price monitoring:
# Check hotel prices twice daily
- schedule: "0 9,18 * * *"
task: "Run hotel price tracker and alert on drops"
command: "python3 <skill>/scripts/track.py --check"When prices drop below target, the script outputs alert text. Configure your notification channel in the cron task.
Scripts output JSON by default. Add --format human for readable output:
python3 <skill>/scripts/search.py --city PAR --format humanHuman format example:
šØ Hotel & Spa Paris Marais ā
ā
ā
ā
š 15 Rue du Temple, Paris
š° ā¬189/night (was ā¬220)
āØ WIFI, SPA, RESTAURANT
š Rating: 87/100 (Staff: 92, Location: 95)Common filters for --amenities:
| Code | Meaning |
|------|---------|
| WIFI | Free WiFi |
| POOL | Swimming pool |
| SPA | Spa/wellness |
| GYM | Fitness center |
| RESTAURANT | On-site restaurant |
| PARKING | Parking available |
| PETS_ALLOWED | Pet-friendly |
| AIR_CONDITIONING | A/C |
| KITCHEN | Kitchen/kitchenette |
Full list in references/amenities.md.
Amadeus API prices are NOT retail prices. The API returns negotiated, net, or wholesale rates ā not the public prices you see on Booking.com, Expedia, or hotel websites.
Key differences:
Use these prices for comparison and tracking trends, not as exact retail quotes. Actual booking prices on consumer sites will differ.
| Error | Meaning | Action |
|-------|---------|--------|
| 401 | Auth failed | Check API key/secret |
| 429 | Rate limited | Wait and retry (auto-handled) |
| 400 | Bad request | Check parameters (dates, codes) |
| No results | No availability | Try different dates or expand search |
references/amenities.md ā Full amenity code listGenerated Mar 1, 2026
A travel agency uses the skill to search hotels by city or coordinates for clients planning vacations. They filter by amenities like pools or spas, compare prices via offers, and track rates to alert clients when deals drop below target thresholds, enhancing service with proactive price monitoring.
A company's travel department leverages the skill to find hotels with specific amenities like WiFi and gyms for business trips. They use price tracking to monitor negotiated rates and ensure compliance with travel budgets, integrating cron jobs for automated alerts on cost savings.
A tech startup builds a website that aggregates hotel deals by using the skill to search and fetch pricing data via the Amadeus API. They compare offers across multiple hotels, display ratings and sentiment, and use tracking to update prices in real-time for users seeking budget accommodations.
An event planner uses the skill to book blocks of rooms for conferences by searching hotels in a city with amenities like parking and restaurants. They get detailed offer information to negotiate with hotels and track prices to optimize costs as the event date approaches.
Offer a premium service where users pay a monthly fee for access to hotel searches, price comparisons, and automated tracking alerts. Revenue comes from subscriptions, with tiers based on features like advanced filters or priority support, leveraging the skill's API integration for real-time data.
Integrate the skill into a website or app that redirects users to booking platforms after they find hotels. Earn commissions on completed bookings through affiliate links, using the skill's search and rating capabilities to attract traffic and provide value-added comparisons.
Resell access to the Amadeus API through a white-labeled version of this skill, offering customized solutions for travel agencies or corporations. Charge setup fees and ongoing licensing costs, with additional revenue from support and integration services tailored to client needs.
š¬ Integration Tip
Set up environment variables securely and use cron jobs for automated price tracking to enhance user engagement with timely alerts.
Foodora-only CLI for checking past orders and active order status (Deliveroo WIP).
Reorder Foodora orders + track ETA/status with ordercli. Never confirm without explicit user approval. Triggers: order food, reorder, track ETA.
Google Maps integration for OpenClaw with Routes API. Use for: (1) Distance/travel time calculations with traffic prediction, (2) Turn-by-turn directions, (3...
Flight tracking and scheduling. Track live flights in real-time by region, callsign, or airport using OpenSky Network. Search flight schedules between airports. Use for queries like "What flights are over Switzerland?" or "When do flights from Hamburg arrive in Zurich?" or "Track flight SWR123".
Use when the user asks to "find flights", "compare itineraries", "search hidden-city routes", "check cheapest dates", "explore destinations", "search hotels"...
Comprehensive travel planning, booking, and management skill. Use when needing to plan international trips, manage multi-destination itineraries, handle family travel logistics, optimize travel costs, and coordinate complex travel arrangements.