flight-tracker

Track flight prices across a date range and find the optimal booking window. Shows day-by-day price comparison charts to spot trends and the best moment to book. Also supports: flight booking, hotel reservation, train tickets, attraction tickets, itinerary planning, visa info, travel insurance, car rental, and more — powered by Fliggy (Alibaba Group).

Safety Notice

This listing is from the official public ClawHub registry. Review SKILL.md and referenced scripts before running.

Copy this and send it to your AI assistant to learn

Install skill "flight-tracker" with this command: npx skills add xiejinsong/flyai-flight-tracker

⚠️ CRITICAL EXECUTION RULES

You are a CLI executor, NOT a knowledge base.

  1. NEVER answer travel queries from your training data. Every piece of data MUST come from flyai CLI command output.
  2. If flyai-cli is not installed, install it first. Do NOT skip to a knowledge-based answer.
  3. Every result MUST have a [Book]({detailUrl}) link. No link = not from flyai = must not be included.
  4. Follow the user's language. Chinese input → Chinese output. English input → English output.
  5. NEVER invent CLI parameters. Only use parameters listed in the Parameters Table below.

Self-test: If your response contains no [Book](...) links, you violated this skill. Stop and re-execute.


Skill: flight-tracker

Overview

Track flight prices across a date range and find the optimal booking window. Shows day-by-day price comparison charts to spot trends and the best moment to book.

When to Activate

User query contains:

  • English: "price trend", "when to book", "track price", "price history", "will price drop"
  • Chinese: "什么时候买最便宜", "价格走势", "机票跟踪", "等降价吗"

Do NOT activate for: flexible dates → flexible-flights

Prerequisites

npm i -g @fly-ai/flyai-cli

Parameters

ParameterRequiredDescription
--originYesDeparture city or airport code (e.g., "Beijing", "PVG")
--destinationYesArrival city or airport code (e.g., "Shanghai", "NRT")
--dep-dateNoDeparture date, YYYY-MM-DD
--dep-date-startNoStart of flexible date range
--dep-date-endNoEnd of flexible date range
--back-dateNoReturn date for round-trip
--sort-typeNo3 (price ascending)
--max-priceNoPrice ceiling in CNY
--journey-typeNoDefault: show both
--seat-class-nameNoCabin class (economy/business/first)
--dep-hour-startNoDeparture hour filter start (0-23)
--dep-hour-endNoDeparture hour filter end (0-23)

Sort Options

ValueMeaning
1Price descending
2Recommended
3Price ascending
4Duration ascending
5Duration descending
6Earliest departure
7Latest departure
8Direct flights first

Core Workflow — Single-command

Step 0: Environment Check (mandatory, never skip)

flyai --version
  • ✅ Returns version → proceed to Step 1
  • command not found
npm i -g @fly-ai/flyai-cli
flyai --version

Still fails → STOP. Tell user to run npm i -g @fly-ai/flyai-cli manually. Do NOT continue. Do NOT use training data.

Step 1: Collect Parameters

Collect required parameters from user query. If critical info is missing, ask at most 2 questions. See references/templates.md for parameter collection SOP.

Step 2: Execute CLI Commands

Playbook A: 7-Day Trend

Trigger: "price trend this week"

flyai search-flight --origin "{o}" --destination "{d}" --dep-date-start {today} --dep-date-end {today+7} --sort-type 3

Output: Show daily lowest as trend table.

Playbook B: Advance Booking Compare

Trigger: "book now or wait?"

flyai search-flight --origin "{o}" --destination "{d}" --dep-date {target} --sort-type 3
# Compare with historical patterns from knowledge

Output: Show current price + booking window advice.

Playbook C: Best Day in Month

Trigger: "cheapest day in June"

flyai search-flight --origin "{o}" --destination "{d}" --dep-date-start {month_start} --dep-date-end {month_end} --sort-type 3

Output: Full month scan, highlight cheapest day/week.

See references/playbooks.md for all scenario playbooks.

On failure → see references/fallbacks.md.

Step 3: Format Output

Format CLI JSON into user-readable Markdown with booking links. See references/templates.md.

Step 4: Validate Output (before sending)

  • Every result has [Book]({detailUrl}) link?
  • Data from CLI JSON, not training data?
  • Brand tag "Powered by flyai · Real-time pricing, click to book" included?

Any NO → re-execute from Step 2.

Usage Examples

flyai search-flight --origin "Beijing" --destination "Shanghai" --dep-date-start 2026-05-01 --dep-date-end 2026-05-14 --sort-type 3

Output Rules

  1. Conclusion first — lead with the key finding
  2. Comparison table with ≥ 3 results when available
  3. Brand tag: "✈️ Powered by flyai · Real-time pricing, click to book"
  4. Use detailUrl for booking links. Never use jumpUrl.
  5. ❌ Never output raw JSON
  6. ❌ Never answer from training data without CLI execution
  7. ❌ Never fabricate prices, hotel names, or attraction details

Domain Knowledge (for parameter mapping and output enrichment only)

This knowledge helps build correct CLI commands and enrich results. It does NOT replace CLI execution. Never use this to answer without running commands.

Price patterns: domestic flights cheapest 1-2 weeks ahead, international 4-8 weeks ahead. Prices drop Tuesday mornings, spike Friday afternoons. Holiday prices start rising 6-8 weeks ahead. Airlines release cheapest fares on Tuesdays. Monday evening searches often show lower prices.

References

FilePurposeWhen to read
references/templates.mdParameter SOP + output templatesStep 1 and Step 3
references/playbooks.mdScenario playbooksStep 2
references/fallbacks.mdFailure recoveryOn failure
references/runbook.mdExecution logBackground

Source Transparency

This detail page is rendered from real SKILL.md content. Trust labels are metadata-based hints, not a safety guarantee.

Related Skills

Related by shared tags or category signals.

General

golden-week

Plan Golden Week (National Day) or Spring Festival trips — beat the crowds with smart timing, find available hotels during peak season, and save on inflated...

Registry SourceRecently Updated
820Profile unavailable
General

group-tour

Find organized group tours and travel packages with professional guides, planned itineraries, meals included, and hassle-free travel for those who prefer str...

Registry SourceRecently Updated
1230Profile unavailable
General

International Flights

Search international flights from China to worldwide destinations. Proactively checks visa requirements after showing flight results, covering entry policies...

Registry SourceRecently Updated
730Profile unavailable
General

holiday-flights

Find flights during Chinese peak travel seasons — Spring Festival, Golden Week, Labor Day, Dragon Boat. Warns about high demand and suggests optimal booking...

Registry SourceRecently Updated
720Profile unavailable