Search 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 with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
A direct command skips the review prompt. Inspect the source before running it.
Search 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".
# 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 HTPAR001
Cron Setup for Price Alerts
Add 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.
Output Formatting
Scripts output JSON by default. Add --format human for readable output:
python3 <skill>/scripts/search.py --city PAR --format human
Human 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)
Amenity Codes
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.
⚠️ Important: Pricing Disclaimer
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:
Net vs Retail: API returns "net rates" (raw cost), not marked-up retail prices
B2B Pricing: Designed for travel agencies/developers to add their own markup
Negotiated Rates: May include corporate or consortia rates unavailable to consumers
Tax Breakdown: Prices often show base + taxes separately
Use these prices for comparison and tracking trends, not as exact retail quotes. Actual booking prices on consumer sites will differ.
Limitations & Notes
Test environment: Limited/cached data, not real-time. Good for development.
Production: Real prices but requires "Move to Production" in Amadeus dashboard.
No direct booking: API returns offer details; actual booking requires payment handling (PCI compliance).
