alibaba-flyai/flyai-skill

✈️ FlyAI — Travel, Flight & Hotel Search and Booking

Travel search, powered by Fliggy — right inside Claude Code, OpenClaw, and other skill-compatible agents.


Search flights, hotels, attractions, concerts, and more with natural language.
No browser tabs. No app switching. Just ask.











Homepage ·
Quick Start ·
Commands ·
Use Cases ·
Examples

---

Why FlyAI?

You’re deep in a conversation with your AI coding agent — planning a trip, researching venues, comparing options. FlyAI lets you search real-time travel inventory without leaving your terminal. It connects Claude Code, OpenClaw, and other skill-compatible agents to Fliggy’s massive travel platform (part of Alibaba Group), giving you structured, bookable results in seconds.

• Natural language in, structured data out — ask in plain English or Chinese, get JSON you can pipe, filter, or render
• Eight specialized search commands — broad discovery, AI-powered semantic search, or deep comparison, your call
• Bookable results — every result includes direct booking links
• Zero config to start — works out of the box, optional API key for enhanced results

Quick Start

Step 1 — Install the Skill

OpenClaw:

# via clawhub (Recommended)
clawhub install flyai

# or via npx
npx skills add alibaba-flyai/flyai-skill

Claude Code:

cp -r /path/to/flyai-skill/skills/flyai ~/.claude/skills/flyai

Step 2 — Install the CLI

npm i -g @fly-ai/flyai-cli

Step 3 — Verify

flyai keyword-search --query "things to do in Tokyo"

You should see structured JSON output. You’re good to go.

Step 4 — Configure (optional)

The skill works without any API keys. For enhanced results, set one up:

flyai config set FLYAI_API_KEY "your-key"

Commands

FlyAI provides eight commands, each tailored to a different search pattern:

keyword-search — Broad Discovery

One query, all categories. Hotels, flights, tickets, tours, cruises, visas, SIM cards — it searches everything.

OpenClaw:

/flyai keyword-search --query "Hangzhou 3-day trip"
/flyai keyword-search --query "France visa"
/flyai keyword-search --query "Shanghai cruise"

Claude Code:

/flyai keyword-search --query "Hangzhou 3-day trip"
/flyai keyword-search --query "France visa"
/flyai keyword-search --query "Shanghai cruise"

CLI:

flyai keyword-search --query "Hangzhou 3-day trip"

ai-search — Semantic Search

AI-powered semantic search that understands natural language and complex travel intent. Supports hotels, attractions, flights, trains, and mixed queries.

OpenClaw / Claude Code:

/flyai ai-search --query "3-day trip to Hangzhou for Labor Day, budget 2000 per person, want to stay near West Lake"
/flyai ai-search --query "Direct flight from Shanghai to Tokyo next week, find good value flights and hotels"

CLI:

flyai ai-search --query "3-day trip to Hangzhou for Labor Day, budget 2000 per person"

search-flight — Flight Comparison

Structured flight search with sorting, cabin class, price caps, and time filters.

OpenClaw / Claude Code:

/flyai search-flight --origin "Beijing" --destination "Shanghai" --dep-date 2026-04-15

CLI:

# Basic one-way search
flyai search-flight --origin "Beijing" --destination "Shanghai" --dep-date 2026-04-15

# Round trip, direct flights only, sorted by price (low → high)
flyai search-flight \
  --origin "Shanghai" --destination "Tokyo" \
  --dep-date 2026-04-20 --back-date 2026-04-25 \
  --journey-type 1 --sort-type 3

search-train — Train Comparison

Structured train ticket search with sorting, seat class, price caps, and time filters.

OpenClaw / Claude Code:

/flyai search-train --origin "Beijing" --destination "Shanghai" --dep-date 2026-04-15

CLI:

# Basic one-way search
flyai search-train --origin "Beijing" --destination "Shanghai" --dep-date 2026-04-15

# Direct trains only, second class, sorted by price (low → high)
flyai search-train \
  --origin "Shanghai" --destination "Hangzhou" \
  --dep-date 2026-04-20 --journey-type 1 \
  --seat-class-name "second class" --sort-type 3

search-hotel — Hotel Comparison

Search by destination with filters for star rating, bed type, price range, and nearby POIs.

OpenClaw / Claude Code:

/flyai search-hotel --dest-name "Hangzhou" --poi-name "West Lake" --check-in-date 2026-04-10 --check-out-date 2026-04-12

CLI:

# Hotels near West Lake, Hangzhou
flyai search-hotel \
  --dest-name "Hangzhou" --poi-name "West Lake" \
  --check-in-date 2026-04-10 --check-out-date 2026-04-12

# 4-5 star hotels in Sanya under ¥800, sorted by rating
flyai search-hotel \
  --dest-name "Sanya" --hotel-stars "4,5" \
  --sort rate_desc --max-price 800

search-poi — Attractions & Activities

Find attractions by city, category, or level — from AAAAA scenic spots to local surf schools.

OpenClaw / Claude Code:

/flyai search-poi --city-name "Xi'an" --category "历史古迹"

CLI:

# Historical sites in Xi'an
flyai search-poi --city-name "Xi'an" --category "历史古迹"

# Top-rated attractions in Beijing
flyai search-poi --city-name "Beijing" --poi-level 5

# Lakes and gardens in Hangzhou
flyai search-poi --city-name "Hangzhou" --keyword "West Lake" --category "山湖田园"

search-marriott-hotel — Marriott Hotel Search

Search Marriott Group hotels by destination with filters for brand, bed type, price, and nearby POIs.

OpenClaw / Claude Code:

/flyai search-marriott-hotel --dest-name "Shanghai" --hotel-brands "JW Marriott,Sheraton" --check-in-date 2026-04-10 --check-out-date 2026-04-12

CLI:

# Marriott hotels in Shanghai
flyai search-marriott-hotel \
  --dest-name "Shanghai" --hotel-brands "JW Marriott,Sheraton" \
  --check-in-date 2026-04-10 --check-out-date 2026-04-12

# Marriott hotels in Hangzhou under ¥1200, sorted by price
flyai search-marriott-hotel \
  --dest-name "Hangzhou" --sort price_asc --max-price 1200

search-marriott-package — Marriott Package Search

Search Marriott Group hotel packages and bundled deals (e.g., afternoon tea, spa packages) by city, brand, or hotel name.

OpenClaw / Claude Code:

/flyai search-marriott-package --keyword "Shanghai"
/flyai search-marriott-package --keyword "JW Marriott" --sort-type price_asc

CLI:

# Marriott packages in Shanghai
flyai search-marriott-package --keyword "Shanghai"

# JW Marriott packages, sorted by price
flyai search-marriott-package --keyword "JW Marriott" --sort-type price_asc

Featured Use Cases

Weekend Getaway Planning

“Find me a weekend trip from Shanghai — cheap flights, a nice hotel near the beach, and some fun things to do”

FlyAI chains search-flight, search-hotel, and search-poi to give you a complete trip plan with prices and booking links.

Budget Flight Hunting

“What’s the cheapest direct flight from Beijing to Bangkok in May?”

/flyai search-flight --origin "Beijing" --destination "Bangkok" --dep-date-start 2026-05-01 --dep-date-end 2026-05-31 --journey-type 1 --sort-type 3

Group Trip Coordination

“Compare 4-star hotels in Sanya with twin beds for under ¥500/night, sorted by rating”

/flyai search-hotel --dest-name "Sanya" --hotel-stars 4 --hotel-bed-types "双床房" --max-price 500 --sort rate_desc

Train Trip Planning

“Find a direct high-speed train from Beijing to Shanghai next Tuesday, second class”

/flyai search-train --origin "Beijing" --destination "Shanghai" --dep-date 2026-04-07 --journey-type 1 --seat-class-name "second class" --sort-type 3

Smart Trip Planning with AI Search

“Plan a 3-day Hangzhou trip for Labor Day, budget 2000 per person, want to stay near West Lake”

/flyai ai-search --query "3-day Hangzhou trip for Labor Day, budget 2000 per person, stay near West Lake"

Marriott Hotel Deals

“Find Marriott afternoon tea packages in Shanghai”

/flyai search-marriott-package --keyword "Shanghai" --sort-type price_asc

Local Exploration

“What are the top nature attractions in Guilin?”

/flyai search-poi --city-name "Guilin" --category "自然风光" --poi-level 5

Examples

OpenClaw

Just type naturally in OpenClaw — FlyAI activates automatically on travel queries:

Find me direct flights from Beijing to Shanghai next Friday under ¥600

Compare 5-star hotels near the Bund in Shanghai for this weekend

What are the top attractions in Chengdu? I’m interested in nature and history

Or use the slash command directly:

/flyai search-flight --origin "Beijing" --destination "Shanghai" --dep-date 2026-04-25 --max-price 600

Claude Code

Ask naturally or use the /flyai slash command inside Claude Code:

I’m planning a 5-day trip to Japan — search for visa info, flights from Shanghai, and hotels in Tokyo

Find concerts and live events happening in Hangzhou

/flyai keyword-search --query "5-day Japan trip from Shanghai"
/flyai ai-search --query "Best direct flights and hotels for a week in Tokyo"
/flyai search-flight --origin "Shanghai" --destination "Tokyo" --dep-date 2026-05-01 --sort-type 3
/flyai search-train --origin "Shanghai" --destination "Hangzhou" --dep-date 2026-05-01
/flyai search-hotel --dest-name "Tokyo" --check-in-date 2026-05-01 --check-out-date 2026-05-06
/flyai search-poi --city-name "Tokyo" --category "地标建筑"
/flyai search-marriott-hotel --dest-name "Tokyo" --check-in-date 2026-05-01 --check-out-date 2026-05-06
/flyai search-marriott-package --keyword "Shanghai"

How It Works

You ask your agent ──→ FlyAI Skill activates ──→ flyai-cli runs ──→ Fliggy MCP API
                                                                         │
You see rich results ←── Agent formats markdown ←── JSON response ←──────┘

• Runtime: Node.js
• Output: Single-line JSON to stdout, errors/hints to stderr
• Context isolation: Each command runs in its own execution context
• Pattern matching: Intent-based activation at priority 90 — the agent automatically routes travel queries to FlyAI

Travel Scenarios Covered

FlyAI isn’t just for flights and hotels. It spans the full travel lifecycle:

Contact Us

Scan the QR code below to join our DingTalk group for support and updates.

License

MIT — Copyright © 2026 alibaba-flyai