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"
}