🧪 Flightclaw
Track flight prices using Google Flights data. Search flights, find cheapest dates, filter by airline/time/duration/price, track routes over time, and get alerts when prices drop. Also runs as an MCP
About Flightclaw
Track flight prices from Google Flights. Search routes, monitor prices over time, and get alerts when prices drop.
At 464 words, this medium prompt gives your agent specialized testing & qa expertise with structured patterns and output formats. Copy it into CLAUDE.md, .cursorrules, or Copilot instructions.
Key Capabilities
- `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)
What This Skill Covers
- Install
- Scripts
- MCP Server
- Currency
- Data
Use Cases
- Writing unit, integration, and end-to-end tests
- Setting up test coverage and CI pipelines
- Refactoring legacy code with confidence using tests
- Creating test plans and QA checklists
Example Prompts
System Prompt (464 words)
flightclaw
Track flight prices from Google Flights. Search routes, monitor prices over time, and get alerts when prices drop.
Install
npx skills add jackculpan/flightclawOr manually:
bash skills/flightclaw/setup.shScripts
Search Flights
Find flights for a specific route and date. Supports multiple airports and date ranges.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-03Arguments:
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).
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 400Arguments:
- 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).
python skills/flightclaw/scripts/check-prices.py
python skills/flightclaw/scripts/check-prices.py --threshold 5Arguments:
--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.python skills/flightclaw/scripts/list-tracked.pyMCP Server
FlightClaw also runs as an MCP server with extended search capabilities:
pip install flights "mcp[cli]"
claude mcp add flightclaw -- python3 server.pyMCP tools: search_flights, search_dates, track_flight, check_prices, list_tracked, remove_tracked
Additional MCP filters: passengers (adults/children/infants), airline filter, price limit, max flight duration, departure/arrival time restrictions, layover duration, sort order, and cheapest-date calendar search.
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.
Frequently Asked Questions
What is Flightclaw?
Flightclaw is a free testing & qa skill for AI coding agents. Track flight prices using Google Flights data. Search flights, find cheapest dates, filter by airline/time/duration/price, track routes over time, and get alerts when prices drop. Also runs as an MCP . It provides a specialized system prompt that configures your agent with testing & qa expertise.
How do I use Flightclaw with Claude Code?
Copy the system prompt below and paste it into your CLAUDE.md file or Claude Code's custom instructions to activate Flightclaw.
Which AI coding agents work with Flightclaw?
Flightclaw is compatible with Claude Code, Cursor, GitHub Copilot, Windsurf, OpenClaw, Cline, and any AI agent that supports custom system prompts or .cursorrules files.
Is Flightclaw free to use?
Yes, Flightclaw is completely free and open source. The full source is available on GitHub at https://github.com/jackculpan/flightclaw/blob/master/SKILL.md. You only need a subscription to the AI agent you use it with.
