Fliggy Travel Search#

飞猪旅行搜索工具，支持机票、酒店、门票、度假搜索。

安装#

bash

npm install -g fliggy-cli

使用流程（自动检查登录态）#

重要：每次执行搜索前，先检查是否有登录态！

检查登录态#

bash

# 检查是否存在登录状态文件
ls ~/.fliggy-session.json

如果没有登录态#

bash

# 先执行登录
fliggy login

# 登录成功后，登录态自动保存，后续搜索无需重复登录

有登录态后执行搜索#

bash

# 机票搜索
fliggy flight --type oneway --from 北京 --to 上海 --date 2026-05-10 --headless

# 酒店搜索
fliggy hotel --city 北京 --check-in 2026-05-10 --check-out 2026-05-12 --headless

# 门票搜索
fliggy ticket --keyword "故宫门票" --headless

# 度假搜索
fliggy holiday --keyword "三亚跟团游" --headless

登录命令详解#

bash

# 登录飞猪账号并保存状态
fliggy login

# 清除登录状态
fliggy login --clear

登录成功后状态自动保存到 ~/.fliggy-session.json，后续搜索无需重复登录。

机票搜索#

单程机票#

bash

fliggy flight --type oneway --from 北京 --to 上海 --date 2026-05-10

往返机票#

bash

fliggy flight --type round --from 北京 --to 上海 --date 2026-05-10 --return-date 2026-05-15

使用 headless 模式#

bash

fliggy flight --type oneway --from 北京 --to 杭州 --date 2026-05-10 --headless

机票详情查询#

bash

# 按航班号搜索
fliggy flight-detail --keyword "MU5193" --from 北京 --to 上海 --date 2026-05-10

# 按航空公司搜索
fliggy flight-detail --keyword "东航" --from 北京 --to 上海 --date 2026-05-10

# 按机型搜索
fliggy flight-detail --keyword "宽体机" --from 北京 --to 上海 --date 2026-05-10

酒店搜索#

搜索酒店#

bash

fliggy hotel --city 北京 --check-in 2026-05-10 --check-out 2026-05-12

搜索带关键词#

bash

fliggy hotel --city 北京 --check-in 2026-05-10 --check-out 2026-05-12 --keywords "亚奥"

酒店详情查询#

bash

fliggy hotel-detail --name "亚奥国际" --city 北京 --check-in 2026-05-10 --check-out 2026-05-12

门票搜索#

门票搜索会自动访问详情页获取完整信息（价格、评分、销量、标签等）。

搜索门票#

bash

# 搜索景点门票
fliggy ticket --keyword "故宫门票"
fliggy ticket --keyword "香港迪士尼"
fliggy ticket --keyword "黄山门票"

# 使用 headless 模式
fliggy ticket --keyword "故宫门票" --headless

输出示例#

text

景点名称：故宫鼓浪屿外国文物馆
价格：¥12
销量：已售5
特色标签：免预约, 随买随用
链接：https://s.fliggy.com/scenic/detail.htm?sid=23344

度假搜索#

度假搜索会自动访问详情页获取完整信息（行程天数、出发城市、评分、销量、特色标签、酒店舒适度等）。

搜索度假产品#

bash

# 一日游
fliggy holiday --keyword "香港一日游"
fliggy holiday --keyword "北京一日游"

# 跟团游
fliggy holiday --keyword "三亚跟团游"
fliggy holiday --keyword "云南跟团游"

# 多日游
fliggy holiday --keyword "云南5天4晚"
fliggy holiday --keyword "桂林3天2晚"

# 使用 headless 模式
fliggy holiday --keyword "三亚跟团游" --headless

输出示例#

text

产品名称：三亚南山寺天涯海角一日游纯玩含接送
价格：¥112
行程天数：1天0晚
出发城市：三亚出发
评分：4.7分
销量：已售58786
特色标签：无购物, 纯玩, 含餐, 私家团, 自由活动, 含接送
酒店舒适度：准四星

智能 Headless 模式#

使用 --headless 参数时：

场景行为有登录状态🤖 后台运行，不显示浏览器需要登录🖥️ 自动打开浏览器，等待登录登录成功自动保存状态，继续运行

推荐流程：

1. 首次使用： fliggy login
2. 之后所有搜索都用 --headless

命令参数说明#

通用参数#

• --headless: 使用后台模式（不显示浏览器窗口）

机票参数#

• --type: 单程 oneway / 往返 round
• --from: 出发城市
• --to: 到达城市
• --date: 出发日期 (YYYY-MM-DD)
• --return-date: 返回日期 (往返必填)

酒店参数#

• --city: 城市
• --check-in: 入住日期 (YYYY-MM-DD)
• --check-out: 退房日期 (YYYY-MM-DD)
• --keywords: 搜索关键词（可选）

门票/度假参数#

• --keyword: 搜索关键词（景点名称或产品名称）

注意事项#

1. 登录状态有效期约 7-30 天
2. 门票和度假搜索会自动访问详情页获取完整信息
3. 建议首次使用前执行 fliggy login
4. headless 模式需要登录状态，否则会自动打开浏览器

帮助命令#

bash

fliggy --help
fliggy flight --help
fliggy hotel --help
fliggy ticket --help
fliggy holiday --help