flyai

1# FlyAI — Travel, Flight & Hotel Search and Booking
2Use `flyai-cli` to call Fliggy MCP services for travel search and booking scenarios.  
3All commands output **single-line JSON** to `stdout`; errors and hints go to `stderr` for easy piping with `jq` or Python.
4 
5## Quick Start
6 
71. **Install CLI**：`npm i -g @fly-ai/flyai-cli`
82. **Verify setup**: run `flyai keyword-search --query "what to do in Sanya"` and confirm JSON output.
93. **List commands**: run `flyai --help`.
104. **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.
11 
12## Configuration
13The tool can make trial without any API keys. For enhanced results, configure optional APIs:
14 
15```
16flyai config set FLYAI_API_KEY "your-key"
17```
18 
19## Core Capabilities
20 
21### Time and context support
22- **Current date**: use `date +%Y-%m-%d` when precise date context is required.
23 
24### Broad travel discovery
25- **Keyword search** (`keyword-search`): one natural-language query across hotels, flights, attraction tickets, performances, sports events, and cultural activities.
26  - **Hotel package**: lodging bundled with extra services.
27  - **Flight package**: flight bundled with extra services.
28- **AI search** (`ai-search`): Semantic search for hotels, flights, etc. Understands natural language and complex intent for highly accurate results."
29 
30### Category-specific search
31…