Flyai
Wire the flyai CLI into agent workflows for semantic and keyword travel search (hotels, flights, mixed trips).
Overview
flyai is an agent skill most often used in Build integrations (also Idea research) that teaches agents to run FlyAI ai-search and keyword-search CLI commands for travel.
Install
npx skills add https://github.com/alibaba-flyai/flyai-skill --skill flyaiWhat is this skill?
- ai-search --query for natural-language trip intent (dates, budget, companions, mixed modalities)
- keyword-search --query with pattern hints for POI, dining, visas, cruises, connectivity
- Documented JSON envelope: status, message, systemMessage, data
- Example queries for Hangzhou itineraries and Shanghai–Tokyo flight plus hotel bundles
Adoption & trust: 1.3k installs on skills.sh; 674 GitHub stars; 2/3 security scanners passed (skills.sh audits).
What problem does it solve?
Your agent needs live travel POI, hotel, and flight answers but you lack a documented CLI contract for semantic and keyword queries.
Who is it for?
Builders adding Alibaba FlyAI travel search to CLI or agent pipelines with natural-language queries.
Skip if: Non-travel products or teams that cannot run external CLIs with network access.
When should I use this skill?
User or workflow needs FlyAI travel semantic or keyword search from the command line with --query.
What do I get? / Deliverables
Agents emit correct flyai commands and interpret JSON status fields for downstream itinerary or booking UX.
- Executed flyai commands with valid --query strings
- Parsed JSON response for downstream agent steps
Recommended Skills
Journey fit
Spans multiple journey phases - primary shelf plus alternate fits below.
Installing and calling flyai commands is integration work during product build, even when queries support trip planning content. Integrations subphase fits CLI parameters, JSON responses, and hooking search into agents or scripts.
Where it fits
Probe demand for multi-day Hangzhou itineraries with budget constraints via ai-search.
Pipe keyword-search results into a concierge agent's context window.
Refresh destination guide snippets using destination-pattern keyword queries.
How it compares
CLI command reference for FlyAI search, not a self-hosted vector DB or generic web scrape skill.
Common Questions / FAQ
Who is flyai for?
Indie devs and agent authors integrating FlyAI travel search into scripts, copilots, or concierge prototypes.
When should I use flyai?
During build when wiring search commands; during idea or validate when researching destinations and offers via the same CLI.
Is flyai safe to install?
CLI skills imply network and vendor trust; review Security Audits on this page and FlyAI credential handling before production use.
SKILL.md
READMESKILL.md - Flyai
# ai-search ref ## AI Search (ai-search) ### Parameters - **--query** (required): Full natural-language query for semantic search - Supports hotels, attractions, flights, trains, and mixed travel intent - Can include complex constraints such as destination, date, budget, companions, preferences, and scenario ### Examples ```bash flyai ai-search --query "五一去杭州玩三天，预算人均2000，想住西湖附近，推荐行程和酒店" flyai ai-search --query "下周从上海去东京，优先直飞，帮我找性价比高的航班和酒店" ``` ### Output Example ```json { "status": 0, "message": "success", "systemMessage": "...", "data": "..." } ``` # keyword-search ref ## Keyword Search (keyword-search) ### Parameters - **--query** (required): Search keywords, supports natural language queries for hotels, flights, etc. - Choose the best-matching query pattern from below: - **Location / Nearby**: e.g. "nearby attractions", "restaurants near {POI}" - **POI general**: e.g. "{POI} free travel", "{POI} routes" - **Attractions / Activities**: e.g. "attraction tickets", "photo tours near {POI}" - **Destination**: e.g. "destination guide", "destination hotels" - **Entertainment / Experiences**: e.g. "hot spring spa", "skiing" - **Tours / Packages**: e.g. "group tour", "custom tour" - **Food & Dining**: e.g. "food guide", "buffet" - **Visa / Documents**: e.g. "visa", "travel insurance" - **Telecom / Connectivity**: e.g. "wifi rental", "SIM card" - **Cruise**: e.g. "cruise", "ocean sightseeing" - **Other**: e.g. "time-based queries", "shopping district {POI}" ### Examples ```bash flyai keyword-search --query "France visa" flyai keyword-search --query "Hangzhou group tour" flyai keyword-search --query "Hangzhou 3-day trip" flyai keyword-search --query "Shanghai cruise" flyai keyword-search --query "Hong Kong SIM card" ``` ### Output Example ```json { "data": { "itemList": [ { "info": { "jumpUrl": "...", "picUrl": "...", "price": "...", "scoreDesc": "", "star": "...", "tags": ["..."], "title": "..." } } ] }, "message": "success", "systemMessage": "...", "status": 0 } ``` # search-flight ref ## Flight Search (search-flight) ### Parameters - **--origin** (required): Departure city or airport - **--destination** (optional): Destination city or airport - **--dep-date** (optional): Departure date (`YYYY-MM-DD`) - **--dep-date-start** / **--dep-date-end** (optional): Departure date range - **--back-date** (optional): Return date - **--back-date-start** / **--back-date-end** (optional): Return date range - **--journey-type** (optional): Journey type - `1` = direct, `2` = connecting - **--seat-class-name** (optional): Cabin class name - **--transport-no** (optional): Flight number - **--transfer-city** (optional): Transfer city - **--dep-hour-start** / **--dep-hour-end** (optional): Departure hour range (24h) - **--arr-hour-start** / **--arr-hour-end** (optional): Arrival hour range (24h) - **--total-duration-hour** (optional): Max total flight duration (hours) - **--max-price** (optional): Max price (CNY) - **--sort-type** (optional): Sort order - `1`: price high → low - `2`: recommended - `3`: price low → high - `4`: duration short → long - `5`: duration long → short - `6`: departure early → late - `7`: departure late → early - `8`: direct first ### Examples ```bash flyai search-flight --origin "北京" --destination "上海" --dep-date 2026-03-15 flyai search-flight --origin "上海" --destination "东京" --dep-date 2026-03-20 --back-date 2026-03-25 --journey-type 1 flyai search-flight --origin "北京" --destination "上海" --dep-date 2026-03-15 --sort-type 3 ``` ### Output Example ```json { "data": { "itemList": [ { "adultPrice": "¥400.0", "journeys": [ { "journeyType": "直达", "segments": [ { "depCityCode": "BJS",