阿玛迪斯酒店查询技能 🏨

通过阿玛迪斯自助服务API搜索酒店价格、空房情况和评分。非常适合假期规划和寻找优惠。

设置

1. 获取API凭证请访问https://developers.amadeus.com/self-service

   

   • 创建账户 → 我的应用 → 创建新应用
   • 复制API密钥和API密钥机密

2. 设置环境变量：

export AMADEUS_API_KEY="your-api-key"
export AMADEUS_API_SECRET="your-api-secret"
export AMADEUS_ENV="test"  # or "production" for real bookings

3. 安装依赖：

pip install requests

免费套餐：测试环境每月约2,000次请求，生产环境按使用量付费。

快速参考

功能

1. 酒店搜索

通过城市代码（IATA）或坐标查找酒店：

# 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,5

常用城市代码：PAR（巴黎）、NYC（纽约）、TYO（东京）、BCN（巴塞罗那）、LON（伦敦）、LAX（洛杉矶）、SFO（旧金山）

2. 获取定价与可用性

一旦从搜索中获取到酒店ID：

python3 <skill>/scripts/offers.py \
  --hotels HTPAR001,HTPAR002 \
  --checkin 2026-03-15 \
  --checkout 2026-03-20 \
  --adults 2 \
  --rooms 1

返回：房型、价格、取消政策、膳食类型。

3. 优惠详情

预订前获取特定优惠的完整详情：

python3 <skill>/scripts/details.py --offer-id <offer-id-from-search>

返回：详细房间信息、完整取消政策、付款条款、酒店联系方式。

4. 酒店评分与情感分析

获取汇总的评论情感：

python3 <skill>/scripts/details.py --hotel-id HTPAR001 --ratings

返回：总体评分（0-100），分类评分（员工、位置、WiFi、清洁度等）

5. 价格追踪

追踪酒店并在价格下降时获取提醒：

# 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设置

添加到OpenClaw的cron中以实现自动价格监控：

# 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"

当价格降至目标以下时，脚本会输出提醒文本。在cron任务中配置您的通知渠道。

输出格式

脚本默认输出JSON。添加--format human以获得可读输出：

python3 <skill>/scripts/search.py --city PAR --format human

人类可读格式示例：

🏨 Hotel & Spa Paris Marais ★★★★
   📍 15 Rue du Temple, Paris
   💰 €189/night (was €220)
   ✨ WIFI, SPA, RESTAURANT
   📊 Rating: 87/100 (Staff: 92, Location: 95)

设施代码

常见过滤器用于--amenities：

完整列表位于参考资料/设施.md。

⚠️ 重要：价格免责声明

Amadeus API 价格并非零售价格。该 API 返回的是协议价、净价或批发价——而非您在 Booking.com、Expedia 或酒店官网上看到的公开价格。

主要区别：

• 净价与零售价：API 返回的是"净价"（原始成本），而非加价后的零售价格
• B2B定价：专为旅行社/开发者设计，可自行添加利润空间
• 协议价格：可能包含不向普通消费者开放的企业或联盟协议价
• 税费明细：价格通常区分显示基础价与税费

请将此类价格用于市场比对与趋势追踪，而非作为精确零售报价。消费者平台的实际预订价格会存在差异。

限制与说明

• 测试环境：数据受限/缓存性质，非实时更新。适用于开发阶段。
• 生产环境：获取真实价格需在Amadeus控制台执行"移至生产环境"操作。
• 非直接预订：API仅返回报价详情，实际预订需另行处理支付流程（需符合PCI合规标准）。
• 速率限制：测试环境10TPS，生产环境40TPS。脚本内置退避机制。
• 数据时效性：价格变动频繁。通过其他渠道预订前务必重新核价。
• 非零售价格：请参阅上方的定价免责声明。

错误处理

参考资料

• references/amenities.md— 完整的便利设施代码列表
• https://developers.amadeus.com/self-service/apis-docs— 官方API文档