К основному содержанию
скилл CX Codex

rollinggo-hotel-booking — скилл для Claude Code: обзор и установка

Скилл rollinggo-hotel-booking для Claude Code ищет отели, сравнивает цены на номера, оформляет бронирование и отменяет заказы через API RollingGo.

MIT 6 установок ★ 6 обновлён 2026-10-14

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add RollingGo-AI/rollinggo-hotel-skill-global --skill rollinggo-hotel-booking -a claude-code
Открыть на GitHub

Что делает rollinggo-hotel-booking

Скилл подключает агента к API бронирования отелей RollingGo через CLI-утилиту rgg. Агент может находить гостиницы по городам, достопримечательностям или станциям метро, фильтровать варианты по бюджету, звёздам и удобствам вроде бассейна или завтрака, а также проверять доступные номера и сопровождать процесс заказа.

Для работы скилла в окружении необходима команда rgg. Инструмент устанавливают через npm пакетом @rollinggo/hotel-global@latest, запускают готовый скрипт python scripts/install.py либо вручную размещают бинарный файл в PATH. Без установленной утилиты rgg запросы к каталогу гостиниц завершатся ошибкой.

Какие задачи решает

  • найти отели рядом с нужной локацией или станцией метро
  • отфильтровать гостиницы по бюджету, звёздам и наличию бассейна
  • сравнить цены и категории свободных номеров в реальном времени
  • оформить бронирование или узнать штраф перед отменой заказа

Примеры запросов агенту

  • Найди отели рядом с Санлитуном в Пекине с бассейном и завтраком
  • Сравни цены на двухместные номера в этих двух гостиницах
  • Проверь статус заказа и рассчитай штраф при отмене брони

Как установить rollinggo-hotel-booking

1Через Skills CLI (Vercel)

npx skills add RollingGo-AI/rollinggo-hotel-skill-global --skill rollinggo-hotel-booking -a claude-code

2Вручную: положить файлы

~/.claude/skills/rollinggo-hotel-booking/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/rollinggo-hotel-booking/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о rollinggo-hotel-booking

Как установить rollinggo-hotel-booking в Claude Code?

Выполните команду npx skills add RollingGo-AI/rollinggo-hotel-skill-global --skill rollinggo-hotel-booking -a claude-code в терминале.

Что делает rollinggo-hotel-booking?

Скилл ищет гостиницы через API RollingGo, сравнивает тарифы, помогает забронировать номер и рассчитывает штрафы при отмене заказа.

Какая зависимость нужна для работы скилла?

В системе должна быть установлена утилита rgg. Её можно поставить через npm install -g @rollinggo/hotel-global@latest или запуском python scripts/install.py.

Исходный текст

SKILL.md · MIT
---
name: rollinggo-hotel-booking
version: "1.1.5"
repository: "https://github.com/RollingGo-AI/hotel-skill-global"
description: 'RollingGo Hotel Search & Booking Assistant. Implements the full hotel booking and order management workflow by calling RollingGo hotel APIs. Supported scenarios: ① Search hotels by city, attraction, metro, airport, etc. ② Filter by star rating, budget, tags (pool, breakfast, family, pet-friendly) ③ Query real-time room types and prices for specific hotels ④ Compare multiple hotels ⑤ Guide users to complete booking ⑥ Cancel Order (pre-cancel penalty inquiry & confirm-cancel). Triggers: Find a hotel, book a hotel, search hotels, hotel recommendation, hotel queries, nearby hotels, five-star hotels, homestays, resorts, check prices, check room types, check-in, where to stay, accommodation, rollinggo, travel accommodation, business trip accommodation, family hotels, hotels with a pool, hotels with breakfast, cancel order, cancel booking, refund hotel, cancel hotel reservation.'
metadata:
  {
    "openclaw": {
      "emoji": "🏨",
      "skillKey": "rollinggo-hotel-booking",
      "requires": {
        "anyBins": ["rgg", "npx", "node", "python", "python3", "curl", "wget"]
      },
      "install": [
        {
          "id": "node",
          "kind": "node",
          "package": "@rollinggo/hotel-global@latest",
          "bins": ["rgg"],
          "label": "Install @rollinggo/hotel-global (npm)"
        },
        {
          "id": "python",
          "kind": "exec",
          "command": "python scripts/install.py",
          "label": "Install rgg standalone binary (python)"
        }
      ]
    }
  }
---

# RollingGo Hotel Search & Booking Skill

## Installation

If the `rgg` command is not installed locally, you can install it using one of the following three methods:

**Method 1: Via npm (Recommended)**
If Node.js and npm are available, run:
```bash
npm install -g @rollinggo/hotel-global@latest
```

**Method 2: Via Python auto-script (No Node.js needed)**
If Python is available in the environment, you can directly run our automated installation script from the Skill directory. It will automatically detect your OS and download the latest standalone `rgg` binary to your local `bin` folder:
```bash
python scripts/install.py
```

**Method 3: Manual download standalone executable (No Node/Python needed)**
If neither npm nor Python is available, please download the corresponding standalone executable from the following Release page (Windows: `rgg-win.exe` / `rgg-windows.exe`, Mac: `rgg-macos`, Linux: `rgg-linux`):
`https://github.com/RollingGo-AI/oauth-hotel-cli-overseas/releases/latest`

After downloading, rename it to `rgg` (or `rgg.exe` on Windows), grant execution permissions, and place it in the system PATH or the skill directory's `bin` folder.

**⚠️ Auto-Update Interception Principle:**
The CLI tool has built-in version detection. When you execute any `rgg` command, if the console output prompts `📦 New version available!` or `Run the following command to update`, **you must immediately pause the current operation, use one of the above three methods to upgrade the tool to the latest version, and then re-execute the interrupted command.** This prevents booking failures due to expired server endpoints.

---

> ⚠️ **Output Specifications**:
> 1. **DO NOT show any technical details to users**, including but not limited to: tool names (like `search-hotels`, `hotel-detail`), JSON field names (like `hotelId`, `ratePlanId`, `referenceNo`), command line contents, or technical parameters.
> 2. **ONLY show information users care about**: Hotel name, star rating, price, distance, core facilities, tags, and booking link.
> 3. **Results MUST be formatted properly**, with each hotel occupying a separate card. Key information should be separated by line breaks, and stacking them in a single line is prohibited.
> 4. **Price Description**: Prices in search results are reference prices for display purposes. The actual order price is subject to price confirmation, and it must be labeled as "Reference Price" when displayed.
> 5. **Login Authorization**: The user cannot see terminal outputs when conversing via the Agent. After executing `rgg login`, you must extract the authorization link from the output and reply to the user with it. Do not display QR code text.

## When to Use

This Skill should be triggered whenever the user expresses any intent related to hotel accommodations, including but not limited to the following scenarios:

**Search and Discover**:
- Find hotels by location: "Help me find a hotel near Sanlitun, Beijing", "What good hotels are in Sanya", "Accommodation recommendations near West Lake"
- Filter by conditions: "Five-star hotels", "Hotels with a pool", "Accommodations with breakfast", "Family hotels", "Pet-friendly hotels"
- Filter by budget: "Hotels under 500 yuan", "Affordable accommodations", "Luxury hotel recommendations"
- Filter by brand: "Hilton", "Marriott", "Atour", "Ji Hotel"

**Query and Compare**:
- Check prices: "How much is a hotel in Hangzhou per night", "What's the price of this hotel"
- Check room types: "What room types are available", "Are there double rooms", "Family room recommendations"
- Compare accommodations: "Help me compare these two hotels", "Which one is a better deal"
- Check facilities: "Is there a pool", "How far is the metro station", "Is parking convenient"

**Booking and Orders**:
- Book a hotel: "Help me book this hotel", "I want to place an order", "Book a room"
- Query Orders: "My orders", "Previously booked hotels", "Order status"
- Cancellation & Refunds: "Cancel this order", "Refund hotel booking", "Check cancellation penalty fee"

**Trigger Coverage**:
Find a hotel, book a hotel, search hotels, hotel recommendations, hotel queries, nearby hotels, five-star hotels, homestays, resorts, check prices, check room types, check-in, where to stay, accommodation, business trip accommodation, travel accommodation, family hotels, hotels with a pool, hotels with breakfast, business hotels, couple hotels, hot spring hotels, sea view rooms, river view rooms, cancel order, cancel booking, refund hotel, cancel hotel reservation.

## When NOT to Use

- When the user asks about flights, train tickets, car rentals, attraction tickets, or other non-accommodation travel needs.
- When the user is just chatting about travel destinations without clear accommodation intent.
- When the user explicitly states "No need to book" or "Just asking".

---

## Security Gates

> ⚠️ Hotel booking and cancellation involve **actual financial and consumption operations**:
> 1. **Two-Step Confirmation**: First display room types and prices, wait for user confirmation before locking price and booking.
> 2. **Information Completeness**: Must confirm guest's English/Pinyin name and email before booking.
> 3. **Price Confirmation Validity**: Locked price certificate (`referenceNo`) is valid for ~15-30 minutes; re-confirm if expired.
> 4. **Cancellation High-Risk Security Gate (Two-Step Confirmation)**: Order cancellation is **strictly irreversible**. Never submit cancellation without explicit user consent. Must execute `pre-cancel` first to check penalty fees and retrieve voucher (`confirmId`, valid 10 minutes), present the penalty and estimated refund to the user, and only execute `confirm-cancel` upon explicit affirmative user confirmation.

---

## Workflow & Dynamic CLI Discovery

> 💡 **Dynamic Command & Parameter Self-Discovery Rule**:
> 1. **Native Invocation**: Directly call native CLI commands: `rgg <subcommand>` (e.g. `rgg status`, `rgg search-hotels`).
> 2. **Partner Customization (CLIENT_ID)**: Supports zero-code partner customization. If a customized client ID is needed, place a `client_id.txt` file in the skill directory, or pass `rgg login --client-id <id>` on login (e.g. `rgg login --client-id my_partner_id`). The CLI remembers and persists this setting automatically. The default is `rollinggoglobal`.
> 3. **Dynamic Parameter Self-Discovery**: Before executing any subcommand, **ALWAYS run `rgg <subcommand> --help` first to fetch real-time CLI parameter help**, and dynamically construct options based on the latest `--help`!

---

### Business Step Guide

#### Step 0: Login Auth Check
- Run `rgg status` (or `whoami`) to check login status.
- If not logged in, run `rgg login` (add `--client-id <id>` if partner custom ID is needed, ⚠️ **MUST run asynchronously in background**, e.g. `WaitMsBeforeAsync=2000`). Extract authorization link (`https://api.rollinggo.store/s/xxx`) from output and send to user.

#### Step 1: Information Collection
- Confirm Destination (Mandatory), Check-in Date (Default: Tomorrow), Stay Nights (Default: 1 night), Adult Count (Default: 2).

#### Step 2: Get Tag Dictionary (As needed)
- When user mentions specific features (pool, breakfast, family, pet), run `rgg hotel-tags` to find exact tag names.

#### Step 3: Search Hotels
- Run `rgg search-hotels --help` first to inspect current filter parameters, then construct command.
- **placeType Selection Rules** (Must match exactly): `city`, `airport`, `point_of_interest`, `train_station`, `subway_station`, `hotel`, `district/county`, `detailed address`.

**Search Result Card Template** (one card per hotel):
*(CRITICAL: You MUST render the `imageUrl` using standard Markdown image syntax `![alt](url)` and place the image at the end of the template. If `imageUrl` contains unencoded spaces, you must manually replace spaces with `%20`, or wrap the entire URL in angle brackets like `![alt](<url>)` to ensure proper markdown rendering. Do NOT use HTML `<img>` tags and Do NOT output raw URL strings.)*

```markdown
🏨 {Hotel Name}
⭐ {Star Rating} Stars  *(Show if distanceInMeters exists: 📍 {distanceInMeters}m from {Search Location})*
💰 Reference Price {Currency} {Lowest Price}/night
🏷️ {Tag 1} · {Tag 2} · {Tag 3}
![{Hotel Name}]({imageUrl})
```

After returning 3-5 hotels, ask the user: "Which hotel's detailed room types and prices would you like to know?"

#### Step 4: Query Room Types & Real-time Prices
- Run `rgg hotel-detail --help` first, pass selected `hotelId` to fetch room rates.

**Room Type Display Template** (one entry per room type):

```
🛏️ {Room Type Name} ({Bed Type Description})
💰 Total Price {Currency} {totalPrice} ({Currency} {Average Price}/night)
📋 Cancellation Policy: {Cancellation Policy Description}
```

After displaying 3-5 recommended room types, guide the user via conversation: "Please tell me which room type you choose, and I will lock the price and process the order for you."

#### Step 5: Price Confirmation & Booking (Security Gate)
1. Run `rgg price-confirm --help` first, lock price and retrieve `referenceNo`.
2. Confirm guest name & email, run `rgg book --help` to submit order and retrieve payment link.

**Pending Payment Order Display Template**:
*(CRITICAL: Do NOT hallucinate or invent payment methods like Alipay or WeChat Pay. Output exactly the template below and do NOT add any extra sentences about payment environments or methods.)*

```
📝 Order generated, awaiting payment!
Confirmation No: **{orderNo}**
Hotel: {Hotel Name}
Room Type: {Room Type Name}
Check-in: {Check-in Date} | Check-out: {Check-out Date}
Total Price: {Currency} {Price}
📋 Cancellation Policy: {Cancellation Policy Description}
💳 Please complete payment within 30 minutes: {Payment Link}
```

#### Step 6: Query Orders & Details
- Run `rgg orders --help` or `rgg order-detail --help` to query order list or specific order status.

#### Step 7: Cancel Order (High-Risk Two-Step Confirmation)
> ⚠️ **Critical Security Gate**: Cancelling an order is **strictly irreversible**! You must follow the two-step confirmation process:
> 1. Always call `pre-cancel` first to query cancellation penalty fees and the authorization voucher (`confirmId`, valid for 10 minutes).
> 2. Truthfully inform the user about the penalty amount and expected refund. **Only after receiving the user's explicit affirmative confirmation** can you run `confirm-cancel` to submit the cancellation.

1. **Pre-cancel & Query Penalty Fees**:
   - Run `rgg pre-cancel --help` to check parameters.
   - If user hasn't provided an order number, run `rgg orders` first to identify the order number.
   - Run `rgg pre-cancel --order-no <orderNo>`.
   - Extract `canCancel`, `penaltyAmount`, `confirmId`, and `bookingId`. If `canCancel` is false, inform the user with customer support guidance: `{message}`.

2. **Verify with User & Obtain Explicit Consent**:
```
⚠️ Order Cancellation Confirmation:
Order No: **{orderNo}**
Hotel: {Hotel Name}
Cancellation Penalty Fee: {Currency} {penaltyAmount}
Estimated Refund: {Currency} {Estimated Refund Amount}

⚠️ Cancellation is irreversible once confirmed. Please confirm if you wish to proceed with the cancellation?
```

3. **Confirm Cancellation (After User's Explicit Consent)**:
   - Run `rgg confirm-cancel --help` to check parameters.
   - Run `rgg confirm-cancel --order-no <orderNo> --booking-id <bookingId> --confirm-id <confirmId>`.
   - Display the result clearly to the user.

**Cancellation Success Display Template**:
```
✅ Order successfully cancelled!
Confirmation No: **{orderNo}**
Refund is being processed and will be returned to the original payment method within 1-3 business days.
```

---

## Semantic Fallback Strategy When Results Are Not Ideal

If search yields 0 results, silently loosen constraints in this order to retry:
1. Remove star rating limits
2. Expand search radius / distance parameters
3. Downgrade hard required tags to preferred tags
4. Increase return quantity (`size`)
5. Retain location and check-in date only

---

## Key Interaction Rules

- **Hide Technical Details**: Never expose `hotelId`, `ratePlanId`, `referenceNo`, raw JSON, or CLI commands to the user.
- **Reference Prices**: Search prices are labeled as "Reference Price"; actual price is locked via price confirmation.
- **Valid Payment Links**: Generated order payment links must be directly clickable for users to complete payment.
- **Multiple Hotel Comparison**: Display multiple hotel cards simultaneously to highlight differences (price/distance/amenities).

---

## Detailed Reference Documents

- [references/cli-params.md](references/cli-params.md) — Complete CLI command parameters specification

© RollingGo-AI · MIT · RollingGo-AI/rollinggo-hotel-skill-global

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
FlyBest Travel — Hotel Booking with Advisor Benefits flybestorg-cyber FlyBest Travel — Hotel Booking with Advisor Benefits — MCP-сервер для Claude Code ищет отели по датам и составу гостей, сравнивает тарифы с привилегиями и помогает оформить, проверить или отменить бронирование. CX Codex +1 ★ 3звёзд репо hotelbooking RollingGo-AI MCP-сервер hotelbooking подключает к ассистенту поиск отелей, проверку цен и бронирование номеров через API RollingGo. Требует персональный API-ключ сервиса. CX Codex +1 ★ 62звёзд репо travel-search-and-booking-api-and-skills alibaba-flyai Плагин travel-search-and-booking-api-and-skills для Claude Code, который ищет авиабилеты, отели, туры и концерты через API Fliggy. Запросы обрабатываются на естественном языке, результаты возвращаются с прямыми ссылками на бронирование. ★ 1 295звёзд репо pp-booking-com Matt Van Horn Скилл pp-booking-com для Claude Code ищет отели, сравнивает варианты и отслеживает цены и сроки отмены, сохраняя историю цен в локальной SQLite. CX Codex +1 484установок Hotel & Vacation Rental MCP - live prices & reviews across Booking, Airbnb, Vrbo & Google Hotels stayingapi Hotel & Vacation Rental MCP - live prices & reviews across Booking, Airbnb, Vrbo & Google Hotels — MCP-сервер для Claude Code ищет жильё и отели через StayingAPI, запрашивая тарифы и отзывы. CX Codex +1 moodtrip-hotel-search moodtrip MCP-сервер moodtrip-hotel-search, который превращает текстовое описание желаемого отеля в реальный поиск. Введите «бутик-отель в Токио на двоих в декабре до $200 в сутки» — получите живые цены, фото и ссылки на бронирование. CX Codex +1 8 332установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой