HomeBrowseUpload
← Back to registry
// Skill profile

RollingGo Hotel CLI

name: rollinggo-hotel

by cnchenkai · published 2026-03-22

数据处理API集成
Total installs
0
Stars
★ 0
Last updated
2026-03
// Install command
$ claw add gh:cnchenkai/cnchenkai-rollinggo-searchhotel-skill
View on GitHub
// Full documentation

---

name: rollinggo-hotel

description: Hotel search and pricing via the RollingGo CLI. Use when the user wants to search hotels by destination, filter by date/star/budget/tags/distance, inspect hotel detail and room pricing, or look up hotel tags. Trigger phrases — "search hotels", "find hotels near", "hotel detail", "hotel pricing", "hotel tags", "rollinggo".

homepage: https://mcp.agentichotel.cn

metadata:

{

"openclaw": {

"emoji": "🏨",

"primaryEnv": "AIGOHOTEL_API_KEY",

"requires": {

"anyBins": ["rollinggo", "npx", "node", "uvx", "uv"],

"env": ["AIGOHOTEL_API_KEY"]

},

"install": [

{

"id": "node",

"kind": "node",

"package": "rollinggo",

"bins": ["rollinggo"],

"label": "Install rollinggo (npm)"

},

{

"id": "uv",

"kind": "uv",

"package": "rollinggo",

"bins": ["rollinggo"],

"label": "Install rollinggo (uv)"

}

]

}

}

---

# 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](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](references/rollinggo-npx.md)
  • **`uv`, `uvx`, PyPI, or Python:** Load [references/rollinggo-uv.md](references/rollinggo-uv.md)
  • **API Key setup:** Load [references/env.md](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

    // Comments
    Sign in with GitHub to leave a comment.
    // Related skills

    More tools from the same signal band