Flight Price Plus

✈️ 机票查询 Skill / Flight Search Skill

通过 https://skill.flight.51smart.com/api/search 查询实时机票，支持单程、往返、价格日历。
Query real-time flights via the 51smart API (skill.flight.51smart.com). Supports one-way, round-trip, and price calendar.

注意 / Note: 本 Skill 直接通过 HTTP POST 调用上述公开 API，无需本地脚本，无需认证。用户数据（城市/日期）仅用于航班查询，不做其他用途。
This skill calls the above public API directly via HTTP POST. No local scripts or authentication required. User data (city/date) is used solely for flight search.

工作流程 / Workflow

1. 解析输入 → 提取出发地、目的地、日期、乘客、舱位、行程类型
2. 补全信息 → 缺少必填字段时询问用户
3. 调用 API → 直接 POST 到 https://skill.flight.51smart.com/api/search
4. 格式化输出 → 中英双语展示结果

第一步：解析用户输入 / Parse Input

舱位代码对照 / Cabin Codes:

• E = 经济舱 Economy
• P = 超级经济舱 Premium Economy
• B = 商务舱 Business
• F = 头等舱 First

第二步：城市 → 机场代码 / City to IATA Code

中国 China

国际 International

未在上表中的城市，请根据通用 IATA 代码规则推断，或询问用户确认机场全称。

第三步：调用 API / Call API

直接发起 HTTP POST 请求，无需运行任何本地脚本。

Endpoint: POST https://skill.flight.51smart.com/api/search
Content-Type: application/json
认证 Auth: 无需 / Not required

单程请求示例 One-way Request

{
  "adultNumber": 1,
  "cabinClass": "E",
  "childNumber": 0,
  "cid": "123456",
  "flightType": "oneWay",
  "flights": [
    {
      "fromCity": "PEK",
      "fromDate": "2026-03-15",
      "toCity": "SHA"
    }
  ]
}

往返请求示例 Round-trip Request

{
  "adultNumber": 2,
  "cabinClass": "B",
  "childNumber": 1,
  "cid": "123456",
  "flightType": "roundTrip",
  "flights": [
    { "fromCity": "PEK", "fromDate": "2026-03-15", "toCity": "NRT" },
    { "fromCity": "NRT", "fromDate": "2026-03-22", "toCity": "PEK" }
  ]
}

价格日历 Price Calendar

价格日历通过连续发送多个单程请求（每天一次）实现，将结果汇总展示。
Price calendar is achieved by sending multiple one-way requests for consecutive dates and aggregating results.

第四步：格式化输出 / Format Output

单程/往返 结果展示

✈️ 北京 (PEK) → 上海 (SHA)    Beijing → Shanghai
📅 2026年3月15日 / Mar 15, 2026  |  经济舱 Economy  |  成人×1

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 #  航班        出发→到达          时长   经停  票价(USD)  行李
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 1  UA1597      22:38→00:06(+1)   1h28m  直飞  $81.86   1PC/23KG
 2  CA1234      09:00→11:20       2h20m  直飞  $95.00   1PC/23KG
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
共 2 个航班  /  2 flights found
最低价 Lowest: $81.86 (税前 before tax)，含税 incl. tax: $116.80

价格日历 结果展示

📅 价格日历 / Price Calendar
✈️ 上海 (SHA) → 洛杉矶 (LAX)  |  经济舱 Economy

日期 Date        最低价 Lowest    航班数
─────────────────────────────────────
2026-04-01      $520.00 ⭐       8班
2026-04-02      $490.00 🏆最低   6班
2026-04-03      $535.00          7班
2026-04-04      $510.00          5班
2026-04-05      $580.00          6班
─────────────────────────────────────
推荐出发日 / Best date: 2026-04-02 ($490.00)

字段解释规则

• 含税总价 = price + tax（成人价格）
• 多乘客 = 成人含税价 × adultNumber + 儿童含税价 × childNumber
• 经停 = segments 数量 - 1，stopQuantity > 0 时显示经停城市
• 行李 = baggages[].pieces + baggages[].weight，freeBaggage: false 时注明需额外购买
• 座位紧张 = maxSeatsRemain ≤ 3 时显示 ⚠️ 仅剩X席

响应关键字段 / Key Response Fields

错误处理 / Error Handling