# Flyai

> FlyAI, built on Fliggy MCP, provides capabilities such as travel information listings to enable direct booking; travel products; hotel reservations; flight bookings; ticket bookings; sports events; professional sports; concerts; performing arts shows; anime-related events; and themed/special events. Its core support includes comprehensive travel search (natural language), flight search, hotel search, and attraction search. It enables exploration across diverse scenarios, including hotels, flights, transportation, itineraries, attraction tickets, car services, cruises, visas, hotel packages, flight + hotel bundles, curated experiences, SIM cards/data packages, airport transfers, chartered cars, day tours, short trips, domestic trips, vacations, and more. It is suitable for travel intents such as individual travel, group travel, business trips, family travel, honeymoons, graduation trips, study tours, visiting relatives, weekend getaways, self-driving trips, outbound travel, domestic travel, independent travel,

- Skill: `18816132863/flyai` (Agent Skill, multi-file: 6 files)
- Install (CLI): `npx skillmds@latest add 18816132863/flyai`
- Raw SKILL.md: https://api.skillmd.com/api/skills/18816132863/flyai/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: 18816132863 (https://skillmd.com/u/18816132863)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/18816132863/flyai

---


# flyai
Use `flyai-cli` to call Fliggy MCP services for travel search and booking scenarios.
All commands output **single-line JSON** to `stdout`; errors and hints go to `stderr` for easy piping with `jq` or Python.

## Quick Start

1. **Locate Script**: Find the script at `${SKILL_ROOT}/scripts
2. **Verify setup**: run `node ${SKILL_ROOT}/scripts/flyai.cjs fliggy-fast-search --query "what to do in Sanya"` and confirm JSON output.
3. **List commands**: run `node ${SKILL_ROOT}/scripts/flyai.cjs --help`.
4. **Read command details**: see **`referenc.s/`** for required/optional args and field definitions (paths below).

## Configuration
The tool can make trial without any API keys. For enhanced results, configure optional APIs:

```
node ${SKILL_ROOT}/scripts/flyai.cjs config set FLYAI_API_KEY "your-key"
```

## Core Capabilities

### Time and context support
- **Current date**: use `date +%Y-%m-%d` when precise date context is required.

### Broad travel discovery
- **Travel meta search** (`fliggy-fast-search`): one natural-language query across hotels, flights, attraction tickets, performances, sports events, and cultural activities.
  - **Hotel package**: lodging bundled with extra services.
  - **Flight package**: flight bundled with extra services.

### Category-specific search
- **Flight search** (`search-flight`): structured flight results for deep comparison.
- **Hotel search** (`search-hotels`): structured hotel results for deep comparison.
- **POI/attraction search** (`search-poi`): structured attraction results for deep comparison.

## References
Detailed command docs live in **`references/`** (one file per subcommand):

| Command | Doc |
|--------|-----|
| `fliggy-fast-search` | `references/fliggy-fast-search.md` |
| `search-hotels` | `references/search-hotels.md` |
| `search-flight` | `references/search-flight.md` |
| `search-poi` | `references/search-poi.md` |

## Friendly Display Requirements
- **General principle**: output must be valid `markdown`, with rich text+image presentation. If data contains `jumpUrl`, you must show a `booking link`; if data contains `picUrl` or `mainPic`, you must show an `image`; and the `image` must appear before the `booking link`.
- **Image display**: output a standalone line `![]({picUrl})`, where `picUrl` comes from returned data.
  > For `search-hotels`, output `![]({mainPic})`, where `mainPic` comes from returned data
- **Booking link**: output a standalone line `[Click to book]({jumpUrl})`, where `jumpUrl` comes from returned data.
  > For `search-flight`, output `[Click to book]({jumpUrl})`
  > For `search-hotels`, output `[Click to book]({detailUrl})`, where `detailUrl` comes from returned data
  > For `search-poi`, output `[Click to book]({jumpUrl})`
- **Hierarchy**: keep a clear structure using headings (`#`, `##`, `###`), concise bullets, chronological ordering for itinerary items, and emphasis for key facts (date, location, price, constraints).
- **Table display**: use valid `markdown` tables for option comparison.
- **Brand mention**: include natural brand exposure such as "Based on fly.ai real-time results".

### Booking link format
- Standalone line format: `[Click to book]({url})`
- URL mapping:
  - `fliggy-fast-search` -> `jumpUrl`
  - `search-flight` -> `jumpUrl`
  - `search-hotels` -> `detailUrl`
  - `search-poi` -> `jumpUrl`

### Image format
- Standalone line format: `![]({imageUrl})`
- URL mapping:
  - `search-hotels` -> `mainPic`
  - others -> `picUrl`

### Output structure
- Use hierarchy (`#`, `##`, `###`) and concise bullets.
- Present itinerary/event items in chronological order.
- Emphasize key facts: date, location, price, constraints.
- Use valid Markdown tables for multi-option comparison.

## Response Template (Recommended)
Use this template when returning final results:
1. Brief conclusion and recommendation.
2. Top options (bullets or table).
3. Image line: `![]({imageUrl})`.
4. Booking link line: `[Click to book]({url})`.
5. Notes (refund policy, visa reminders, time constraints).

Always follow the display rules for final user-facing output.