Skip to main content
skill CX Codex

rollinggo-hotel-booking — Claude Code skill: how to install and use

rollinggo-hotel-booking is a Claude Code skill for searching hotels, comparing room prices, booking stays, and cancelling orders via RollingGo APIs.

MIT 6 installs ★ 6 updated 2026-10-14

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add RollingGo-AI/rollinggo-hotel-skill-global --skill rollinggo-hotel-booking -a claude-code
Open on GitHub

What rollinggo-hotel-booking does

This skill connects your coding agent to RollingGo hotel booking APIs using the rgg CLI utility. The agent searches properties by city, landmark, or transit stop, filters by star rating, amenities, and budget, compares live room rates, and guides users through order placement.

The skill depends on the rgg executable in your system. You can install it globally via npm install -g @rollinggo/hotel-global@latest, run python scripts/install.py, or place the standalone binary directly in your PATH. Without the rgg binary present, hotel search and booking calls will fail immediately.

What it helps with

  • find hotels near specific attractions or transit hubs
  • filter stays by price limits, star ratings, or breakfast inclusion
  • compare room types and live prices between properties
  • complete a booking or calculate order cancellation fees

Example prompts for the agent

  • Find hotels near Sanlitun in Beijing with a pool and breakfast included
  • Compare double room rates between these two hotels
  • Check my hotel reservation status and calculate the cancellation penalty

How to install rollinggo-hotel-booking

1Skills CLI (Vercel)

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

2Manually: put the files in place

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

Copy the whole skill folder; for one project use .claude/skills/rollinggo-hotel-booking/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about rollinggo-hotel-booking

How to install rollinggo-hotel-booking in Claude Code?

Run npx skills add RollingGo-AI/rollinggo-hotel-skill-global --skill rollinggo-hotel-booking -a claude-code in your terminal.

What does rollinggo-hotel-booking do?

It lets your agent search hotels worldwide, filter amenities, compare live room prices, book stays, and manage reservation cancellations.

What dependencies are required for rollinggo-hotel-booking?

The skill requires the rgg binary. Install it with npm install -g @rollinggo/hotel-global@latest or execute python scripts/install.py.

Source text

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

Similar skills

All skills for Agent setup: memory, context, orchestration →
FlyBest Travel — Hotel Booking with Advisor Benefits flybestorg-cyber FlyBest Travel — Hotel Booking with Advisor Benefits is an MCP server for Claude Code that searches hotels by dates and guest count, compares rates with agency perks, and helps make, review, or cancel bookings. CX Codex +1 ★ 3repo stars hotelbooking RollingGo-AI hotelbooking links AI agents to the RollingGo travel API for hotel searches, live rates, and room availability. Requires an API key to query. CX Codex +1 ★ 62repo stars travel-search-and-booking-api-and-skills alibaba-flyai travel-search-and-booking-api-and-skills — a Claude Code plugin that searches flights, hotels, tours, and concerts through the Fliggy API. Processes natural language queries and returns structured results with direct booking links. ★ 1,295repo stars pp-booking-com Matt Van Horn pp-booking-com — a skill that wires an agent to booking-com-pp-cli for hotel search, side-by-side comparison, price-drop watching and cancellation deadlines, with price history kept locally. CX Codex +1 484installs 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 is an MCP server for Claude Code that queries live rates and reviews for rentals and hotels. CX Codex +1 moodtrip-hotel-search moodtrip moodtrip-hotel-search — an MCP server that turns hotel descriptions into real search results. Say “boutique hotel in Tokyo for two in December under $200/night” and get live rates, photos, and booking links. CX Codex +1 8,332installs

Project sponsors

Companies that keep this analytics open