← Back to Skills Marketplace
jackculpan

FlightClaw

by jackculpan · GitHub ↗ · v1.0.1
cross-platform ✓ Security Clean
1351
Downloads
1
Stars
10
Active Installs
2
Versions
Install in OpenClaw
/install flightclaw
Description
Track flight prices using Google Flights data. Search flights, find cheapest dates, filter by airline/time/duration/price, track routes over time, and get al...
README (SKILL.md)

flightclaw

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

Install

npx skills add jackculpan/flightclaw

Or manually:

bash skills/flightclaw/setup.sh

Scripts

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-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).

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).

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.

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

MCP Server

FlightClaw also runs as an MCP server with extended search capabilities:

pip install flights "mcp[cli]"
claude mcp add flightclaw -- python3 server.py

MCP 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.

Usage Guidance
This skill appears to be what it says: a Google‑Flights search and tracker implemented in Python. Before installing, consider: 1) The README/ SKILL.md claims an 'R2 backup' but the code only writes tracked.json locally — if you rely on cloud backup, verify or add it yourself. 2) The tool uses a third‑party 'flights' package to call an internal Google Flights endpoint; this may break if Google changes the API and could have TOS implications — review the 'flights' package and its reputation. 3) setup.sh runs pip install for external packages — inspect those packages (and their versions) before running in a production environment. 4) Tracked data is stored locally (skills/flightclaw/data/tracked.json); if run on a shared machine, treat that file as potentially sensitive metadata. 5) The MCP server exposes tools to MCP clients if you register server.py; only run that on a host you control. If you want to be cautious, run initial tests in a sandbox or isolated environment and audit the 'flights' dependency source before trusting it.
Capability Analysis
Type: OpenClaw Skill Name: flightclaw Version: 1.0.1 The OpenClaw AgentSkills bundle 'flightclaw' is classified as benign. All scripts and the MCP server align with the stated purpose of tracking flight prices using Google Flights. Network communication is exclusively directed to a legitimate Google Flights API endpoint, and local file I/O is confined to `skills/flightclaw/data/tracked.json` for price history persistence. The `setup.sh` script performs standard dependency installation and directory creation. There is no evidence of data exfiltration, malicious execution, persistence mechanisms beyond expected data storage, or prompt injection attempts in SKILL.md.
Capability Assessment
✓ Purpose & Capability
The name/description (search, filter, track flight prices from Google Flights) matches the included Python scripts and server. The code calls a Google Flights endpoint via a third‑party 'flights' client and implements tracking with a local tracked.json — coherent with the stated purpose. One mismatch: SKILL.md claims persistence 'via R2 backup', but the code reads/writes only a local data/tracked.json and contains no R2 integration or credentials.
ℹ Instruction Scope
SKILL.md instructs running setup.sh and the provided scripts (search, track, check, list) and to register an MCP server; those instructions align with the code. The doc also gives an npx install reference to 'jackculpan/flightclaw' and mentions R2 backup which are not reflected in the repository files — this is a documentation inconsistency. The runtime instructions do not ask the agent to read unrelated files or environment variables.
✓ Install Mechanism
There is no registry install spec; the included setup.sh runs 'pip install flights "mcp[cli]"' — a typical Python install from PyPI. No downloads from arbitrary URLs or extracted archives are present. Installing third‑party pip packages is normal but carries the usual supply‑chain risk (review the 'flights' and 'mcp' packages before installing).
✓ Credentials
The skill declares no required environment variables or credentials, and the code does not access system secrets or unrelated config paths. Network access to Google (the Google Flights backend) is required and expected for the stated functionality. There are no other credentials requested, which is proportionate.
✓ Persistence & Privilege
The skill does not request permanent 'always' inclusion and does not modify other skills or system settings. It persists tracking data locally in skills/flightclaw/data/tracked.json; this is within scope for a tracker. Note that running the MCP server exposes registered tools to MCP clients — standard for an MCP tool but something to be aware of if running on a multi‑user host.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install flightclaw
  3. After installation, invoke the skill by name or use /flightclaw
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
FlightClaw 1.0.1 is a major update with expanded search and tracking features, improved script flexibility, and a new MCP server mode. - Renamed from "travelclaw" to "flightclaw" - Added support for multiple airports and date ranges in search and tracking scripts - New MCP server (server.py) provides command tools, advanced filters, calendar search, and integration features - Enhanced filtering: search or limit by airline, time of day, price, flight/layover duration, and sort order - Outputs prices in user-local currency, auto-detected and tracked per route - Updated setup instructions, install options, and expanded SKILL.md documentation
v1.0.0
Track flight prices from Google Flights with this OpenClaw skill. Search routes, monitor prices, and get alerts when prices drop.
Metadata
Slug flightclaw
Version 1.0.1
License —
All-time Installs 10
Active Installs 10
Total Versions 2
Frequently Asked Questions

What is 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 al... It is an AI Agent Skill for Claude Code / OpenClaw, with 1351 downloads so far.

How do I install FlightClaw?

Run "/install flightclaw" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is FlightClaw free?

Yes, FlightClaw is completely free (open-source). You can download, install and use it at no cost.

Which platforms does FlightClaw support?

FlightClaw is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created FlightClaw?

It is built and maintained by jackculpan (@jackculpan); the current version is v1.0.1.

More Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463283 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259410 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200423 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191113 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190156 · by oswalpalash

💬 Comments