旅行预订助手

---

name: fb-booking-skill description: Booking.com国际酒店预订助手，支持全球酒店搜索、房型查询、价格对比、预订管理。Invoke when user wants to search international hotels, book hotels on Booking.com, or manage Booking.com reservations. version: 1.0.0 metadata: {"openclaw": {"emoji": "🌍", "category": "travel", "tags": ["Booking", "国际酒店", "海外酒店", "缤客", "全球预订"], "requires": {"bins": ["python3"]}, "required": true}}

---

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. 展示格式示例：

   🌍 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, checkout | | get_booking_hotel_detail | 获取酒店详情 | hotel_id, language | | get_booking_room_availability | 查询房型可用性 | hotel_id, checkin, checkout | | get_booking_reviews | 获取酒店评论 | hotel_id, language |

二、预订类接口

| 接口名称 | 核心用途 | 必选参数 | |---------|---------|---------| | create_booking_reservation | 创建预订 | hotel_id, room_id, guest_info | | get_booking_reservation | 查询预订 | reservation_id | | cancel_booking_reservation | 取消预订 | reservation_id |

数据字段说明

酒店信息

{
  "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
}

房型信息

{
  "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 | 港币 |

响应规则

成功响应

{
  "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"
      }
    ]
  }
}

失败响应

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