fb-booking-skill

# 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 | ## 数据字段说明 ### 酒店信息 ```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 } ```