A powerful flight search utility for China domestic travel that automates price comparisons across cities and entire provinces.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install ctrip-flights
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 ctrip-flights 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 Ctrip Domestic Flight Search?
The Ctrip Domestic Flight Search is a specialized tool designed to interface directly with Ctrip's API to fetch real-time flight data within China. It bridges the gap between complex travel queries and actionable data by handling city names, IATA codes, and province-level expansions.
As part of the Openclaw Skills ecosystem, this tool is engineered to bypass common API hurdles using advanced header signing and payload execution via the QuickJS engine. It provides developers and AI agents with the ability to find the cheapest travel routes by automatically comparing all airports within a specified Chinese province, ensuring users always get the best possible deal.
Ctrip Domestic Flight Search Use Cases
- Finding the cheapest flights between major Chinese hubs like Beijing and Shanghai.
- Researching low-price calendars for flexible travel planning.
- Comparing all flight options into a specific region by using province-based searches (e.g., searching for flights to Guangdong to compare Guangzhou, Shenzhen, and Zhuhai).
- Integrating real-time Chinese travel data into AI-powered travel assistants or booking bots.
- Exporting flight schedules and pricing into structured JSON for data analysis.
How Ctrip Domestic Flight Search Works
- The user provides a departure point, destination, and date (supporting city names, IATA codes, or province names).
- If a province is specified, the skill automatically expands the query to include all airport cities within that province.
- The system executes a backend request to Ctrip, utilizing a reverse-engineered security layer including MD5 transaction signing and c-sign.js execution via QuickJS.
- Real-time data is fetched, including prices, airlines, aircraft types, and transfer options.
- The skill aggregates the results, identifies the cheapest route (bestRoute), and generates a summary.
- Data is returned in either a human-readable Markdown table or a structured JSON object.
Ctrip Domestic Flight Search Setup
To use this Openclaw Skills contribution, ensure you have Python installed and set up the required dependencies:
pip install quickjs
Ensure the _extract/c-sign.js file is present in your scripts/ directory as it is required for request signing. You can then run searches directly from the CLI:
python3 scripts/ctrip_flight.py Beijing Shanghai 2026-04-02 --md
Ctrip Domestic Flight Search Data Schema & Taxonomy
The skill provides comprehensive data structures available in JSON or Markdown. The primary fields include:
| Field | Description |
|---|---|
query.isMultiRoute |
Boolean indicating if a province-wide search was performed. |
routeSummaries |
A comparison of the lowest prices across different routes. |
bestRoute |
The single most cost-effective route found in the search. |
allFlights |
A complete list of individual flight details (airline, time, aircraft). |
lowPriceCalendar |
Historical and near-future price trends for the selected route. |
Ctrip Domestic Flight Search Advanced Features
- Province Auto-Expansion: Automatically queries all airports in provinces like Zhejiang, Yunnan, or Guangdong to find the absolute lowest entry point.
- Multi-Format Output: Switch between
--mdfor immediate chat-based display and--jsonfor programmatic integration. - Anti-Crawl Bypass: Built-in handling of
signheaders andFVPcookies to ensure reliable data retrieval. - Programmatic API: Can be imported as a Python module (
search_to_region) for use in larger automation workflows.
SKILL.md
Loading
Related Openclaw Skills
Assistant Configurator
A comprehensive management and optimization tool for OpenClaw configurations, model selection, and system tuning.
Tennis Grand Slam Planner
A specialized AI agent skill designed to transform tennis tournament interest into comprehensive, logistics-ready travel itineraries.
GZ Media Tester
A specialized AI testing assistant for the Guangzhou Daily and Converged Media Cloud ecosystem, covering Apps, CMS, and APIs.
Situationship Navigation
Situationship Navigation provides a structured API framework for AI agents to discover, interact, and define relationship statuses within the inbed.ai ecosystem.
Worldline Choice: AI-Powered d20 Narrative Engine
A sophisticated AI-driven narrative engine that combines interactive storytelling with deterministic d20 mechanics and tactical depth.
Divorce Advisor
An AI-powered legal guidance assistant designed to help users navigate asset division, evidence handling, and digital security during divorce proceedings.
Featured*
