RollingGo Hotel Search & Booking Skill

Installation

If the

rgh

command is not installed in your local environment, install it using any one of the following three methods:

Option 1: Install via npm (Recommended) If Node.js and npm are available, run:

bash

npm install -g @rollinggo/hotel@latest

Option 2: Install via Python automatic script (No Node.js environment required) If Python is available, run the provided automated installation script directly in the Skill directory. It will detect your operating system and download the latest standalone

rgh

binary into the local

bin

folder:

bash

python scripts/install.py

Option 3: Manually download standalone executable (No Node/Python environment required) If neither npm nor Python is available, download the matching single-file program from the Release page below (Windows:

rgh-win.exe

rgh-windows.exe

, Mac:

rgh-macos

, Linux:

rgh-linux

https://github.com/RollingGo-AI/oauth-hotel-cli/releases/latest

After downloading, rename it to

rgh

(

rgh.exe

on Windows), grant execute permission, and place it into the system PATH environment variable or the

bin

folder in the skill directory.

⚠️ Auto-upgrade interception rule: The CLI tool has built-in version detection. When you run any

rgh

command, if the console output contains

📦 A new version is available!

run the following command to update

, you must immediately pause the current operation and upgrade the tool to the latest version using one of the three methods above. After successful upgrade, re-run the interrupted command. This avoids booking failures caused by outdated server-side APIs.

⚠️ Output Rules:
Never expose technical details to users, including but not limited to: tool names (e.g.
search-hotels
,
hotel-detail
), JSON field names (e.g.
hotelId
,
ratePlanId
,
referenceNo
), command-line content, and technical parameters.
Only show information users care about: hotel name, star rating, price, distance, core facilities, tags, and booking link.

Results must be formatted: each hotel should occupy its own card, with key information separated by line breaks. Never cram everything into one line.

Price note: The price in search results is a reference display price. The actual booking price is subject to price confirmation. Indicate "reference price" when displaying.
Login authorization: Users cannot see terminal output while interacting through an Agent. After running
rgh login
, extract the authorization link from the output and reply with it. Do not show the QR code text.

When to Use

Trigger this Skill whenever the user intent involves hotel accommodation, including but not limited to the following scenarios:

Search & Discovery:

Search by location: "Find hotels near Sanlitun Beijing", "Any good hotels in Sanya?", "accommodation recommendations near the West Lake"
Filter by conditions: "five-star hotel", "hotel with a pool", "breakfast included", "family-friendly hotel", "pet-friendly hotel"
Filter by budget: "hotels under ¥500", "budget accommodation", "luxury hotel recommendations"
Filter by brand: "Hilton", "Marriott", "Atour", "Jinjiang Inn"

Query & Comparison:

Check room rates: "How much is a night in Hangzhou?", "What is the price of this hotel?"
View room types: "What room types are available?", "Is there a king room?", "family room recommendations"
Compare accommodations: "Help me compare these two hotels", "Which one is better value?"
Learn about facilities: "Is there a pool?", "How far is it to the metro station?", "Is parking convenient?"

Booking & Orders:

Book a hotel: "Book this hotel for me", "I want to place an order", "Book one room"
Query orders: "my orders", "the hotel I booked before", "order status"
Cancel orders: "Help me cancel this order", "I don't want to stay anymore, cancel it", "check-out and refund", "check cancellation penalty"

Trigger words covered: find hotel, book hotel, search hotel, hotel recommendations, hotel query, nearby hotels, five-star hotel, B&B, resort, check room rates, view room types, check-in, where to stay, accommodation, business stay, travel accommodation, family hotel, hotel with pool, hotel with breakfast, business hotel, couples hotel, hot spring hotel, sea view room, river view room, cancel order, cancel hotel booking, check-out refund, cancel reservation.

When NOT to Use

User asks about flights, train tickets, car rentals, attraction tickets, or other non-accommodation travel needs
User is just chatting about travel destinations with no clear accommodation intent
User has explicitly said "no need to book" or "just asking"

Security Gate

⚠️ Hotel booking and cancellation involve real money and consumption operations:
Two-step confirmation: After showing room types and prices, wait for the user's explicit choice before locking the price and placing the order.

Information completeness: Confirm the guest's pinyin name and email address before placing the order.
Price lock validity: The locked price voucher (
referenceNo
) is valid for about 15-30 minutes. If it expires, the price must be locked again.
High-risk safety gate for order cancellation (two-step confirmation): Cancelling an order is irreversible. Absolutely do not cancel without a second confirmation! You must first run
pre-cancel
to query the cancellation fee/penalty and voucher (
confirmId
voucher is valid for 10 minutes), clearly report the deducted amount and estimated refund to the user, and only after receiving the user's explicit affirmative reply may you call
confirm-cancel
.

Workflow and Dynamic CLI Discovery

💡 Dynamic Command/Parameter Self-Discovery Rule:
Proxy invocation: All CLI commands are invoked through the proxy script:
node scripts/rgh.js <subcommand>
(or
python scripts/rgh.py <subcommand>
when Node.js is unavailable), to ensure environment resolution and
CLIENT_ID
(rollinggoskill) are mounted automatically.
Dynamic parameter discovery: Before executing any subcommand, first run
node scripts/rgh.js <subcommand> --help
to get the latest command-line parameter help, and dynamically assemble command parameters according to the latest
--help
output!

Business Step Guide

Step 0: Login authorization check

Run
```
node scripts/rgh.js status
```
(or
```
whoami
```
) to check login status.
If not logged in, run
```
node scripts/rgh.js login
```
(⚠️ must run in async/background mode, e.g.
```
WaitMsBeforeAsync=2000
```
). Extract the authorization link (
```
https://rollinggo.store/s/xxx
```
) from the output and reply to the user to complete authorization.

Step 1: Information collection

Confirm destination (required), check-in date (default: tomorrow), number of nights (default: 1 night), number of guests (default: 2 people).

Step 2: Get the tag dictionary (as needed)

For special needs (pool, breakfast, family, pets, etc.), first run
```
node scripts/rgh.js hotel-tags
```
to precisely match tag names.

Step 3: Search hotels

First run
```
node scripts/rgh.js search-hotels --help
```
to see the latest filter parameters, then assemble the command based on user needs.

placeType selection rules (must match exactly):

城市

机场

景点

火车站

地铁站

酒店

区/县

详细地址

Search results display template (one card per hotel): (【Extremely important】: You must use standard Markdown image syntax
![alt](url)
to render imageUrl, and must place the image at the end of the template. If imageUrl contains unencoded spaces, manually replace them with
%20
, or wrap the URL in angle brackets like
![alt](<url>)
; otherwise, the host platform cannot render the image! Absolutely do not use HTML
<img>
tags, and absolutely do not use plain-text URLs!)

markdown

🏨 {Hotel Name}
⭐ {Star} Star  *(Only show when the `distanceInMeters` field is returned: 📍 {distance} meters from {search location})*
💰 Reference price ¥{lowest price}/night
🏷️ {Tag 1} · {Tag 2} · {Tag 3}
![{Hotel Name}]({imageUrl})

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

Step 4: Query room types and real-time prices

First run
```
node scripts/rgh.js hotel-detail --help
```
to see the parameters, then pass in the selected
```
hotelId
```
to query real-time room availability and quotes.

Room type display template (one entry per room type):

🛏️ {Room Type Chinese Name} ({Bed Type Description})
💰 Total price ¥{totalPrice} (¥{average price}/night)
📋 Cancellation policy: {Cancellation policy description}

After showing 3-5 recommended room types, guide the user to reply: "Please tell me the room type you selected, and I will lock the price and place the order for you."

Step 5: Price confirmation and booking (security gate)

Run
```
node scripts/rgh.js price-confirm --help
```
to view parameters, lock the price, and get the voucher
```
referenceNo
```
.
After confirming the contact's pinyin name and email, run
```
node scripts/rgh.js book --help
```
to view parameters, submit the order, and extract the payment link.

Pending payment order display template: (【Extremely important】: Never fabricate or invent payment methods (e.g. "automatically detect environment, support Alipay or WeChat"). You must strictly follow the template below, and never add any description about the payment environment or payment method on your own!)

📝 Order created, pending payment!
Confirmation No.: **{orderNo}**
Hotel: {Hotel Name}
Room type: {Room Type Name}
Check-in: {Check-in date} | Check-out: {Check-out date}
Total price: ¥{price}
📋 Cancellation policy: {Cancellation policy description}
💳 Please complete payment within 30 minutes: {payment link}

Step 6: Query orders and order details

Run

node scripts/rgh.js orders --help

node scripts/rgh.js order-detail --help

to query the user's historical orders or a single order's details.

Step 7: Cancel order (high-risk two-step confirmation)

⚠️ High-risk security gate: Cancelling an order is an irreversible operation and cannot be undone after cancellation! You must strictly follow the two-step confirmation:
First call
pre-cancel
to query the cancellation fee/penalty and confirmation voucher (
confirmId
voucher is valid for 10 minutes).
Report the penalty amount and estimated refund to the user truthfully, and must wait for the user's explicit affirmative reply before running
confirm-cancel
to submit the cancellation.

Pre-cancel query for penalty:
- First run
```
node scripts/rgh.js pre-cancel --help
```
  to view parameters.
- If the user did not provide the order number, first locate the order number via
```
node scripts/rgh.js orders
```
  .
- Execute
```
node scripts/rgh.js pre-cancel --order-no <orderNo>
```
  .
- Extract
```
canCancel
```
  ,
```
penaltyAmount
```
  ,
```
confirmId
```
  ,
```
bookingId
```
  . If
```
canCancel
```
  is false, inform the user of the reason or customer service guidance.
Confirm penalty and cancellation intent with user:

⚠️ Order cancellation confirmation:
Order No.: **{orderNo}**
Hotel: {Hotel Name}
Cancellation fee/penalty: ¥{penaltyAmount}
Estimated refund: ¥{estimated refund amount}

⚠️ The order cannot be recovered after cancellation. Please confirm whether to continue with the cancellation?

After user's explicit confirmation, execute confirm cancellation:
- First run
```
node scripts/rgh.js confirm-cancel --help
```
  to view parameters.
- Execute
```
node scripts/rgh.js confirm-cancel --order-no <orderNo> --booking-id <bookingId> --confirm-id <confirmId>
```
  .
- Clearly show the user the successful cancellation result.

Cancellation success display template:

✅ Order cancelled successfully!
Confirmation No.: **{orderNo}**
Refund is being processed. The money will be returned via the original payment method and is expected to arrive within 1-3 business days.

Semantic Fallback Strategy for Unsatisfactory Search Results

If the search returns 0 results, silently relax the conditions and retry in the following order:

Remove star rating range restrictions
Expand the search radius/distance parameters
Downgrade hard-constraint tags (Required Tag) to soft-preference tags (Preferred Tag)
Increase the result count (Size)
Keep only the destination and check-in date

Key Interaction Rules

Hide technical details: Never expose
```
hotelId
```
,
```
ratePlanId
```
,
```
referenceNo
```
, JSON responses, or command lines to users.
Real price note: Mark the search display price as "reference price"; the final amount is subject to the locked price from price confirmation.
Payment link must be real and usable: The generated order payment link can be directly provided to the user for payment.
Multi-hotel comparison: When the user wants to compare, show multiple hotel cards simultaneously and highlight differences (price/distance/facilities).

Detailed Reference Documents

references/cli-params.md — Complete CLI command parameter specification

rollinggo-hotel-booking

NPX Install

Tags

SKILL.md Content (Chinese)