tuniu-hotel

What This Skill Does

The Tuniu Hotel Assistant (tuniu-hotel) is a powerful OpenClaw skill designed to bridge the gap between conversational AI and the extensive Tuniu travel platform. It leverages the Model Context Protocol (MCP) to perform real-time hotel searches, detailed property inspections, and reservation management. By utilizing shell-based curl requests, this skill enables your agent to interact directly with Tuniu’s OpenAPI, providing users with accurate pricing, availability, and booking capabilities without needing a complex web UI.

Installation

To integrate this tool into your OpenClaw environment, ensure that your execution environment has curl installed and access to the Tuniu API gateway. Install the skill using the following terminal command: clawhub install openclaw/skills/skills/leonardoooooo/tuniu-hotel

After installation, configure the mandatory environment variables:

• TUNIU_API_KEY: Your unique authentication key from the Tuniu Open Platform.
• TUNIU_MCP_URL (Optional): The custom endpoint URL, defaulting to https://openapi.tuniu.cn/mcp/hotel.

Use Cases

This skill is perfect for travel-focused AI agents. Its primary functions include:

• Discovery: Quickly finding hotels in specific cities based on date ranges and user preferences.
• Refinement: Handling complex user interactions like pagination (next/previous pages) to explore a larger list of options.
• Deep Dive: Retrieving specific room types, amenity details, and exact pricing for a selected property.
• Transaction: Facilitating secure order submissions by passing booking details to the Tuniu backend.

Example Prompts

1. "Find me a 4-star hotel in Shanghai for this weekend, checking in Friday and out on Sunday."
2. "Show me the room types and availability for the Grand Hyatt Shanghai."
3. "That looks good, book the Deluxe King room for me under the name John Doe with my saved contact number."

Tips & Limitations

• Security: The skill processes personal information (PII). Ensure that your agent is configured to handle PII data strictly within the parameters required by the API and do not output user data in logs.
• Pagination: Always keep track of the queryId returned from the initial search. Without it, you cannot request subsequent pages (e.g., page 2 or 3) if the user asks for more options.
• Environment: Because this skill uses exec to run curl, it is dependent on the host OS having network permissions and shell execution enabled. If your environment is restricted for security (e.g., sandboxed containers), ensure network egress to openapi.tuniu.cn is allowed.