An AI-powered skill for querying scenic spot ticket prices and automating order creation through the Tuniu Open Platform.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install tuniu-ticket
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install tuniu-ticket using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Tuniu Ticket Assistant?
The Tuniu Ticket Assistant is a technical implementation designed for AI agents to interact with the Tuniu MCP (Model Context Protocol) service. By utilizing shell execution and curl commands, this skill allows agents to bridge the gap between user inquiries and real-time travel data. It is a vital component of the Openclaw Skills ecosystem, enabling developers to build travel assistants that can handle complex queries about attractions in China.
This skill goes beyond simple data retrieval by supporting the full transaction lifecycle. It handles the secure transmission of traveler information to generate official Tuniu orders, providing users with a direct path from discovery to payment. It is optimized for environments where command-line tools are available to facilitate HTTP-based JSON-RPC communication.
Tuniu Ticket Assistant Use Cases
- Searching for ticket prices and availability for specific scenic spots using natural language.
- Comparing different ticket types and product resources for tourist destinations.
- Automating the booking process by collecting and submitting traveler PII to the Tuniu platform.
- Generating mobile-friendly payment links for users to finalize their attraction bookings.
How Tuniu Ticket Assistant Works
- The AI agent receives a scenic spot name from the user and triggers the query_cheapest_tickets tool.
- A curl command is executed to send a JSON-RPC 2.0 request to the Tuniu MCP endpoint, authenticated by an API key.
- The skill parses the returned ticket list, extracting essential identifiers like productId and resId.
- Upon user confirmation, the agent collects necessary traveler details including names and identification numbers.
- The create_ticket_order tool is invoked with the collected data and product IDs.
- The skill returns a success response containing a Tuniu order ID and a payment URL for the user to complete the transaction.
Tuniu Ticket Assistant Setup
To integrate this into your Openclaw Skills environment, follow these steps:
- Register and obtain an API key from the Tuniu Open Platform.
- Set the API key as an environment variable:
export TUNIU_API_KEY='your_tuniu_api_key_here'
- Ensure
curlis installed and accessible in your shell environment. - (Optional) If using a custom MCP gateway, set the endpoint:
export TICKET_MCP_URL='https://openapi.tuniu.cn/mcp/ticket'
Tuniu Ticket Assistant Data Schema & Taxonomy
The skill interacts via JSON-RPC 2.0. Below is the structure of the data handled:
| Object | Fields | Description |
|---|---|---|
| Ticket Query | scenic_name, tickets |
Includes productId, resId, price, and ticket description. |
| Order Request | product_id, resource_id, depart_date, tourist_info |
Required inputs for creating a valid booking. |
| Order Response | orderId, paymentUrl, success |
Result of the booking attempt; paymentUrl is used for checkout. |
| Traveler PII | name, mobile, cert_no |
Personal Identifiable Information required by Tuniu for ticketing. |
Tuniu Ticket Assistant Advanced Features
- Multi-agent compatibility through standard MCP JSON-RPC 2.0 protocols.
- Support for up to 5 individual travelers per single order creation.
- Dynamic endpoint configuration via environment variables for flexible deployment.
- Automated generation of mobile-optimized payment links (Tuniu M-site integration).
SKILL.md
Loading
Related Openclaw Skills
Tuniu Hotel Assistant
A professional AI agent skill for searching, detailing, and booking hotels via the Tuniu platform using MCP and shell execution.
Tuniu Flight Assistant
A comprehensive AI skill for managing domestic flight searches and bookings through the Tuniu Open Platform via standard shell commands.
Firecrawl CLI
A powerful command-line interface for scraping, crawling, and searching the web to generate clean markdown for AI context.
Timestamp Converter
A versatile utility for converting between Unix timestamps, ISO 8601 dates, and localized human-readable formats.
File Summary & Analysis Tool
A local document processing tool that extracts text from multiple file formats to generate instant AI-driven summaries and deep analysis.
File Summary Tool
A local document processing skill that extracts and summarizes content from PDFs, Word documents, and Excel spreadsheets using an AI agent.
Featured*
