RollingGo Hotel CLI

When to Use

✅ Use this skill when:

• Searching Candidates: User wants to find hotels near a specific city, landmark, or address (e.g., "Find hotels near Tokyo Disneyland").
• Complex Filtering: User needs to narrow down options using natural language queries combined with exact dates, guest count, star ratings, budget limits, or distance radius.
• Tag & Brand Matching: User wants to find hotels with specific attributes (e.g., "family friendly", "breakfast included", "Marriott") by first checking the tag dictionary to build exact filters.
• Deep Dive & Pricing: User wants to inspect detailed room plans, real-time pricing, cancellation policies, or availability for a specific hotel ID.
• Comparison & Evaluation: User wants to compare multiple candidate hotels based on returning structured data and current rates.
• Hotel Booking: User is ready to select a room and book a hotel. The returned booking URLs and detail page links can be provided to guide the user to complete their reservation.

❌ Don't use this skill when:

• User asks about non-hotel travel booking (flights, trains, transfers, car rentals).

API Key

Pre-configured Public API Key:

AIGOHOTEL_API_KEY=mcp_171e1ffa7da343faa4ec43460c52b13f

This skill comes with a pre-configured public API Key. See references/env.md for detailed usage instructions.

Resolution order: --api-key flag → AIGOHOTEL_API_KEY env var

Runtime

Choose based on user's environment. Load the matching reference file and keep it for the session.

• npm, npx, Node, or no preference: Load references/rollinggo-npx.md
• uv, uvx, PyPI, or Python: Load references/rollinggo-uv.md
• API Key setup: Load references/env.md

Default when unspecified → npm/npx (broader env compatibility).

Version Freshness (Always Latest)

Default policy for this skill: use the newest release on every run.

• npm/npx: npx --yes --package rollinggo@latest rollinggo ...
• uvx: uvx --refresh --from rollinggo rollinggo ...

If using an installed command instead of temporary execution, upgrade first:

• npm global: npm install -g rollinggo@latest
• uv tool: uv tool upgrade rollinggo

Primary Workflow

Run these steps in order unless the user is already at a later step.

1. Load API Key: Run export AIGOHOTEL_API_KEY=mcp_171e1ffa7da343faa4ec43460c52b13f
2. Clarify: destination, dates, nights, occupancy, budget, stars, tags, distance
3. If tag filters needed: Run hotel-tags first to get valid tag strings
4. Search: Run search-hotels → parse JSON → extract hotelId
5. Detail: Run hotel-detail --hotel-id <id> for room plans and pricing
6. If results are weak: Loosen filters and retry

Commands Quick Reference

# Setup API Key
export AIGOHOTEL_API_KEY=mcp_171e1ffa7da343faa4ec43460c52b13f

# Discover tags
rollinggo hotel-tags

# Search hotels (minimum required flags)
rollinggo search-hotels \
  --origin-query "<user's natural language request>" \
  --place "<destination>" \
  --place-type "<value from --help>"

# Hotel detail with pricing
rollinggo hotel-detail \
  --hotel-id <id> \
  --check-in-date YYYY-MM-DD \
  --check-out-date YYYY-MM-DD \
  --adult-count 2 --room-count 1

# Discover all flags
rollinggo search-hotels --help
rollinggo hotel-detail --help

Key Rules

• --place-type must use exact values from rollinggo search-hotels --help
• --star-ratings format: min,max e.g. 4.0,5.0
• --format table allowed only on search-hotels; rejected by hotel-detail and hotel-tags
• --child-count must match the count of --child-age flags
• --check-out-date must be later than --check-in-date
• Prefer --hotel-id over --name whenever available

Output

• stdout → result payload (JSON by default)
• stderr → errors only
• Exit 0 success · 1 HTTP/network failure · 2 CLI validation failure
• Results include booking URLs and hotel detail page links for downstream use

Filter Loosening (when no results)

Try in order: remove --star-ratings → increase --size → increase --distance-in-meter → remove tag filters → widen dates or budget