Amadeus Hotels

核心功能与用法

Amadeus Hotels 是一款面向旅行规划的专业酒店搜索工具，依托全球领先的Amadeus旅游数据平台，提供完整的酒店搜索-比价-追踪工作流。

核心能力

1. 多维度酒店搜索

• 支持IATA城市代码（如PAR、NYC、TYO）或GPS坐标+半径搜索
• 设施筛选：WiFi、泳池、SPA、健身房、宠物友好等
• 星级过滤：可限定4-5星高端酒店

2. 实时报价与库存查询

• 获取指定酒店的多房型实时价格
• 查看取消政策、餐食类型（含早/半膳/全膳）
• 支持多人多房组合查询

3. 智能价格追踪

• 设定目标价格阈值，自动监控降价
• 可通过cron定时任务实现无人值守监控
• 发现低价时输出告警，便于对接通知渠道

4. 酒店评价聚合

• 基于真实住客反馈的0-100分综合评分
• 细分维度：员工服务、位置、网络、清洁度

显著优点

• 数据来源权威：Amadeus是全球最大旅游分销系统(GDS)之一，覆盖全球超80万家酒店
• 免费额度充足：测试环境每月约2,000次调用，适合个人用户
• 输出格式友好：支持JSON/人类可读双模式，终端直接展示🏨星级图标和价格趋势
• 自动化就绪：价格追踪模块设计为cron友好，易于集成到现有工作流

潜在局限

• 不直接支持预订：API仅返回报价，实际支付需跳转至OTA或酒店官网完成（PCI合规要求）
• 测试/生产数据差异：测试环境数据为缓存/模拟，生产环境需额外审批和付费
• 速率限制严格：生产环境40 TPS，高频查询需实现退避机制
• 环境配置门槛：需注册Amadeus开发者账号并妥善保管API密钥

适合人群

• 频繁出差或度假的规划型旅行者
• 需要批量监控酒店价格的旅行代理/差旅管理者
• 希望自建价格提醒系统（替代Hopper、Google Hotels邮件提醒）的技术用户
• 开发旅行类应用的开发者（作为数据层原型验证）

常规风险

• API密钥泄露风险：密钥存储于环境变量，共享环境可能导致配额被盗用
• 价格波动风险：酒店价格实时变动，追踪结果≠锁定价格，最终预订时可能已上涨
• 测试环境误判：开发阶段若未切换至production，可能因缓存数据导致决策偏差
• 依赖单点故障：Amadeus服务中断或政策变更（如收紧免费额度）将影响可用性

---

技术栈：Python 3 + requests库 | 部署：OpenClaw技能框架 | 许可：需遵守Amadeus API使用条款

核心功能

Amadeus Hotels Skill 是一款基于Amadeus官方旅游API的命令行酒店搜索工具，专为旅行规划与价格敏感型用户设计。核心能力包括：

1. 多维度酒店搜索：支持IATA城市代码（如PAR、NYC）、地理坐标及半径搜索，可叠加设施过滤（WiFi、泳池、SPA等）和星级筛选
2. 实时比价与详情：获取房型报价、取消政策、早餐选项等完整信息，支持特定Offer详情查询
3. 智能价格追踪：可设置目标价格阈值，自动监控价格变动并通过cron定时任务推送降价提醒
4. 评分情感分析：基于真实评价的聚合评分（0-100分）及细分维度（位置、服务、清洁度等）

显著优势

• 权威数据源：直接对接Amadeus全球分销系统，覆盖主流国际酒店品牌与独立酒店
• 灵活输出格式：支持JSON（程序化集成）与Human readable（人工阅读）双模式
• 低门槛使用：免费测试环境每月约2,000次请求额度，适合个人开发者与轻度用户
• 隐私友好：不采集用户PII，API凭证仅通过环境变量管理

潜在局限

• 非完整预订链：仅提供比价与查询，实际预订需跳转至OTA或酒店官网完成，无法直接支付
• 数据时效性：测试环境数据存在缓存延迟，生产环境价格变动频繁需二次确认
• 地理覆盖限制：部分小众目的地或非标住宿（民宿、青旅）覆盖不足
• 中文支持有限：API返回内容为英文，国内酒店数据可能不如携程/美团等本土平台全面

适合人群

• 国际旅行规划者（尤其欧美、日韩、东南亚目的地）
• 价格敏感型用户，愿意设置追踪等待降价时机
• 开发者需要酒店数据API进行工具开发或数据分析
• 习惯命令行操作的技术型用户

常规风险提示

1. API凭证安全：务必通过环境变量注入，禁止硬编码；生产环境密钥泄露可能导致费用损失
2. 价格确认义务：API返回价格仅供参考，实际预订前务必在目标平台二次核实
3. 测试/生产环境切换：AMADEUS_ENV配置错误可能导致获取缓存数据或产生意外费用
4. 速率限制：生产环境40TPS限制，高频调用需实现退避重试机制

技术可靠性

经安全认证（CLS-2026-0517-KAH-1.0.1），代码结构清晰，无危险函数调用，网络通信仅限于Amadeus官方域名，依赖单一且可信（requests库），总体安全评级A级（92分），属于T2级可信社区项目。