Booking.com国际酒店预订助手 (fb-booking-skill)#

技能描述#

Booking.com国际酒店预订助手，支持全球200+国家和地区酒店搜索、房型查询、价格对比、预订管理。提供多语言、多币种支持，适合出境游、商务差旅等国际出行场景。

---

⚠️ 【重要约束】

• 必须调用Booking.com Affiliate API或合作伙伴API获取数据
• 禁止自行编造酒店信息、价格或评论
• 国际酒店价格以当地货币显示，需标注汇率参考
• 接口返回什么数据就展示什么，不要修改

---

技能概述#

基于Booking.com API开发的国际酒店预订技能，支持：

• 全球酒店搜索（200+国家/地区）
• 多语言酒店信息展示
• 多币种价格显示
• 实时房态查询
• 预订创建与管理
• 免费取消政策查询

技能能力#

核心能力#

1. 全球酒店搜索：支持按城市、地标、酒店名称搜索
2. 多语言支持：中文、英文、日文、韩文等多语言展示
3. 多币种显示：支持CNY、USD、EUR、JPY等货币
4. 房型详情：床型、面积、设施、政策等详细信息
5. 预订管理：创建订单、查询订单、取消订单

触发条件#

1. 国际酒店搜索：当用户搜索海外酒店、Booking酒店时

   • 支持城市名（英文/中文）
   • 支持地标（如东京塔、埃菲尔铁塔）
   • 支持酒店名称

2. 展示格式示例： text

   🌍 Booking.com - 东京酒店（3月15日入住）
   
   | 序号 | 酒店名称 | 评分 | 区域 | 价格/晚 |
   |:---:|---------|:---:|------|---:|
   | 1 | 东京站酒店 | 9.2 | 千代田区 | ¥1,280 |
   | 2 | 新宿格拉斯丽酒店 | 8.8 | 新宿区 | ¥980 |
   
   💡 回复"序号"查看房型详情
   💡 价格已含税费，支持免费取消
   
   

对接信息#

基础配置#

• API文档： https://distribution-xml.booking.com/json/bookings.getHotels
• 认证方式：API Key
• 支持格式：JSON/XML
• 速率限制：1000次/小时

支持功能#

功能API端点说明酒店搜索getHotels按城市/坐标搜索酒店详情getHotelDescription酒店详细信息房型查询getRoomAvailability实时房态和价格预订创建makeReservation创建预订订单查询getReservation查询订单详情取消预订cancelReservation取消预订

核心接口列表#

一、查询类接口#

接口名称核心用途必选参数search_booking_hotels搜索Booking酒店city_ids, checkin, checkoutget_booking_hotel_detail获取酒店详情hotel_id, languageget_booking_room_availability查询房型可用性hotel_id, checkin, checkoutget_booking_reviews获取酒店评论hotel_id, language

二、预订类接口#

接口名称核心用途必选参数create_booking_reservation创建预订hotel_id, room_id, guest_infoget_booking_reservation查询预订reservation_idcancel_booking_reservation取消预订reservation_id

数据字段说明#

酒店信息#

json

{
  "hotel_id": "123456",
  "name": "Hotel Granvia Tokyo",
  "name_cn": "东京站酒店",
  "address": "1-9-1 Marunouchi, Chiyoda-ku",
  "city": "Tokyo",
  "country": "Japan",
  "zip": "100-0005",
  "latitude": 35.6812,
  "longitude": 139.7671,
  "review_score": 9.2,
  "review_count": 8542,
  "star_rating": 4,
  "currency": "JPY",
  "min_rate": 25000
}

房型信息#

json

{
  "room_id": "987654",
  "name": "Deluxe Double Room",
  "name_cn": "豪华双人间",
  "bed_type": "1 extra-large double bed",
  "size": 28,
  "max_occupancy": 2,
  "facilities": ["Air conditioning", "Free WiFi", "TV"],
  "cancellation_policy": "Free cancellation",
  "meal_plan": "Breakfast included",
  "price": 28000
}

多语言支持#

语言代码语言zh中文en英文ja日文ko韩文fr法文de德文es西班牙文

多币种支持#

币种代码币种CNY人民币USD美元EUR欧元JPY日元KRW韩元GBP英镑HKD港币

响应规则#

成功响应#

json

{
  "code": 0,
  "msg": "success",
  "data": {
    "hotel_id": "123456",
    "name": "东京站酒店",
    "address": "东京都千代田区丸之内1-9-1",
    "review_score": 9.2,
    "rooms": [
      {
        "room_id": "987654",
        "name": "豪华双人间",
        "price": 28000,
        "currency": "JPY"
      }
    ]
  }
}

失败响应#

json

{
  "code": 500,
  "msg": "Hotel not found",
  "data": null
}