{"skill":{"slug":"search-hotel","displayName":"search-hotel","summary":"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 ho...","description":"---\nname: search-hotel\ndescription: 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\".\nhomepage: https://mcp.agentichotel.cn\nmetadata:\n  {\n    \"openclaw\": {\n      \"emoji\": \"🏨\",\n      \"primaryEnv\": \"AIGOHOTEL_API_KEY\",\n      \"requires\": {\n        \"anyBins\": [\"rollinggo\", \"npx\", \"node\", \"uvx\", \"uv\"],\n        \"env\": [\"AIGOHOTEL_API_KEY\"]\n      },\n      \"install\": [\n        {\n          \"id\": \"node\",\n          \"kind\": \"node\",\n          \"package\": \"rollinggo\",\n          \"bins\": [\"rollinggo\"],\n          \"label\": \"Install rollinggo (npm)\"\n        },\n        {\n          \"id\": \"uv\",\n          \"kind\": \"uv\",\n          \"package\": \"rollinggo\",\n          \"bins\": [\"rollinggo\"],\n          \"label\": \"Install rollinggo (uv)\"\n        }\n      ]\n    }\n  }\n---\n\n# RollingGo Hotel CLI\n\n## When to Use\n\n✅ **Use this skill when:**\n- **Searching Candidates:** User wants to find hotels near a specific city, landmark, or address (e.g., \"Find hotels near Tokyo Disneyland\").\n- **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.\n- **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.\n- **Deep Dive & Pricing:** User wants to inspect detailed room plans, real-time pricing, cancellation policies, or availability for a specific hotel ID.\n- **Comparison & Evaluation:** User wants to compare multiple candidate hotels based on returning structured data and current rates.\n- **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.\n\n❌ **Don't use this skill when:**\n- User asks about non-hotel travel booking (flights, trains, transfers, car rentals).\n\n## API Key\n\nResolution order: `--api-key` flag → `AIGOHOTEL_API_KEY` env var.\n\nNo key yet? Apply at: https://mcp.agentichotel.cn/apply\n\n## Runtime\n\nChoose based on user's environment. Load the matching reference file and keep it for the session.\n\n- **`npm`, `npx`, Node, or no preference:** Load [references/rollinggo-npx.md](references/rollinggo-npx.md)\n- **`uv`, `uvx`, PyPI, or Python:** Load [references/rollinggo-uv.md](references/rollinggo-uv.md)\n- **Parity check or both:** Load both references\n\nDefault when unspecified → **npm/npx** (broader env compatibility).\n\n## Primary Workflow\n\nRun these steps in order unless the user is already at a later step.\n\n1. Clarify: destination, dates, nights, occupancy, budget, stars, tags, distance\n2. If tag filters needed → run `hotel-tags` first to get valid tag strings\n3. Run `search-hotels` → parse JSON → extract `hotelId`\n4. Run `hotel-detail --hotel-id <id>` for room plans and pricing\n5. If results are weak → loosen filters and retry\n\n## Commands Quick Reference\n\n```bash\n# Discover tags\nrollinggo hotel-tags\n\n# Search hotels (minimum required flags)\nrollinggo search-hotels \\\n  --origin-query \"<user's natural language request>\" \\\n  --place \"<destination>\" \\\n  --place-type \"<value from --help>\"\n\n# Hotel detail with pricing\nrollinggo hotel-detail \\\n  --hotel-id <id> \\\n  --check-in-date YYYY-MM-DD \\\n  --check-out-date YYYY-MM-DD \\\n  --adult-count 2 --room-count 1\n\n# Discover all flags\nrollinggo search-hotels --help\nrollinggo hotel-detail --help\n```\n\n## Key Rules\n\n- `--place-type` must use exact values from `rollinggo search-hotels --help`\n- `--star-ratings` format: `min,max` e.g. `4.0,5.0`\n- `--format table` allowed **only** on `search-hotels`; rejected by `hotel-detail` and `hotel-tags`\n- `--child-count` must match the count of `--child-age` flags\n- `--check-out-date` must be later than `--check-in-date`\n- Prefer `--hotel-id` over `--name` whenever available\n\n## Output\n\n- stdout → result payload (JSON by default)\n- stderr → errors only\n- Exit `0` success · `1` HTTP/network failure · `2` CLI validation failure\n- Results include booking URLs and hotel detail page links for downstream use\n\n## Filter Loosening (when no results)\n\nTry in order: remove `--star-ratings` → increase `--size` → increase `--distance-in-meter` → remove tag filters → widen dates or budget\n","tags":{"latest":"1.0.0"},"stats":{"comments":0,"downloads":525,"installsAllTime":0,"installsCurrent":0,"stars":0,"versions":1},"createdAt":1773391346060,"updatedAt":1778491876821},"latestVersion":{"version":"1.0.0","createdAt":1773391346060,"changelog":"- Initial release of search-hotel, enabling hotel discovery and pricing via the RollingGo CLI.\n- Supports searching hotels by city/landmark, detailed filtering (date, star, budget, tags, distance), and inspecting hotel details/pricing.\n- Allows lookup of hotel tags to refine filter options.\n- Provides commands and workflow for step-by-step hotel search and booking.\n- Includes key usage rules and fallback strategies for broader search results.","license":"MIT-0"},"metadata":{"setup":[{"key":"AIGOHOTEL_API_KEY","required":true}],"os":null,"systems":null},"owner":{"handle":"longcreat","userId":"s179cnrw7n8qa3jwhv4tmcmsfd84rvws","displayName":"zlon","image":"https://avatars.githubusercontent.com/u/68158872?v=4"},"moderation":null}