AgentSkillsCN

flightclaw

对 BioETL 项目文档进行全面审计与更新，适用于 v5.14+ 版本。当被要求审查文档是否陈旧、将文档与代码进行核对、同步 RULES.md 与 REQUIREMENTS.md、更新架构/供应商/合同文档、反映 ADR-010/ADR-014/ADR-017，或识别已失效的文档时使用。

SKILL.md
--- frontmatter
name: flightclaw
description: Track flight prices using Google Flights data. Search flights, track routes over time, and get alerts when prices drop. Requires Python 3.10+ and the 'flights' pip package. Run setup.sh to install dependencies.

flightclaw

Track flight prices from Google Flights. Search routes, monitor prices over time, and get alerts when prices drop.

Install

bash
npx skills add jackculpan/flightclaw

Or manually:

bash
bash skills/flightclaw/setup.sh

Scripts

Search Flights

Find flights for a specific route and date. Supports multiple airports and date ranges.

bash
python skills/flightclaw/scripts/search-flights.py LHR JFK 2025-07-01
python skills/flightclaw/scripts/search-flights.py LHR JFK 2025-07-01 --cabin BUSINESS
python skills/flightclaw/scripts/search-flights.py LHR JFK 2025-07-01 --return-date 2025-07-08
python skills/flightclaw/scripts/search-flights.py LHR JFK 2025-07-01 --stops NON_STOP --results 10
# Multiple airports (searches all combinations)
python skills/flightclaw/scripts/search-flights.py LHR,MAN JFK,EWR 2025-07-01
# Date range (searches each day)
python skills/flightclaw/scripts/search-flights.py LHR JFK 2025-07-01 --date-to 2025-07-05
# Both
python skills/flightclaw/scripts/search-flights.py LHR,MAN JFK,EWR 2025-07-01 --date-to 2025-07-03

Arguments:

  • •origin - IATA airport code(s), comma-separated (e.g. LHR or LHR,MAN)
  • •destination - IATA airport code(s), comma-separated (e.g. JFK or JFK,EWR)
  • •date - Departure date (YYYY-MM-DD)
  • •--date-to - End of date range (YYYY-MM-DD). Searches each day from date to date-to inclusive.
  • •--return-date - Return date for round trips (YYYY-MM-DD)
  • •--cabin - ECONOMY (default), PREMIUM_ECONOMY, BUSINESS, FIRST
  • •--stops - ANY (default), NON_STOP, ONE_STOP, TWO_STOPS
  • •--results - Number of results (default: 5)

Track a Flight

Add a route to the price tracking list and record the current price. Supports multiple airports and date ranges (creates a separate tracking entry for each combination).

bash
python skills/flightclaw/scripts/track-flight.py LHR JFK 2025-07-01
python skills/flightclaw/scripts/track-flight.py LHR JFK 2025-07-01 --target-price 400
python skills/flightclaw/scripts/track-flight.py LHR JFK 2025-07-01 --return-date 2025-07-08 --cabin BUSINESS
# Track multiple airports and dates
python skills/flightclaw/scripts/track-flight.py LHR,MAN JFK,EWR 2025-07-01 --date-to 2025-07-03 --target-price 400

Arguments:

  • •Same as search-flights, plus:
  • •--target-price - Alert when price drops below this amount

Check Prices

Check all tracked flights for price changes. Designed to run on a schedule (cron).

bash
python skills/flightclaw/scripts/check-prices.py
python skills/flightclaw/scripts/check-prices.py --threshold 5

Arguments:

  • •--threshold - Percentage drop to trigger alert (default: 10)

Output: Reports price changes for tracked flights. Highlights drops and alerts when target prices are reached.

List Tracked Flights

Show all flights being tracked with current vs original prices.

bash
python skills/flightclaw/scripts/list-tracked.py

Currency

Prices are returned in the user's local currency based on their IP location. The currency is auto-detected from the Google Flights API response and displayed with the correct symbol (e.g. $, £, ฿, €). Tracked flights store the currency code in tracked.json.

Data

Price history is stored in skills/flightclaw/data/tracked.json and persists via R2 backup.