flightclaw

FlightClaw 智能体：用 AI 预订航班

通过 AI 助手搜索航班、跟踪价格并预订。FlightClaw 是一款 AI 航班预订 Agent 和 MCP 服务，适用于 Claude、ChatGPT、Cursor、VS Code 及任何 MCP 客户端。它涵盖约 300 家航空公司，可查找低价航班、记住旅客信息和偏好，还能跟踪航班价格，并在跟踪的票价下降时发送邮件通知。了解详情，请访问 flightclaw.com。

技能

适用于托管 MCP 服务（https://mcp.flightclaw.com/mcp）的 Agent 技能。每项技能都会告诉 Agent 应调用哪些工具、按什么顺序调用，以及何时应先询问用户。

技能	用途
book-flight	使用 AI 搜索、比较并预订航班，然后通过结账链接或 Link 虚拟卡付款
track-flight-price	每天跟踪票价，并在价格下降时收到邮件提醒
plan-group-trip	保存旅客和群组，搜索多城市行程，并一次性为所有人预订
manage-booking	查找订单和预订编号、查询改签报价，以及获取退款报价并取消预订
traveler-profile	保存你本人、同行者、偏好、银行卡、积分余额和旅行记录

根目录中的 SKILL.md 介绍本地开源服务。

选项 1：托管 MCP（推荐）

服务 URL：https://mcp.flightclaw.com/mcp（可流式传输的 HTTP，OAuth 登录）。 无需安装。

客户端	设置
Claude（网页 / 桌面）	Settings > Connectors > Add custom connector > 粘贴 https://mcp.flightclaw.com/mcp
ChatGPT	Settings > Apps & Connectors > Create (developer mode) > 粘贴 https://mcp.flightclaw.com/mcp
Claude Code	claude mcp add --transport http flightclaw https://mcp.flightclaw.com/mcp
Cursor	一键安装，或将 {"mcpServers":{"flightclaw":{"url":"https://mcp.flightclaw.com/mcp"}}} 添加到 ~/.cursor/mcp.json
VS Code	一键安装，或运行 code --add-mcp '{"name":"flightclaw","type":"http","url":"https://mcp.flightclaw.com/mcp"}'
Windsurf	将 {"mcpServers":{"flightclaw":{"serverUrl":"https://mcp.flightclaw.com/mcp"}}} 添加到 ~/.codeium/windsurf/mcp_config.json

托管工具

分组	工具
搜索	search_flights、search_multi_city、recommend_flights、get_offer、get_seat_map
预订	create_checkout、get_checkout_status、list_orders、get_order、request_change、cancel_order
价格跟踪	track_flight、list_tracked、remove_tracked（每天检查，价格下降时发送邮件提醒）
个人资料	get_me、set_me、save_traveler、list_travelers、get_traveler、delete_traveler、save_group、list_groups、get_group、delete_group、get_preferences、set_preferences、save_card、list_cards、delete_card、set_points_balance、list_points
行程	log_trip、list_trips、get_trip、trips_followup、record_trip_feedback
WiFi	check_flight_wifi（查询特定航班是否提供 WiFi 或 Starlink；数据来自 seatwifi.com）

预订和付款

1. search_flights 会返回报价。每个 total_amount 都包含 FlightClaw 预订费。
2. create_checkout 会返回 checkout_url 以及准确的 total_amount + total_currency。此时尚未扣款。
3. 选择以下两种方式之一付款：
   • 结账链接：旅客打开 checkout_url，使用银行卡付款。
   • 关联虚拟卡：Agent 创建一笔金额恰好为 total_amount（票价 + 预订费）的 Link 支出请求，用户在 Link 中批准后，Agent 使用 Link 虚拟卡在 checkout_url 上付款。Agent 绝不会 支付超过已批准的金额。
4. 使用 get_checkout_status 查询，直到状态变为 completed，然后使用 get_order 获取预订编号。

Agent 绝不会索要银行卡号。

选项 2：本地开源服务

本 README 的其余部分介绍此代码库中的可自托管 Python 服务。 它会搜索 Google Flights，并在本地跟踪价格，无需账号。

本地 MCP 服务

FlightClaw 作为本地 MCP 服务运行，让任何兼容 MCP 的客户端（Claude Code、Claude Desktop 等）都能使用航班搜索和跟踪工具。

设置

# Install dependencies
pip install "flights==0.9.0" "mcp[cli]<2" fastmcp pydantic-settings

# Add to Claude Code
claude mcp add flightclaw -- python3 /path/to/agents/server.py

或者，在 Claude Desktop 中将以下内容添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "flightclaw": {
      "command": "python3",
      "args": ["/path/to/agents/server.py"]
    }
  }
}

工具

工具	说明
search_flights	搜索 Google Flights，查询指定航线的价格
search_dates	查找日期范围内最便宜的出行日期（日历视图）
track_flight	将航线添加到价格跟踪，可选设置目标价格
check_prices	检查所有已跟踪航班的价格变化和提醒
list_tracked	列出所有已跟踪航班及其价格历史
remove_tracked	移除已跟踪的航线
check_flight_wifi	向 seatwifi.com 查询航班（例如 UA1234）是否提供 WiFi 或 Starlink

搜索筛选条件

所有搜索工具均支持：

• 乘客 - 成人、儿童、婴儿（占座或抱坐）
• 航空公司 - 筛选指定航空公司（例如 BA,AA,DL）
• 价格上限 - 以 USD 计的最高价格
• 时长 - 航班总时长上限，单位为分钟
• 时间 - 最早／最晚起飞和抵达时间
• 中途停留 - 中途停留时长上限，单位为分钟
• 排序 - 按 BEST、CHEAPEST、DEPARTURE、ARRIVAL 或 DURATION 排序
• 多个机场 - 以逗号分隔的机场代码（例如 LHR,MAN）
• 日期范围 - 使用 date_to 搜索范围内的每一天

示例提示词

• “搜索 2025-08-01 从 LHR 飞往 JFK 的商务舱航班”
• “查找从 LHR 飞往 JFK、早上 8 点后起飞的 BA 或 VS 直飞航班”
• “7 月从 LHR 飞往 JFK，哪几天的机票最便宜？”
• “搜索从 LHR 飞往 JFK、2 位成人和 1 位儿童、价格低于 $500 的航班”
• “跟踪 2025-07-01 从 LHR 飞往 SFO 的航班，目标价格为 $400”
• “检查我跟踪的航班是否降价”

CLI 脚本

原有 CLI 脚本仍可在 scripts/ 中使用：

# Search flights
python scripts/search-flights.py LHR JFK 2025-07-01 --cabin BUSINESS

# Multiple airports and date ranges
python scripts/search-flights.py LHR,MAN JFK,EWR 2025-07-01 --date-to 2025-07-05

# Track a route
python scripts/track-flight.py LHR JFK 2025-07-01 --target-price 400

# Check for price drops (good for cron)
python scripts/check-prices.py --threshold 5

# List tracked flights
python scripts/list-tracked.py

工作原理

• 通过 fli 库查询 Google Flights
• 根据用户所在地区的货币显示价格（根据 IP 自动检测）
• 价格历史保存在 data/tracked.json 中
• 支持单程和往返航班，以及所有客舱等级（经济舱至头等舱）
• 按航空公司、价格、时长、起飞／抵达时间和中途停留时长筛选
• 多机场和日期范围搜索会扩展为所有组合
• 日期搜索会找出范围内最便宜的出行日期

安装（OpenClaw）

npx skills add flightclaw/agents

安装（Grok）

/plugin marketplace add xai-org/plugin-marketplace
/plugin install flightclaw

安装（Claude Code）

/plugin marketplace add flightclaw/agents
/plugin install flightclaw@flightclaw

安装（Cursor）

/plugin marketplace add flightclaw/agents
/plugin install flightclaw

安装（Gemini CLI）

gemini extensions install https://github.com/flightclaw/agents

每个客户端都会从此代码库读取自己的清单文件——.grok-plugin/、 .claude-plugin/、.cursor-plugin/ 和 gemini-extension.json——并且都会 连接到托管服务 https://mcp.flightclaw.com/mcp。若要改用 本地服务，请使用上文“本地 MCP 服务”中的设置方法。

本地服务

本地服务通过 uv 运行 server.py，并在启动时解析固定版本的依赖项。请先安装 uv；你的计算机上无需运行其他设置步骤。

本地服务可访问的内容及其所需信息

端点	用途	凭据
google.com/travel/flights（通过 fli 库）	航班搜索和价格追踪	无

搜索和价格追踪无需凭据。仅在 HTTP 传输模式下读取 HOST 和 PORT。

FlightClaw 不读取其他环境变量，仅写入自身的 data/ 目录，也不会运行安装脚本。

许可证

MIT — 详见 LICENSE。