Tool Docs · Verified 2026-09-24

飛常準 MCP 工具文件

共36個 Tool，按航班動態與分析 / 使用者行程與關注 / 機場與航司 / 票價與低價四類組織，覆蓋航班服務、行程統計、機場天氣、票價監控及火車與空鐵中轉。名稱、引數型別和必填項已核對服務端工具列表，呼叫說明與示例供接入參考。

瀏覽工具目錄36個

航班動態與分析

候選航班列表`getFlightList`

按起降地和日期查詢候選航班列表及列表級摘要。

工具能力候選航班列表

入參

引數名	型別	必填	說明
dep	`string`	必填	出發機場三字碼；多機場用英文逗號分隔
arr	`string`	必填	到達機場三字碼；多機場用英文逗號分隔
date	`string`	必填	查詢日期，格式 yyyy-MM-dd

{
  "dep": "PEK,PKX",
  "arr": "PVG,SHA",
  "date": "2026-07-18"
}

航班動態與分析

航班狀態查詢`getFlightStatus`

融合查詢航班列表和詳情，支援航班號直查、起降地完整詳情及多候選比較。需提供 fnum + date 或 dep + arr + date；起降地只使用機場碼，多機場以英文逗號連線。

工具能力航班狀態查詢

入參

引數名	型別	必填	說明
fnum	`string`	-	航班號，如 MU5102；未傳時需同時提供 dep、arr
date	`string`	必填	查詢日期，格式 yyyy-MM-dd
dep	`string`	-	出發機場三字碼；多機場用英文逗號分隔且不含空格，如 PEK,PKX
arr	`string`	-	到達機場三字碼；多機場用英文逗號分隔且不含空格，如 PVG,SHA

{
  "fnum": "MU5102",
  "date": "2026-07-18"
}

航班動態與分析

航班執行分析`flightAnalyze`

根據航班四要素執行延誤、取消風險和預計起飛區間分析。

工具能力航班執行分析

入參

引數名	型別	必填	說明
fnum	`string`	必填	航班號
date	`string`	必填	航班日期，格式 yyyy-MM-dd
dep	`string`	必填	出發機場三字碼
arr	`string`	必填	到達機場三字碼

{
  "fnum": "MU5102",
  "date": "2026-07-18",
  "dep": "PEK",
  "arr": "SHA"
}

航班動態與分析

飛機執飛航班`getFlightByAircraftNumber`

根據飛機編號或註冊號查詢該飛機執飛的航班。

工具能力飛機執飛航班

入參

引數名	型別	必填	說明
aircraftNumber	`string`	必填	飛機編號或註冊號，如 B-1234、B1234
date	`string`	-	查詢日期，格式 yyyy-MM-dd；預設當天，歷史日期不限，未來最晚為當天後兩天

{
  "aircraftNumber": "B-1234",
  "date": "2026-07-18"
}

航班動態與分析

彩繪機執飛航班`getFlightByPaintName`

按彩繪機名稱或關鍵詞匹配相關飛機，併合並其執飛航班列表。歷史日期不限，未來日期僅支援今天起兩天內。

工具能力彩繪機執飛航班

入參

引數名	型別	必填	說明
flightDesc	`string`	必填	彩繪機名稱或關鍵詞，如熊貓、熊貓彩繪機
date	`string`	-	查詢日期，格式 yyyy-MM-dd；預設當天

{
  "flightDesc": "熊猫"
}

航班動態與分析

前序航班與飛機銜接`getAircraftRotation`

查詢實際執飛飛機、前序航班鏈、前序動態和銜接間隔。銜接風險不代表本班已經或一定會延誤；缺少有效時間資料時風險為 unknown。

工具能力前序航班與飛機銜接

入參

引數名	型別	必填	說明
fnum	`string`	必填	航班號
date	`string`	必填	航班日期，格式 yyyy-MM-dd
dep	`string`	必填	出發機場三字碼
arr	`string`	必填	到達機場三字碼

{
  "fnum": "CA1111",
  "date": "2026-09-25",
  "dep": "PEK",
  "arr": "HET"
}

航班動態與分析

航班服務與舒適度`getFlightServiceProfile`

查詢航班餐食、Wi-Fi、機型、機齡、舒適度、座位和到達遠機位率，可直接按航班四要素呼叫。返回的列舉原值需按欄位字典解釋，缺失值不能當成無服務。

工具能力航班服務與舒適度

入參

引數名	型別	必填	說明
fnum	`string`	必填	航班號
date	`string`	必填	航班日期，格式 yyyy-MM-dd
dep	`string`	必填	出發機場三字碼
arr	`string`	必填	到達機場三字碼

{
  "fnum": "CA1111",
  "date": "2026-09-26",
  "dep": "PEK",
  "arr": "HET"
}

航班動態與分析

航線執行彙總`getRouteOperationSummary`

查詢指定航線的執行彙總狀態。

工具能力航線執行彙總

入參

引數名	型別	必填	說明
dep	`string`	必填	出發城市或機場三字碼
arr	`string`	必填	到達城市或機場三字碼
date	`string`	-	查詢日期；不傳時預設當天

{
  "dep": "BJS",
  "arr": "SHA",
  "date": "2026-07-18"
}

航班動態與分析

航班軌跡線`getFlightTrackLine`

查詢一個或多個航班的飛行軌跡線座標。

工具能力航班軌跡線

入參

引數名	型別	必填	說明
flightStr	`string`	必填	格式：航班號_出發機場三字碼_到達機場三字碼_yyyy-MM-dd_軌跡型別；0 航班、1 火車，多個以英文分號分隔

{
  "flightStr": "MU5102_PEK_SHA_2026-09-24_0"
}

航班動態與分析

民航執行統計`flightMarketData`

按全國、國家、城市、機場或航司維度查詢民航執行統計，支援客運和貨運。

工具能力民航執行統計

入參

引數名	型別	必填	說明
type	`string`	必填	統計維度：whole、country、city、airport、airline
code	`string`	-	國家、城市、機場或航司程式碼；whole 可省略
span	`integer`	-	查詢近多少天
tranmode	`string`	-	passenger 客運，freight 貨運

{
  "type": "whole",
  "span": 7,
  "tranmode": "passenger"
}

航班動態與分析

國家間航線執行統計`flightMarketRouteData`

查詢指定出發、到達國家或地區之間的民航航線執行統計，支援客運和貨運。

工具能力國家間航線執行統計

入參

引數名	型別	必填	說明
orgCtry	`string`	必填	出發國家或地區二字碼
dstCtry	`string`	必填	到達國家或地區二字碼
span	`integer`	-	查詢近多少天
tranmode	`string`	-	passenger 客運，freight 貨運

{
  "orgCtry": "CN",
  "dstCtry": "JP",
  "span": 7,
  "tranmode": "passenger"
}

使用者行程與關注

未來與進行中行程`queryUserFutureTrip`

查詢使用者將要出行或正在進行中的航班行程。

工具能力未來與進行中行程

入參

引數名	型別	必填	說明
identityType	`integer`	-	身份型別：0 乘機、1 接機、2 送機、3 機組、99 僅關注；預設 0

{
  "identityType": 0
}

使用者行程與關注

歷史航班行程`queryUserHistoryTrip`

查詢使用者歷史航班行程列表。

工具能力歷史航班行程

入參

引數名	型別	必填	說明
year	`string`	-	查詢年份，格式 yyyy；預設當年
identityType	`integer`	-	身份型別：0 乘機、1 接機、2 送機、3 機組、99 僅關注；預設 0

{
  "year": "2026",
  "identityType": 0
}

使用者行程與關注

歷史行程統計`queryUserTripStats`

按全部歷史、單年或年份範圍查詢總次數、總里程和總時長等概覽。完整地域、航司與飛機列表使用 queryUserTripDetailStats，延誤明細使用 queryUserTripDelayStats。

工具能力歷史行程統計

入參

引數名	型別	必填	說明
yearStart	`string`	-	起始年份，格式 yyyy
yearEnd	`string`	-	結束年份，格式 yyyy

{
  "yearStart": "2024",
  "yearEnd": "2026"
}

使用者行程與關注

歷史行程明細統計`queryUserTripDetailStats`

按地域、航司或具體飛機註冊號查詢個人歷史航班完整明細。地域統計支援航班和火車；年度總次數、總里程等概覽使用 queryUserTripStats。

工具能力歷史行程明細統計

入參

引數名	型別	必填	說明
year	`integer`	-	統計年份；未傳或傳 0 時查詢全部年份
statType	`string`	必填	area 地域、airline 航司、aircraft 具體執飛機號
tripType	`string`	-	statType=area 時必填：flight 航班、train 火車；火車僅返回城市

{
  "year": 2026,
  "statType": "area",
  "tripType": "flight"
}

使用者行程與關注

個人行程延誤統計`queryUserTripDelayStats`

按航司、機場或具體航班查詢個人歷史行程的延誤率、次數和時長，不代表行業整體表現。delayDuration、delayTime 單位為秒，delayRate 為百分比數值。

工具能力個人行程延誤統計

入參

引數名	型別	必填	說明
year	`integer`	-	統計年份；未傳或傳 0 時查詢全部年份
statType	`string`	必填	airline 按航司、airport 按機場、flight 按具體延誤航班

{
  "year": 2026,
  "statType": "airline"
}

使用者行程與關注

關注航班`followFlight`

僅在使用者明確要求時關注指定航班並設定身份型別。使用者未說明身份時使用 0 乘機人；普通航班查詢不呼叫此工具。

工具能力關注航班

入參

引數名	型別	必填	說明
fnum	`string`	必填	航班號
date	`string`	必填	航班日期，格式 yyyy-MM-dd
dep	`string`	必填	出發機場三字碼
arr	`string`	必填	到達機場三字碼
orderstyle	`string`	必填	0 乘機、1 接機、2 送機、99 僅關注；以字串傳入

{
  "fnum": "MU5102",
  "date": "2026-09-27",
  "dep": "PEK",
  "arr": "SHA",
  "orderstyle": "0"
}

使用者行程與關注

取消關注航班`unfollowFlight`

取消當前使用者對指定航班的關注。

工具能力取消關注航班

入參

引數名	型別	必填	說明
fnum	`string`	必填	航班號
date	`string`	必填	航班日期，格式 yyyy-MM-dd
dep	`string`	必填	出發機場三字碼
arr	`string`	必填	到達機場三字碼

{
  "fnum": "MU5102",
  "date": "2026-07-18",
  "dep": "PEK",
  "arr": "SHA"
}

機場與航司

機場與城市搜尋`searchAirport`

根據機場、城市名稱或關鍵詞查詢機場和城市三字碼。

工具能力機場與城市搜尋

入參

引數名	型別	必填	說明
name	`string`	必填	機場、城市名稱或關鍵詞
region	`string`	-	範圍篩選：CN 中國大陸、INT 全球；不傳預設全球

{
  "name": "北京",
  "region": "CN"
}

機場與航司

電子入境卡攻略`getAirportStrategy`

查詢指定國家或地區是否需要電子入境卡、填寫地址和攻略。空結果不代表無需入境卡，出行前以目的地官方要求為準。

工具能力電子入境卡攻略

入參

引數名	型別	必填	說明
country	`string`	必填	國家或地區 ISO 3166-1 alpha-2 二字碼，如 JP、MY、TH

{
  "country": "MY"
}

機場與航司

經緯度查機場`getAirportByLatLng`

根據經緯度查詢最近機場及同城市機場列表。

工具能力經緯度查機場

入參

引數名	型別	必填	說明
lat	`string`	必填	緯度
lng	`string`	必填	經度

{
  "lat": "31.2304",
  "lng": "121.4737"
}

機場與航司

機場資訊`getAirportInfoByCode`

根據機場三字碼查詢基礎資訊、電話、交通、點評和服務內容。

工具能力機場資訊

入參

引數名	型別	必填	說明
code	`string`	必填	機場 IATA 三字碼，如 PVG

{
  "code": "PVG"
}

機場與航司

航空公司資訊`getAirlineInfoByCode`

根據航司二字碼查詢基礎資訊、電話和服務內容。

工具能力航空公司資訊

入參

引數名	型別	必填	說明
code	`string`	必填	航司二字碼，如 MU

{
  "code": "MU"
}

機場與航司

機場實時大屏`getAirportFlightBoard`

查詢單個機場的實時航班大屏列表。

工具能力機場實時大屏

入參

引數名	型別	必填	說明
local	`string`	必填	城市或機場三字碼，如 PVG
out	`string`	-	0 出港，1 進港

{
  "local": "PVG",
  "out": "0"
}

機場與航司

機場執行概況`getAirportOperationOverview`

查詢指定機場整體、出港或進港航班執行概況。

工具能力機場執行概況

入參

引數名	型別	必填	說明
local	`string`	必填	城市或機場三字碼，如 HFE
out	`string`	-	0 出港，1 進港，2 進出港

{
  "local": "HFE",
  "out": "2"
}

機場與航司

機場天氣與影響`getAirportWeatherBriefing`

聚合機場實時天氣、METAR/TAF 報文、特殊天氣、颱風閃電和預報，給出保守影響判斷。天氣風險不等於具體航班已延誤或取消，缺失資料不代表天氣正常。

工具能力機場天氣與影響

入參

引數名	型別	必填	說明
airportCode	`string`	必填	機場三字碼；只有城市名稱時先用 searchAirport 查詢
date	`string`	-	查詢日期，格式 yyyy-MM-dd；預設當天

{
  "airportCode": "PEK"
}

票價與低價

航線最低價日曆`getFlightTicketPrice`

查詢航線每日最低價日曆，支援單程日期範圍及往返。預設從明天查詢，早於明天的出發日期會調整；查詢具體航班方案與全部價格使用 getRouteFlightTickets。

工具能力航線最低價日曆

入參

引數名	型別	必填	說明
depDateBegin	`string`	-	單程出發日期範圍起始日或往返去程日期，格式 yyyy-MM-dd；預設明天
depDateEnd	`string`	-	單程出發日期範圍結束日，格式 yyyy-MM-dd；預設與調整後的起始日相同，往返不使用
arrDate	`string`	-	返程日期，格式 yyyy-MM-dd；type=2 時必填且不能早於去程日期
dep	`string`	必填	出發城市或機場三字碼
arr	`string`	必填	到達城市或機場三字碼
type	`string`	必填	1 單程，2 往返

{
  "dep": "BJS",
  "arr": "CAN",
  "type": "1",
  "depDateBegin": "2026-10-01"
}

票價與低價

實時票價篩選與比較`getRouteFlightTickets`

用一條只讀 DuckDB SELECT/WITH SQL 查詢、篩選或統計國內及國際航班方案。flights(...) 必須指定 market、按順序排列的 legs 和 cabin，使用城市級三字碼及明確日期；艙等支援 economy、premium_economy、business、first。國內支援單程或標準往返，國際最多 6 程，每次最多 6 個資料來源。預設篩選非共享航班 seg.share IS FALSE；保留 option_id，adult_total 已含稅費，缺失金額不能按 0 處理。結果明細在 MCP content 的 resource block，item.resource 指向其 URI；後續可用返回的 snapshot_id 呼叫 flight_snapshot(...) 複用候選，最低價僅針對實際返回的候選。

工具能力實時票價篩選與比較

入參

引數名	型別	必填	說明
sql	`string`	必填	查詢 flights(...) 或 flight_snapshot(...) 的單條只讀 SELECT/WITH SQL；搜尋引數須為固定字面量

{
  "sql": "SELECT o.option_id, o.adult_total FROM flights(market := 'domestic', legs := [{'dep_city':'BJS','arr_city':'SHA','date':'2026-10-01'}], cabin := 'economy') AS o WHERE o.transfers = 0 AND o.adult_total IS NOT NULL AND EXISTS (SELECT 1 FROM UNNEST(o.legs) AS l(leg) CROSS JOIN UNNEST(leg.segments) AS s(seg) WHERE seg.share IS FALSE) ORDER BY o.adult_total, o.option_id LIMIT 3"
}

票價與低價

國內航線價格預測`domesticPriceForecast`

按國內航線和出發日期查詢價格預測，可篩選航班號；預測不代表實際可訂價格。

工具能力國內航線價格預測

入參

引數名	型別	必填	說明
dep	`string`	必填	出發城市三字碼
arr	`string`	必填	到達城市三字碼
date	`string`	必填	出發日期，格式 yyyy-MM-dd
flightNo	`string`	-	航班號篩選條件

{
  "dep": "BJS",
  "arr": "SHA",
  "date": "2026-10-02"
}

票價與低價

國際鄰近出行推薦`internationalNearbySuggest`

查詢國際及港澳臺出行的鄰近城市、日期和直飛推薦，可傳返程日期。

工具能力國際鄰近出行推薦

入參

引數名	型別	必填	說明
depCityCode	`string`	必填	出發城市三字碼
arrCityCode	`string`	必填	到達城市三字碼
depDate	`string`	必填	出發日期，格式 yyyy-MM-dd
returnDate	`string`	-	返程日期，格式 yyyy-MM-dd

{
  "depCityCode": "BJS",
  "arrCityCode": "TYO",
  "depDate": "2026-10-03",
  "returnDate": "2026-10-08"
}

票價與低價

航班降價提醒`monitorFlightPrice`

為當前使用者建立國內航班票價監控，達到目標價格時傳送簡訊提醒；僅支援未來日期。返回 CREATED 為建立成功、DUPLICATE 為已存在、LIMIT_REACHED 為額度已滿且未建立。

工具能力航班降價提醒

入參

引數名	型別	必填	說明
depCity	`string`	必填	出發城市三字碼
arrCity	`string`	必填	到達城市三字碼
date	`string`	必填	航班日期，格式 yyyy-MM-dd；不支援當天或歷史日期
flightNo	`string`	必填	航班號
thresholdPrice	`integer`	必填	目標價格，單位人民幣元，必須為正整數

{
  "depCity": "BJS",
  "arrCity": "HFE",
  "date": "2026-10-04",
  "flightNo": "CA1501",
  "thresholdPrice": 500
}

票價與低價

我的票價監控`flightPriceMonitorList`

查詢當前使用者未過期的國內航班價格監控，無需傳入引數。

工具能力我的票價監控

入參

引數名	型別	必填	說明

此工具無需傳入引數，使用空物件呼叫。

{}

票價與低價

國內直達火車查詢`domesticDirectTrainSearch`

按日期、出發城市和到達城市查詢國內直達火車，可按兩端車站名稱列表過濾。具體車次的坐席、票價和餘票使用 trainDetail 查詢。

工具能力國內直達火車查詢

入參

引數名	型別	必填	說明
depDate	`string`	必填	出發日期，格式 yyyy-MM-dd
depCityName	`string`	必填	出發城市名稱
arrCityName	`string`	必填	到達城市名稱
depStationNames	`string[]`	-	出發站點名稱列表
arrStationNames	`string[]`	-	到達站點名稱列表

{
  "depDate": "2026-09-28",
  "depCityName": "北京",
  "arrCityName": "上海",
  "depStationNames": [
    "北京南"
  ],
  "arrStationNames": [
    "上海虹桥"
  ]
}

票價與低價

火車票價與餘票詳情`trainDetail`

根據真實車次、日期和兩端車站三字碼查詢坐席、票價、餘票及詳情。車次與站點應取自實際搜尋結果，可附一次中轉上下文。

工具能力火車票價與餘票詳情

入參

引數名	型別	必填	說明
trainNumber	`string`	必填	真實車次號
depDate	`string`	必填	出發日期，格式 yyyy-MM-dd
depStationCode	`string`	必填	出發車站三字碼
arrStationCode	`string`	必填	到達車站三字碼
transferContext	`object`	-	一次中轉上下文

{
  "trainNumber": "G103",
  "depDate": "2026-09-28",
  "depStationCode": "VNP",
  "arrStationCode": "AOH"
}

票價與低價

飛機火車中轉方案`intermodalTransferSearch`

按出行時間視窗查詢飛機與火車之間的一次中轉方案；中轉引用不能用於機票下單。

工具能力飛機火車中轉方案

入參

引數名	型別	必填	說明
depCityCode	`string`	必填	出發城市級三字碼
arrCityCode	`string`	必填	到達城市級三字碼
earliestDepTime	`string`	必填	最早出發時間，格式 yyyy-MM-dd HH:mm
latestArrTime	`string`	必填	最晚到達時間，格式 yyyy-MM-dd HH:mm
latestDepTime	`string`	-	最晚出發時間，格式 yyyy-MM-dd HH:mm
transferType	`string[]`	-	中轉型別列表
sort	`string`	-	排序方式
limit	`integer`	-	返回數量，預設 20，最大 50

{
  "depCityCode": "BJS",
  "arrCityCode": "HFE",
  "earliestDepTime": "2026-09-29 08:00",
  "latestArrTime": "2026-09-29 22:00",
  "limit": 20
}

票價與低價

機場低價航線`getAirportLowPriceRoutes`

查詢指定機場或城市出發的低價航線及目的地榜單。

工具能力機場低價航線

入參

引數名	型別	必填	說明
dep	`string`	必填	出發機場或城市三字碼
depDateBegin	`string`	必填	出發日期範圍開始，格式 yyyy-MM-dd
depDateEnd	`string`	必填	出發日期範圍結束，格式 yyyy-MM-dd

{
  "dep": "HFE",
  "depDateBegin": "2026-10-05",
  "depDateEnd": "2026-10-12"
}