universal-travel-planner-skill

# Tool List > **AI Travel Planning Skill for Business Travelers** · MIT License One-sentence description: One-stop AI business travel planning + multi-platform hotel price comparison + beautiful HTML report generation. ## ✨ Features - 🚄 **Real-time Traffic Query**: 12306 MCP real-time ticket inquiry + Gaode route planning + flight search - 🏨 **Multi-platform Hotel Price Comparison**: Trip.com / Fliggy / Qunar / Booking / Agoda, multi-platform equal recommendation - 📊 **Intelligent Budget Calculation**: Economy / Comfort / Business three standards automatic calculation - 📱 **HTML Report Generation**: Real-time generation of beautiful responsive HTML pages - 🔗 **Real Jump Links**: All booking links are real and can be jumped with one click - 🗺️ **Map Integration**: Gaode map POI search + route planning + weather query - 📋 **Travel List**: Automatically generate a list of items to bring ## 🚀 Quick Start ### 1. Install to WorkBuddy / OpenClaw ```bash # Clone repository git clone https://github.com/YOUR_USERNAME/universal-travel-planner-skill.git # Copy Skill file cp SKILL.md ~/.openclaw/skills/universal-travel-planner/ # or copy to project directory cp SKILL.md .workbuddy/skills/universal-travel-planner/ ``` ### 2. Configure MCP Server Add the following to `~/.workbuddy/mcp.json`: ```json { "mcpServers": { "12306-mcp": { "command": "npx", "args": ["-y", "12306-mcp"] } } } ``` ### 3. Configure Environment Variables (optional, enhance experience) ```bash # Gaode Map API Key (apply for free: https://lbs.amap.com/) export AMAP_WEB_KEY="your_amap_web_service_key" export AMAP_JSAPI_KEY="your_amap_jsapi_key" # optional, for interactive map export AMAP_SECURITY_CODE="your_security_js_code" # optional, front-end security key ``` ### 4. Start Using ``` "Help me plan a trip from Beijing to Shanghai, May 15-17, budget comfortable" "How to get from Guangzhou to Shenzhen? Help me check high-speed rail and flight" "Help me find a hotel near Hangzhou West Lake, check-in next Friday" ``` ## 📁 Project Structure ``` universal-travel-planner/ ├── SKILL.md # Core Skill file ├── README.md # This file ├── clawhub.json # ClawHub publish configuration ├── .gitignore # Git ignore rules ├── demo_beijing_travel.html # Demo page (Beijing trip) ├── scripts/ # Auxiliary scripts (reserved) └── templates/ # HTML templates (reserved) ``` ## 🛠️ Tech Stack | Technology | Purpose | |------|------| | 12306 MCP Server | Real-time train ticket inquiry | | Gaode Map API | Map/route planning/POI/weather | | Web Search | Flight/hotel price search | | HTML/CSS | Report generation | | Python | Budget calculation module | ## 🔗 Booking Link Platforms | Platform | Purpose | |------|------| | 12306.cn | Train ticket inquiry/purchase | | Trip.com | Domestic hotel/flight | | Fliggy | Alibaba hotel/flight | | Qunar | Hotel price comparison | | Booking.com | International hotel | | Agoda | Asian hotel | | Gaode Map | Route planning/navigation | ## 📋 Usage Examples **Input**: ``` Help me plan a trip from April 23-24 in Chongqing, I'm a company manager, April 24th all day at the convention center for an industry conference. Starting from Beijing, help me check flights and high-speed rail. ``` **Output**: 1. Beijing→Chongqing traffic plan comparison (flight + high-speed rail) 2. Multi-platform hotel recommendation (including multi-platform price comparison) 3. Detailed itinerary timeline 4. Budget breakdown table 5. Destination guide (weather/food/scenic spots) 6. HTML report file (all links can be clicked and jumped)