✈️ 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

FlyAI Demo

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:

Command	Purpose	Required Params
`keyword-search`	Natural-language keyword search across all travel categories	`--query`
`ai-search`	Semantic search — understands complex intent for highly accurate results	`--query`
`search-flight`	Structured flight search with deep filtering	`--origin`
`search-train`	Structured train ticket search with deep filtering	`--origin`
`search-hotel`	Structured hotel search by destination	`--dest-name`
`search-poi`	Attraction & POI search by city	`--city-name`
`search-marriott-hotel`	Marriott Group hotel search by destination	`--dest-name`
`search-marriott-package`	Marriott Group hotel package search	`--keyword`

`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

All flight search options

Flag	Description
`--origin`	Departure city or airport (required)
`--destination`	Arrival city or airport
`--dep-date`	Departure date (`YYYY-MM-DD`)
`--dep-date-start` / `--dep-date-end`	Departure date range
`--back-date`	Return date
`--back-date-start` / `--back-date-end`	Return date range
`--journey-type`	`1` = direct, `2` = connecting
`--seat-class-name`	Cabin class name
`--transport-no`	Flight number
`--transfer-city`	Layover city
`--dep-hour-start` / `--dep-hour-end`	Departure hour range
`--arr-hour-start` / `--arr-hour-end`	Arrival hour range
`--total-duration-hour`	Max flight duration (hours)
`--max-price`	Price ceiling
`--sort-type`	`1` price desc · `2` recommended · `3` price asc · `4` duration asc · `5` duration desc · `6` depart early · `7` depart late · `8` direct first

`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

All train search options

Flag	Description
`--origin`	Departure city or station (required)
`--destination`	Destination city or station
`--dep-date`	Departure date (`YYYY-MM-DD`)
`--dep-date-start` / `--dep-date-end`	Departure date range
`--back-date`	Return date
`--back-date-start` / `--back-date-end`	Return date range
`--journey-type`	`1` = direct, `2` = transit
`--seat-class-name`	Seat class: `second class` · `first class` · `business class` · `hard sleeper` · `soft sleeper`
`--transport-no`	Train number(s), comma-separated
`--transfer-city`	Transfer city(s), comma-separated
`--dep-hour-start` / `--dep-hour-end`	Departure hour range (24h)
`--arr-hour-start` / `--arr-hour-end`	Arrival hour range (24h)
`--total-duration-hour`	Max total travel duration (hours)
`--max-price`	Price ceiling (CNY)
`--sort-type`	`1` price desc · `2` recommended · `3` price asc · `4` duration asc · `5` duration desc · `6` depart early · `7` depart late · `8` direct first

`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

All hotel search options

Flag	Description
`--dest-name`	Destination (country/province/city/district) (required)
`--key-words`	Search keywords
`--poi-name`	Nearby attraction name
`--hotel-types`	`酒店` (hotel) · `民宿` (homestay) · `客栈` (inn)
`--sort`	`distance_asc` · `rate_desc` · `price_asc` · `price_desc` · `no_rank`
`--check-in-date`	Check-in date (`YYYY-MM-DD`)
`--check-out-date`	Check-out date (`YYYY-MM-DD`)
`--hotel-stars`	Star rating, comma-separated (`1`–`5`)
`--hotel-bed-types`	`大床房` (king) · `双床房` (twin) · `多床房` (multi)
`--max-price`	Max price per night (CNY)

`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 "山湖田园"

All POI search options

Flag	Description
`--city-name`	City name (required)
`--keyword`	Attraction name keyword
`--poi-level`	Attraction level (`1`–`5`)
`--category`	Single category from: 自然风光 · 山湖田园 · 森林丛林 · 峡谷瀑布 · 沙滩海岛 · 沙漠草原 · 人文古迹 · 古镇古村 · 历史古迹 · 园林花园 · 宗教场所 · 公园乐园 · 主题乐园 · 水上乐园 · 影视基地 · 动物园 · 植物园 · 海洋馆 · 体育场馆 · 演出赛事 · 剧院剧场 · 博物馆 · 纪念馆 · 展览馆 · 地标建筑 · 市集 · 文创街区 · 城市观光 · 户外活动 · 滑雪 · 漂流 · 冲浪 · 潜水 · 露营 · 温泉

`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

All Marriott hotel search options

Flag	Description
`--dest-name`	Destination (country/province/city/district) (required)
`--key-words`	Search keywords
`--poi-name`	Nearby attraction name
`--hotel-brands`	Marriott brands, comma-separated
`--hotel-name`	Exact or fuzzy hotel name
`--hotel-bed-types`	`大床房` (king) · `双床房` (twin) · `多床房` (multi)
`--max-price`	Max price per night (CNY)
`--sort`	`distance_asc` · `rate_desc` · `price_asc` · `price_desc` · `no_rank`
`--check-in-date`	Check-in date (`YYYY-MM-DD`)
`--check-out-date`	Check-out date (`YYYY-MM-DD`)

`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

All Marriott package search options

Flag	Description
`--keyword`	Search keyword — province, city, brand, hotel name, or selling point (required)
`--sort-type`	`price_asc` · `price_desc`

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:

Category	Examples
Transport	Flights, trains, airport transfers, car rentals, chartered cars
Accommodation	Hotels, homestays, inns, hotel+flight bundles
Experiences	Attraction tickets, day tours, guided tours, curated trips
Events	Concerts, sports events, performing arts, anime events
Services	Visas, travel insurance, SIM cards, WiFi rental
Trips	Cruises, weekend getaways, honeymoons, family vacations, study tours

flyai

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

Why FlyAI?

Quick Start

Step 1 — Install the Skill

Step 2 — Install the CLI

Step 3 — Verify

Step 4 — Configure (optional)

Commands

`keyword-search` — Broad Discovery

`ai-search` — Semantic Search

`search-flight` — Flight Comparison

`search-train` — Train Comparison

`search-hotel` — Hotel Comparison

`search-poi` — Attractions & Activities

`search-marriott-hotel` — Marriott Hotel Search

`search-marriott-package` — Marriott Package Search

Featured Use Cases

Weekend Getaway Planning

Budget Flight Hunting

Group Trip Coordination

Train Trip Planning

Smart Trip Planning with AI Search

Marriott Hotel Deals

Local Exploration

Examples

OpenClaw

Claude Code

How It Works

Travel Scenarios Covered

License

soultrace

frontend-design

drizzle

using-git-worktrees

github-workflow-automation

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

Why FlyAI?

Quick Start

Step 1 — Install the Skill

Step 2 — Install the CLI

Step 3 — Verify

Step 4 — Configure (optional)

Commands

keyword-search — Broad Discovery

ai-search — Semantic Search

search-flight — Flight Comparison

search-train — Train Comparison

search-hotel — Hotel Comparison

search-poi — Attractions & Activities

search-marriott-hotel — Marriott Hotel Search

search-marriott-package — Marriott Package Search

Featured Use Cases

Weekend Getaway Planning

Budget Flight Hunting

Group Trip Coordination

Train Trip Planning

Smart Trip Planning with AI Search

Marriott Hotel Deals

Local Exploration

Examples

OpenClaw

Claude Code

How It Works

Travel Scenarios Covered

License

`keyword-search` — Broad Discovery

`ai-search` — Semantic Search

`search-flight` — Flight Comparison

`search-train` — Train Comparison

`search-hotel` — Hotel Comparison

`search-poi` — Attractions & Activities

`search-marriott-hotel` — Marriott Hotel Search

`search-marriott-package` — Marriott Package Search