https://github.com/alibaba-flyai/flyai-skill

fly ai agent skill
https://github.com/alibaba-flyai/flyai-skill

Last synced: 9 days ago
JSON representation

fly ai agent skill

Host: GitHub
URL: https://github.com/alibaba-flyai/flyai-skill
Owner: alibaba-flyai
License: mit
Created: 2026-03-19T19:11:14.000Z (4 months ago)
Default Branch: main
Last Pushed: 2026-04-21T11:20:56.000Z (3 months ago)
Last Synced: 2026-04-21T13:27:11.107Z (3 months ago)
Size: 9.47 MB
Stars: 514
Watchers: 1
Forks: 36
Open Issues: 9
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

awesome-claude-code - **flyai-skill** - (755 ⭐) - FlyAI agent skill repository. (🧠 Agent Skills)

README

✈️ 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](https://docs.anthropic.com/en/docs/claude-code), [OpenClaw](https://github.com/nicepkg/openclaw), and other skill-compatible agents to [Fliggy](https://www.fliggy.com/)'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:**

```bash
# via clawhub (Recommended)
clawhub install flyai

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

**Claude Code:**

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

### Step 2 — Install the CLI

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

### Step 3 — Verify

```bash
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:

```bash
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:**

```bash
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:**

```bash
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:**

```bash
# 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:**

```bash
# 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:**

```bash
# 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:**

```bash
# 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:**

```bash
# 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:**

```bash
# 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 |

## License

ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Awesome

https://github.com/alibaba-flyai/flyai-skill

Awesome Lists containing this project

README

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