一个面向中文用户的旅游规划 Claude Skill,把飞猪真实库存(航班/火车/酒店/景点)和 Wikivoyage 攻略组合成一份可预订的中文行程。
- 🎫 可预订:每条推荐都带飞猪跳转链接,不是虚构信息
- 🌐 国内外全覆盖:国内以飞猪 + Wikivoyage,海外以 Wikivoyage + 飞猪库存补充
- 🆓 零成本:免 API key 即可运行,飞猪体验模式够个人用
- 🧩 组合优于自建:核心数据源用飞猪 FlyAI Skill,不重复造轮子
你: 帮我规划国庆去京都 5 天,和女朋友,预算中等,想住京都站附近
Claude(travel-planner):
1. 先问 3 个关键问题(强度/忌讳/是否已选好日期)
2. 用户回答后:
- 并行调用 flyai search-flight / search-hotel / search-poi
- 调用 wikivoyage.py 拉取 See/Eat/Get around 章节
3. 输出:
# 京都 5 天行程
## 交通(¥7230 单程,国航直飞)
## 每日路线(Day 1 抵达 · Day 2 东山 · Day 3 岚山 · ...)
## 住宿(¥1xxx / 晚,京都站步行 5 分钟)
## 美食 · 预算表 · 避坑提醒 · 数据来源
一份完整示例:examples/kyoto-5days.md
需要:Node.js 18+、Python 3.9+、Claude Code。
# 1. 安装飞猪 CLI(travel-planner 依赖它拿实时数据)
npm i -g @fly-ai/flyai-cli
# 2. 安装本 Skill
git clone https://github.com/Hanzhi0807/travel-planner.git
cp -r travel-planner/skill ~/.claude/skills/travel-planner
# 3. 在 Claude Code 里直接说
# "帮我规划国庆去京都 5 天"
# Claude 会自动激活 travel-planner Skill不用 Claude Code 也能跑,直接命令行:
flyai search-flight --origin 上海 --destination 京都 --dep-date 2026-10-01
python skill/scripts/wikivoyage.py Kyoto --section "See"用户请求(自然语言)
│
▼
travel-planner Skill (SKILL.md)
├─ 多轮澄清(强度/预算/同行/忌讳)
├─ 调用 flyai CLI ──▶ 飞猪库存(航班/火车/酒店/景点)
├─ 调用 wikivoyage.py ──▶ Wikivoyage 攻略段落
└─ 组合输出 Markdown 行程(带预订链接)
为什么这样设计:
- 飞猪 FlyAI Skill 已经把交通/住宿/景点这块做完了(阿里官方、MIT、真实库存、可跳转预订)。重造只会更差
- Wikivoyage 是 CC BY-SA 授权的旅游内容,免费、跨语言、覆盖全球,不涉及爬虫和合规风险
- 两者相加恰好互补:飞猪补结构化的实时价格 + 库存,Wikivoyage 补描述性的"为什么去 / 怎么玩 / 吃什么"
- 不做的事:实时抓小红书/马蜂窝(合规风险)、抢票/下单(平台风险)、复杂旅行社套餐(超出目标)
| 层 | 主源 | 备源 | 备注 |
|---|---|---|---|
| 交通(航班/火车) | 飞猪 FlyAI | LLM 参考区间 | 免 key 价格准确;非飞猪库存的目的地降级为估算 |
| 住宿 | 飞猪 FlyAI | — | 免 key 模式酒店价脱敏(如 ¥1xxx),跳转飞猪看实际价 |
| 景点 | 飞猪 FlyAI + Wikivoyage | — | 飞猪出结构化列表,Wikivoyage 出描述 |
| 攻略文本 | Wikivoyage(zh 优先,en fallback) | — | CC BY-SA 4.0 |
| 天气 | — | 用户自查 | v0.2 计划加 Open-Meteo |
- 飞猪免 key 模式:酒店具体价格脱敏为
¥1xxx档次(点跳转链接看确切价),搜索结果条数受限 - 国际覆盖:飞猪库存以国内 + 亚洲为主,欧美小众城市可能返回很少结果 —— Skill 会诚实告知并让用户去 Booking 交叉核对
- 不做实时抢票:仅查余票和价格,不集成任何购买/抢票逻辑
- Wikivoyage 中文覆盖不均:大城市中文页完整,小城市 fallback 到英文页
- 无 UGC 深度:v0.1 不集成小红书/B 站/马蜂窝(合规/维护成本)。用户可以粘贴笔记链接给 Claude 让它读
- v0.1:飞猪 + Wikivoyage 组合 Skill,支持国内外规划
- v0.2:B 站游记视频信息 + 字幕作为可选 UGC 源(Nemo2011/bilibili-api)
- v0.3:ChromaDB 嵌入式 RAG,预抓 10 个热门目的地的攻略语料
- v0.4:CLI 独立入口(
travel-plan 京都 --dates 2026-10-01:2026-10-05) - v0.5:MCP server 入口
- v0.6:多轮日期性价比比较(自动跑多组日期对比)
- alibaba-flyai/flyai-skill — 提供飞猪真实库存的 Skill / CLI
- Wikivoyage — 用户维护的免费旅游指南
- Anthropic Claude Code / Skills — Skill 运行时
MIT — 见 LICENSE
本项目不 vendor 也不复制飞猪 Skill 的代码,只在 SKILL.md 里指示 Claude 通过 flyai CLI 调用它。Wikivoyage 内容采用 CC BY-SA 4.0,本项目输出攻略时会标注来源。