← Back to Skills Marketplace
ryan-zry

差旅预订助手

by 赵瑞宇 · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
97
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install business-travel-booking
Description
Booking.com国际酒店预订助手,支持全球酒店搜索、房型查询、价格对比、预订管理。Invoke when user wants to search international hotels, book hotels on Booking.com, or manage Booking.com reservat...
README (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
}
Usage Guidance
This skill claims to fetch live data from Booking.com but the packaged code uses placeholder credentials and returns mocked results; the SKILL.md also requires an API Key yet the skill does not declare any required environment variables or a way to provide credentials. Before installing or using: (1) confirm the skill's source and trustworthiness; (2) ask the author to make credential handling explicit and secure (e.g., require BOOKING_API_KEY and BOOKING_AFFILIATE_ID as env vars or platform secrets rather than hard-coding); (3) verify that the skill actually performs live API calls and does not present mocked or fabricated data; (4) avoid editing source to insert secrets — prefer a secure secret injection mechanism; (5) if you need live booking capability, request a version that documents authentication, rate limits, and returns real API responses. If you cannot confirm these, treat the skill as unreliable and do not provide real credentials.
Capability Analysis
Type: OpenClaw Skill Name: business-travel-booking Version: 1.0.0 The skill bundle is a legitimate template for a Booking.com hotel booking assistant. The Python scripts (booking_api.py and openai_adapter.py) provide a structured wrapper for the Booking.com Affiliate API and map these functions for use with an AI agent. While the actual network calls are currently commented out and replaced with mock data (requiring the user to provide their own API keys), the code contains no evidence of malicious intent, data exfiltration, or unauthorized command execution.
Capability Assessment
Purpose & Capability
The skill's name and description state it uses Booking.com Affiliate/API data, but the shipped code contains BOOKING_API_KEY and BOOKING_AFFILIATE_ID set to placeholder strings and many API calls are marked TODO or return mocked data (e.g., search_hotels returns mock_hotels). The skill does not declare any required environment variables or a primary credential even though the SKILL.md explicitly says an API Key (affiliate) is required. This is a clear mismatch between claimed capability (live Booking.com integration) and actual delivered capability (mocked/stubbed behavior).
Instruction Scope
SKILL.md instructs the agent must call Booking.com Affiliate API and not fabricate data, but the included implementation purposely returns simulated data and leaves real API calls as TODO. The instructions and the code contradict each other: the agent may be expected to present live data but the code will return mock content unless credentials and code changes are applied. The SKILL.md does not specify how credentials should be provided at runtime (no env var or config path declared).
Install Mechanism
There is no install spec (instruction-only install), and the only binary requirement is python3. No external downloads or archive extraction are defined. The risk from installation mechanics is low.
Credentials
The skill logically requires Booking.com credentials (SKILL.md and booking_api.py reference an API key and affiliate ID), yet requires.env is empty and no primary credential is declared. Credentials are hard-coded as placeholders in booking_api.py instead of being read from environment variables or a declared config path. This omission forces insecure workarounds (editing source to add keys) or will result in the skill using mocked data — either case is problematic.
Persistence & Privilege
The skill does not request always:true, has no OS restrictions, and does not appear to modify other skills or system-wide agent settings. Autonomous invocation remains enabled (platform default) but is not combined with other high-risk indicators here.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install business-travel-booking
  3. After installation, invoke the skill by name or use /business-travel-booking
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Booking.com国际酒店预订助手首发上线: - 支持全球200+国家和地区酒店搜索与预订 - 多语言、多币种展示酒店信息与价格 - 实时房型查询及免费取消政策展示 - 订单创建、查询与取消管理功能 - 严格依托Booking.com官方API,确保数据权威可靠
Metadata
Slug business-travel-booking
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is 差旅预订助手?

Booking.com国际酒店预订助手,支持全球酒店搜索、房型查询、价格对比、预订管理。Invoke when user wants to search international hotels, book hotels on Booking.com, or manage Booking.com reservat... It is an AI Agent Skill for Claude Code / OpenClaw, with 97 downloads so far.

How do I install 差旅预订助手?

Run "/install business-travel-booking" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is 差旅预订助手 free?

Yes, 差旅预订助手 is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does 差旅预订助手 support?

差旅预订助手 is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created 差旅预订助手?

It is built and maintained by 赵瑞宇 (@ryan-zry); the current version is v1.0.0.

💬 Comments