← 返回 Skills 市场
jackculpan

FlightClaw

作者 jackculpan · GitHub ↗ · v1.0.1
cross-platform ✓ 安全检测通过
1351
总下载
1
收藏
10
当前安装
2
版本数
在 OpenClaw 中安装
/install 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...
使用说明 (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.

安全使用建议
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.
功能分析
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.
能力评估
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.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install flightclaw
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /flightclaw 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
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.
元数据
Slug flightclaw
版本 1.0.1
许可证
累计安装 10
当前安装数 10
历史版本数 2
常见问题

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... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 1351 次。

如何安装 FlightClaw?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install flightclaw」即可一键安装,无需额外配置。

FlightClaw 是免费的吗?

是的,FlightClaw 完全免费(开源免费),可自由下载、安装和使用。

FlightClaw 支持哪些平台?

FlightClaw 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 FlightClaw?

由 jackculpan(@jackculpan)开发并维护,当前版本 v1.0.1。

💬 留言讨论