flightclaw:Google 航班价格追踪与自动化 - Openclaw Skills

作者:互联网

2026-03-25

AI教程

什么是 flightclaw?

flightclaw 是 Openclaw Skills 生态系统中的一个专门工具,旨在自动化监控航班费用的过程。它使用户能够通过编程方式搜索航线,根据经停次数或舱位等级等特定标准进行筛选,并维护价格波动的历史记录。通过利用 Google 航班数据,它提供了一种可靠的方法来寻找最佳旅行优惠,而无需手动浏览。

该技能专为可扩展性而构建,同时提供独立 CLI 界面和模型上下文协议 (MCP) 服务器实现。这种双重特性允许开发人员将其用于个人自动化脚本,或作为 AI 智能体的工具,协助进行旅行规划和预算优化。

下载入口:https://github.com/openclaw/skills/tree/main/skills/jackculpan/flightclaw

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

npx clawhub@latest install flightclaw

2. 手动安装

将技能文件夹复制到以下位置之一

全局模式 ~/.openclaw/skills/ 工作区 /skills/

优先级:工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

请帮我使用 Clawhub 安装 flightclaw。如果尚未安装 Clawhub,请先安装(npm i -g clawhub)。

Install

flightclaw 应用场景

  • 监控特定航线的价格下跌,以达到目标预算。
  • 同时对多个始发地和目的地机场进行广泛搜索。
  • 通过定时任务 (cron jobs) 自动化每日价格检查,捕捉转瞬即逝的优惠。
  • 通过 MCP 为 AI 智能体提供实时航班数据和基于日历的价格搜索。
flightclaw 工作原理
  1. 用户提供航班参数,包括 IATA 机场代码、日期以及舱位等级等可选过滤器。
  2. flightclaw 与 Google 航班交互,检索当前定价和行程选项。
  3. 该技能根据 IP 位置自动检测用户的本地货币,以实现准确的价格报告。
  4. 用户可以选择追踪特定航线,这将航班元数据保存到本地 JSON 数据库中。
  5. 随后执行 check-prices 脚本时,会将当前数据与存储的基准数据进行比较,以识别价格下跌。

flightclaw 配置指南

通过 CLI 直接安装该技能:

npx skills add jackculpan/flightclaw

如需手动设置或使用 MCP 服务器功能,请确保已安装 Python 3.10+ 并运行:

bash skills/flightclaw/setup.sh
pip install flights "mcp[cli]"

若要与 Claude 等 AI 智能体集成,请将其添加为 MCP 服务器:

claude mcp add flightclaw -- python3 server.py

flightclaw 数据架构与分类体系

该技能在本地文件系统中维护其状态,以确保隐私和便携性。数据结构如下:

位置 格式 用途
skills/flightclaw/data/tracked.json JSON 存储追踪的航线、目标价格和货币代码。
R2 备份 云存储 历史价格数据的可选持久层。
CLI 输出 终端 实时搜索结果,包括航空公司、持续时间和经停信息。
name: 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 alerts when prices drop. Also runs as an MCP server. Requires Python 3.10+ and the 'flights' and 'mcp' pip packages. 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

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.