search-hotel

👤 longcreat 📦 v1.0.0 ⭐ 4.4 ⬇️ 747 下载
🏠 生活服务 免费 🔑 需 API Key

📖 技能介绍


name: search-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

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

No key yet? Apply at: https://mcp.agentichotel.cn/apply

Runtime

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

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

Primary Workflow

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

  1. Clarify: destination, dates, nights, occupancy, budget, stars, tags, distance
  2. If tag filters needed → run hotel-tags first to get valid tag strings
  3. Run search-hotels → parse JSON → extract hotelId
  4. Run hotel-detail --hotel-id <id> for room plans and pricing
  5. If results are weak → loosen filters and retry

Commands Quick Reference

# 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

🤖 AI 评测

这个技能质量较好,文档结构清晰,涵盖了酒店搜索、详情查询、标签过滤等常用功能,工作流程说明详细,错误处理也比较完善。它最大的亮点是同时支持 npm 和 uv 两种运行环境,适合不同技术背景的用户。主要不足是缺少实际输出示例,部分参数取值说明不够直观,文档完整度还有提升空间。整体而言,这是一个实用且易上手的酒店搜索技能,但细节打磨上还有改进余地。

📊 多维度评分

适应性4.3
规范性4.5
有效性4.6
可靠性4
可信度4.8

📁 包含文件 (4 个)

📄 SKILL.md 4.5 KB
📄 _meta.json 131 B
📄 references/rollinggo-npx.md 4.7 KB
📄 references/rollinggo-uv.md 5.1 KB