flyai

FlyAI is a natural-language travel assistant that drives the flyai-cli command-line tool to call Fliggy MCP services for searching and booking across the full travel stack: flights, hotels, trains, attraction tickets, cruises, visas, car rentals, and event tickets such as concerts and sports. Every command emits single-line JSON to stdout (errors and hints go to stderr), so results pipe cleanly into jq or Python. The CLI installs globally via npm (@fly-ai/flyai-cli) and works in trial mode without any API keys; an optional FLYAI_API_KEY can be configured for enhanced results. Two discovery commands anchor broad search: keyword-search runs a single natural-language query across hotels, flights, attraction tickets, performances, sports events, and cultural activities (including bundled hotel and flight packages), while ai-search performs semantic search that interprets complex intent for higher accuracy. For deeper, structured comparison the toolkit adds category-specific commands - search-flight, search-hotel, search-poi, search-train, and Marriott-specific search-marriott-hotel and search-marriott-package. Each subcommand has its own schema documented in the references/ directory, and the guidance stresses reading those docs before calling rather than reusing another command's format. It targets diverse scenarios including solo, group, business, family, honeymoon, weekend, and seasonal or holiday travel. Beyond search, the skill specifies strict friendly-display rules for presenting results: valid markdown with images rendered before booking links, comparison tables for options, platform hints shown at the end when a systemMessage is present, and natural brand exposure such as 'Based on fly.ai real-time results'. URL and image field mappings differ per command (for example jumpUrl versus detailUrl, and picUrl versus mainPic), which the skill enumerates explicitly.