← 返回 Skills 市场
ryan-zry

酒店机票预订

作者 赵瑞宇 · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
108
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install hotel-flight-booking
功能描述
Booking.com国际酒店预订助手,支持全球酒店搜索、房型查询、价格对比、预订管理。Invoke when user wants to search international hotels, book hotels on Booking.com, or manage Booking.com reservat...
使用说明 (SKILL.md)

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
}
安全使用建议
This skill appears to implement a Booking.com integration but has some gaps you should resolve before installing or running its code: 1) Confirm how the Booking API credentials will be provided — the code uses placeholders (BOOKING_API_KEY / BOOKING_AFFILIATE_ID) but the skill metadata doesn't declare required env vars; prefer supplying keys via well-named environment variables or a secure secret store rather than editing source files. 2) Review the Python files locally before execution (they call network endpoints and set an Authorization header). 3) Ask the publisher to clarify the meaning of the 'required' flag in SKILL.md metadata and to update the skill to declare required credentials and a safe install/run guide. 4) Because some API calls are stubbed with mock data, verify whether/when the code will perform live API requests and test in a controlled environment. If you don't trust the source, do not run the included Python code or provide real API keys until these questions are answered.
功能分析
Type: OpenClaw Skill Name: hotel-flight-booking Version: 1.0.0 The skill bundle is a well-structured template for integrating Booking.com services into an AI agent. The Python scripts (booking_api.py and openai_adapter.py) implement standard API wrappers and function-calling logic using mock data, with no evidence of data exfiltration, malicious execution, or prompt injection. All network calls are directed to the legitimate Booking.com distribution domain (distribution-xml.booking.com).
能力评估
Purpose & Capability
Name/description describe a Booking.com integration and the code implements a BookingApi wrapper plus an OpenAI adapter that exposes function-call handlers — that aligns with the declared purpose. However the SKILL.md and code state the skill must call Booking.com Affiliate API and use an API key, yet the skill metadata/requirements do not declare any required environment variables or primary credential. The provided booking_api.py contains placeholders (BOOKING_API_KEY, BOOKING_AFFILIATE_ID) instead of a clear mechanism for supplying secrets.
Instruction Scope
SKILL.md focuses on searching, details, room availability and reservations and explicitly requires using Booking.com Affiliate API and not fabricating data — this keeps scope narrow. The included Python modules follow that scope. A minor scope concern: many API calls are marked TODO and return simulated data, so runtime behavior may not actually contact Booking.com unless the code is changed; it's unclear whether/when the real network calls would run.
Install Mechanism
No install spec is provided (instruction-only/install-free). The skill includes Python source files but does not declare any package installs or external downloads. Risk from install mechanism is low, but running the included Python code will execute whatever network or filesystem operations it contains.
Credentials
The skill claims an API Key authentication model (SKILL.md) and booking_api.py defines BOOKING_API_KEY and BOOKING_AFFILIATE_ID, but requires.env is empty and no primary credential is declared. That mismatch is concerning: the skill needs sensitive credentials to operate correctly, yet it doesn't declare how those credentials should be supplied (env var, config file, or during setup). This gap can lead to accidental hardcoding or insecure handling of keys if implementers fill placeholders improperly.
Persistence & Privilege
Skill flags show no 'always: true' and no special OS or config path requirements. It does not request persistent system privileges or attempt to modify other skills or system-wide settings. Autonomous invocation is enabled by default but is not combined here with broad credential or privileged access.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install hotel-flight-booking
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /hotel-flight-booking 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.0
- Initial release of Booking.com International Hotel Booking Assistant - Supports global hotel search, room availability, price comparison, and reservation management - Multi-language and multi-currency display (e.g., CNY, USD, JPY) - Integration with official Booking.com Affiliate API only; displays data strictly as returned - Includes order creation, query, and cancellation functions - Clear response structure for both success and error cases
元数据
Slug hotel-flight-booking
版本 1.0.0
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 1
常见问题

酒店机票预订 是什么?

Booking.com国际酒店预订助手,支持全球酒店搜索、房型查询、价格对比、预订管理。Invoke when user wants to search international hotels, book hotels on Booking.com, or manage Booking.com reservat... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 108 次。

如何安装 酒店机票预订?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install hotel-flight-booking」即可一键安装,无需额外配置。

酒店机票预订 是免费的吗?

是的,酒店机票预订 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

酒店机票预订 支持哪些平台?

酒店机票预订 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 酒店机票预订?

由 赵瑞宇(@ryan-zry)开发并维护,当前版本 v1.0.0。

💬 留言讨论