knownasnaffy Booking.com国际酒店预订助手 (fb-booking-skill)
技能描述
Booking.com国际酒店预订助手，支持全球200+国家和地区酒店搜索、房型查询、价格对比、预订管理。提供多语言、多币种支持，适合出境游、商务差旅等国际出行场景。
⚠️ 【重要约束】
- 必须调用Booking.com Affiliate API或合作伙伴API获取数据
- 禁止自行编造酒店信息、价格或评论
- 国际酒店价格以当地货币显示，需标注汇率参考
- 接口返回什么数据就展示什么，不要修改
技能概述
基于Booking.com API开发的国际酒店预订技能，支持：
- 全球酒店搜索（200+国家/地区）
- 多语言酒店信息展示
- 多币种价格显示
- 实时房态查询
- 预订创建与管理
- 免费取消政策查询
技能能力
核心能力
- 全球酒店搜索：支持按城市、地标、酒店名称搜索
- 多语言支持：中文、英文、日文、韩文等多语言展示
- 多币种显示：支持CNY、USD、EUR、JPY等货币
- 房型详情：床型、面积、设施、政策等详细信息
- 预订管理：创建订单、查询订单、取消订单
触发条件
国际酒店搜索：当用户搜索海外酒店、Booking酒店时
- 支持城市名（英文/中文）
- 支持地标（如东京塔、埃菲尔铁塔）
- 支持酒店名称
展示格式示例：
🌍 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
}