mcpField
I
ignav

ignav

github.com/borski生产力78077 次安装2 天前更新
代码仓库

关于 ignav

此技能通过 Ignav REST API 搜索单程或往返航班，并返回结构化价格、行程和预订链接信息，适用于需要比较航班选项的旅客。它支持按舱位、停站数、价格和航空公司筛选。

主要功能

  1. 01搜索单程与往返航班
  2. 02查询机场代码
  3. 03按舱位、价格和停站筛选
  4. 04返回结构化行程与票价
  5. 05获取预订链接

适用场景

  1. 01比较指定日期的航班价格
  2. 02按航空公司或停站数筛选行程
  3. 03为选定行程获取预订链接

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/borski/travel-hacking-toolkit --skill ignav

安装后在 Claude Code 中输入/ignav确认已加载。

详细介绍

通过 Ignav API 搜索航班

基于 https://ignav.com 的快速 REST API 航班搜索。返回包含价格、行程和预订链接的结构化 JSON。提供 1,000 次免费请求，无速率限制。

设置

在 https://ignav.com/signup 免费获取 API 密钥（1,000 次请求，无需信用卡）。

在环境变量或 .env 文件中设置 IGNAV_API_KEY。

工作流

  1. 解析用户的请求（出发地、目的地、日期、行程类型、乘客人数、舱位）
  2. 如果用户提供的是城市名称，则查询机场代码
  3. 搜索航班（单程或往返）
  4. 以 Markdown 表格展示结果
  5. 如果用户想要预订，则获取预订链接

端点

搜索机场
curl -s "https://ignav.com/api/airports?q=Barcelona&limit=5" \
  -H "X-Api-Key: $IGNAV_API_KEY"
单程航班
curl -s -X POST "https://ignav.com/api/fares/one-way" \
  -H "X-Api-Key: $IGNAV_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "origin": "SFO",
    "destination": "JFK",
    "departure_date": "2026-05-15",
    "adults": 1,
    "cabin_class": "economy"
  }'
往返航班
curl -s -X POST "https://ignav.com/api/fares/round-trip" \
  -H "X-Api-Key: $IGNAV_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "origin": "SFO",
    "destination": "JFK",
    "departure_date": "2026-05-15",
    "return_date": "2026-05-20",
    "adults": 1,
    "cabin_class": "economy"
  }'
预订链接
curl -s -X POST "https://ignav.com/api/fares/booking-links" \
  -H "X-Api-Key: $IGNAV_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ignav_id": "the_itinerary_id", "adults": 1}'

参数

参数类型描述
adultsint成人数量（默认值：1）
childrenint儿童数量（默认值：0）
cabin_classstringeconomy、premium_economy、business、first
max_stopsint0（仅限直飞）、1 或 2
max_priceint最高价格筛选条件
departure_time_rangeobject{"earliest_hour": 8, "latest_hour": 20}
airlines_includearray仅包含这些航空公司代码
airlines_excludearray排除这些航空公司代码
marketstring用于定价的国家代码（默认值："US"）。不同市场会返回不同价格。

响应结构

每个行程包含：

  • price：{"amount": 299, "currency": "USD"}
  • outbound：承运航空公司、时长（分钟）、航段数组
  • inbound：同上（单程时为 null）
  • cabin_class：舱位
  • bags：{"carry_on": 1, "checked": 0}
  • ignav_id：用于获取预订链接的唯一 ID

每个航段包含：marketing_carrier_code、flight_number、departure_airport、departure_time_local、arrival_airport、arrival_time_local、duration_minutes、aircraft。

输出格式

始终使用 Markdown 表格。

#航空公司经停时长出发抵达价格行李
1Vueling直飞2h 15m8:30 AM10:45 AMEUR 1251 件随身行李
2Ryanair直飞2h 20m6:15 AM8:35 AMEUR 891 件随身行李

表格之后，突出显示最便宜、最快和性价比最高的选项。指出取舍，并提供预订链接。

说明

  • 所有搜索都必须提供日期
  • 未指定时，默认搜索往返经济舱
  • 按城市名称查找机场时，使用机场搜索端点
  • 市场会影响价格。 同一条航线在不同市场的价格可能相差很大。请先尝试出发地所在国家，再尝试目的地所在国家。
  • 不包含 Southwest。 搜索 SW 时请使用 google-flights skill。

评论

支持 Markdown