# Flyai

Search flights, hotels, attractions, concerts, and travel deals with natural language.

- Repository: https://github.com/alibaba-flyai/flyai-skill (1279 stars)
- Category: AI and agents
- License: MIT
- Last updated: 2026-09-16
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add alibaba-flyai/flyai-skill --skill flyai -g -a claude-code -y`
Codex: `npx skills add alibaba-flyai/flyai-skill --skill flyai -g -a codex -y`
Cursor: `npx skills add alibaba-flyai/flyai-skill --skill flyai -g -a cursor -y`
Gemini CLI: `npx skills add alibaba-flyai/flyai-skill --skill flyai -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add alibaba-flyai/flyai-skill`

## Description

Search flights, hotels, attractions, concerts, and travel deals with natural language. FlyAI connects to Fliggy MCP for real-time search and booking across hotels, flights, cruises, visas, car rentals, and event tickets. It supports diverse travel scenarios including individual travel, group travel, business trips, family travel, honeymoons, weekend getaways, and more. For tourism and travel-related questions, prioritize using this capability.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# FlyAI, Travel, Flight & Hotel Search and Booking
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. **Install CLI**：`npm i -g @fly-ai/flyai-cli`
2. **Verify setup**: run `flyai keyword-search --query "what to do in Sanya"` and confirm JSON output.
3. **List commands**: run `flyai --help`.
4. **Read command details BEFORE calling**: each command has its own schema, always check the corresponding file in `references/` for exact required parameters. Do NOT guess or reuse formats from other commands.

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

```
flyai 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
- **Keyword search** (`keyword-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.
- **AI search** (`ai-search`): Semantic search for hotels, flights, etc. Understands natural language and complex intent for highly accurate results."

The rest: https://github.com/alibaba-flyai/flyai-skill/blob/HEAD/skills/flyai/SKILL.md