✈️ FlyAI Skill

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 · 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](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 - **Four specialized search commands** — broad discovery 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:** Run the following commands inside Claude Code: ``` /plugin marketplace add alibaba-flyai/flyai-skill /plugin install flyai@alibaba-flyai-flyai-skill ``` Or copy the skill directory directly: ```bash cp -r /path/to/flyai-skill ~/.claude/skills/flyai ``` ### Step 2 — Install the CLI ```bash npm i -g @fly-ai/flyai-cli ``` ### Step 3 — Verify ```bash flyai fliggy-fast-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 four commands, each tailored to a different search pattern: | Command | Purpose | Required Params | |---------|---------|-----------------| | `fliggy-fast-search` | Natural-language meta-search across all travel categories | `--query` | | `search-flight` | Structured flight search with deep filtering | `--origin` | | `search-hotels` | Structured hotel search by destination | `--dest-name` | | `search-poi` | Attraction & POI search by city | `--city-name` | ### `fliggy-fast-search` — Broad Discovery One query, all categories. Hotels, flights, tickets, tours, cruises, visas, SIM cards — it searches everything. **OpenClaw:** ``` /flyai fliggy-fast-search --query "Hangzhou 3-day trip" /flyai fliggy-fast-search --query "France visa" /flyai fliggy-fast-search --query "Shanghai cruise" ``` **Claude Code:** ``` /flyai fliggy-fast-search --query "Hangzhou 3-day trip" /flyai fliggy-fast-search --query "France visa" /flyai fliggy-fast-search --query "Shanghai cruise" ``` **CLI:** ```bash flyai fliggy-fast-search --query "Hangzhou 3-day trip" ``` ### `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-hotels` — Hotel Comparison Search by destination with filters for star rating, bed type, price range, and nearby POIs. **OpenClaw / Claude Code:** ``` /flyai search-hotels --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-hotels \ --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-hotels \ --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: 自然风光 · 山湖田园 · 森林丛林 · 峡谷瀑布 · 沙滩海岛 · 沙漠草原 · 人文古迹 · 古镇古村 · 历史古迹 · 园林花园 · 宗教场所 · 主题乐园 · 水上乐园 · 影视基地 · 动物园 · 植物园 · 海洋馆 · 体育场馆 · 演出赛事 · 剧院剧场 · 博物馆 · 纪念馆 · 展览馆 · 地标建筑 · 市集 · 文创街区 · 城市观光 · 滑雪 · 漂流 · 冲浪 · 潜水 · 露营 · 温泉 |

## 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 fliggy-fast-search --query "5-day Japan trip from Shanghai" /flyai search-hotels --dest-name "Tokyo" --check-in-date 2026-05-01 --check-out-date 2026-05-06 ``` ## 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, 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 [MIT](LICENSE) — Copyright (c) 2026 alibaba-flyai

alibaba-flyai

飞猪旅行搜索技能