Flight Price Advisor
为普通用户生成简洁、易懂的航班价格总结,包含购买建议和价格分析。
⚠️ 使用前必需配置
本 skill 需要 SerpAPI Key 才能获取实时航班价格数据。
如果用户尚未配置 SerpAPI Key,请先引导用户完成以下步骤:
- 1. 注册 SerpAPI 账号:访问 https://serpapi.com/users/sign_up 免费注册
- 获取 API Key:登录后在 Dashboard 中复制你的 API Key
- 配置项目:
- 复制
price/config.example.json 为
price/config.json
- 将 API Key 填入
config.json 中的
serpapi.apiKey 字段
- 重启服务器使配置生效
💡 SerpAPI 提供免费额度,足够个人使用。配置完成后即可获取真实的航班价格数据。
核心原则
- 1. 文字为主:不使用任何图表组件,纯 Markdown 输出
- 结论先行:第一句给出明确建议(买/等)
- 数据支撑:用简单数字说明为什么
- 语气友好:像朋友一样给建议,不是冷冰冰的数据
输出结构
CODEBLOCK0
触发场景
1. 用户直接问价格
- - "这个航班贵吗?"
- "现在买划算吗?"
- "价格怎么样?"
2. 用户问购买时机
- - "现在买还是再等等?"
- "什么时候买最便宜?"
- "要不要等降价?"
3. 航班搜索后自动展示
当用户搜索航班后,主动提供价格分析。
文案模板
低价场景(低于均价 15%+)
CODEBLOCK1
中价场景(均价±15%)
CODEBLOCK2
高价场景(高于均价 15%+)
CODEBLOCK3
数据格式
输入
CODEBLOCK4
计算逻辑
CODEBLOCK5
Emoji 使用规范
| 场景 | Emoji | 含义 |
|---|
| 价格分析标题 | 💰 | 金钱/价格 |
| 建议标题 |
💡 | 建议/提示 |
| 低价/推荐 | 🟢 ✅ | 通过/推荐 |
| 中价/观望 | 🟡 ⏳ | 等待/中性 |
| 高价/不推荐 | 🔴 ⚠️ | 警告/不推荐 |
| 下降趋势 | 📉 | 价格下降 |
| 上升趋势 | 📈 | 价格上涨 |
| 稳定趋势 | ➡️ | 价格平稳 |
数据源配置
无数据时的用户引导
当检测到没有历史价格数据或 SerpAPI 未配置时,应主动引导用户:
CODEBLOCK6
数据可用性判断
在生成价格总结前,应先检查:
- - 是否有历史价格数据(
price/data/ 目录下的数据文件) - 如果数据不足 7 天,应在输出中标注"数据较少,仅供参考"
- 如果完全没有数据,应提示用户"暂无历史价格数据,请先进行几次航班搜索以积累数据"
注意事项
- 1. 不要过度承诺:用"建议"而非"一定"
- 标注数据来源:说明是基于历史数据
- 考虑时效性:临近出发日期的建议应更积极
- 避免专业术语:不说"百分位",说"比平时便宜 X%"
- 配置检查:使用前确认 SerpAPI Key 已正确配置
与 price-trend 的区别
| 维度 | price-summary | price-trend |
|---|
| 目标用户 | 普通 C 端用户 | 开发者/B 端 |
| 输出形式 |
纯 Markdown 文字 | React 组件/图表 |
| 使用场景 | 对话产品直接输出 | Agent 系统嵌入组件 |
| 复杂度 | 低 | 高 |
| 依赖 | 无 | 需要前端环境 |
示例输出
完整示例
CODEBLOCK7
简短示例(移动端)
CODEBLOCK8
航班价格顾问
为普通用户生成简洁、易懂的航班价格总结,包含购买建议和价格分析。
⚠️ 使用前必需配置
本技能需要 SerpAPI Key 才能获取实时航班价格数据。
如果用户尚未配置 SerpAPI Key,请先引导用户完成以下步骤:
- 1. 注册 SerpAPI 账号:访问 https://serpapi.com/users/sign_up 免费注册
- 获取 API Key:登录后在 Dashboard 中复制你的 API Key
- 配置项目:
- 复制 price/config.example.json 为 price/config.json
- 将 API Key 填入 config.json 中的 serpapi.apiKey 字段
- 重启服务器使配置生效
💡 SerpAPI 提供免费额度,足够个人使用。配置完成后即可获取真实的航班价格数据。
核心原则
- 1. 文字为主:不使用任何图表组件,纯 Markdown 输出
- 结论先行:第一句给出明确建议(买/等)
- 数据支撑:用简单数字说明为什么
- 语气友好:像朋友一样给建议,不是冷冰冰的数据
输出结构
markdown
💰 价格分析
当前价格:¥1,299
价格水位:🟢 低于均价 12%
¥1,450 |
| 60 天最高 | ¥1,899 |
走势:📉 近 7 天下降趋势
💡 建议:现在购买 ✅
当前价格比 60 天平均水平便宜 ¥151,处于较低水位。
如果您行程已确定,建议尽快下单。
数据基于过去 60 天的价格监测
触发场景
1. 用户直接问价格
2. 用户问购买时机
- - 现在买还是再等等?
- 什么时候买最便宜?
- 要不要等降价?
3. 航班搜索后自动展示
当用户搜索航班后,主动提供价格分析。
文案模板
低价场景(低于均价 15%+)
💡 建议:现在购买 ✅
当前价格比 60 天平均水平便宜 ¥XXX,处于历史低位。
这是近 2 个月来最便宜的价格之一,如果您行程确定,建议尽快下单。
📈 类似低价上次出现在 X 月 X 日
中价场景(均价±15%)
💡 建议:可以购买,也可观望 🟡
当前价格接近 60 天平均水平,不算贵但也不是最低。
如果您不着急,可以关注 1-2 周,可能会有小幅下降。
⚠️ 但需注意:临近出发日期价格通常会上涨
高价场景(高于均价 15%+)
💡 建议:再等等 🔴
当前价格比 60 天平均水平贵 ¥XXX,处于历史高位。
建议继续观望,预计 X 周后价格可能回落。
📊 近 30 天最高价出现在 X 月 X 日,当前价格接近该水平
数据格式
输入
javascript
{
currentPrice: 1299,
priceHistory: [
{ date: 2026-01-01, price: 1450 },
// ... 60 天数据
],
origin: 上海,
destination: 东京,
departureDate: 2026-04-15
}
计算逻辑
javascript
// 1. 计算统计值
const min = Math.min(...prices);
const max = Math.max(...prices);
const avg = prices.reduce((a, b) => a + b, 0) / prices.length;
const pctDiff = ((currentPrice - avg) / avg * 100).toFixed(0);
// 2. 判断水位
let level = pctDiff < -15 ? low : pctDiff > 15 ? high : mid;
// 3. 判断趋势(7 日移动平均对比)
const recent7Avg = average(prices.slice(-7));
const previous7Avg = average(prices.slice(-14, -7));
const trend = recent7Avg < previous7Avg ? falling : recent7Avg > previous7Avg ? rising : stable;
Emoji 使用规范
| 场景 | Emoji | 含义 |
|---|
| 价格分析标题 | 💰 | 金钱/价格 |
| 建议标题 |
💡 | 建议/提示 |
| 低价/推荐 | 🟢 ✅ | 通过/推荐 |
| 中价/观望 | 🟡 ⏳ | 等待/中性 |
| 高价/不推荐 | 🔴 ⚠️ | 警告/不推荐 |
| 下降趋势 | 📉 | 价格下降 |
| 上升趋势 | 📈 | 价格上涨 |
| 稳定趋势 | ➡️ | 价格平稳 |
数据源配置
无数据时的用户引导
当检测到没有历史价格数据或 SerpAPI 未配置时,应主动引导用户:
markdown
💡 提示:要获取实时航班价格和价格分析,需要先配置 SerpAPI Key。
快速开始:
- 1. 访问 https://serpapi.com/users/sign_up 免费注册
- 获取 API Key 并填入 price/config.json
- 重新搜索航班,我将为你提供详细的价格分析
目前我可以基于模拟数据提供基础建议,但真实数据会更准确哦~
数据可用性判断
在生成价格总结前,应先检查:
- - 是否有历史价格数据(price/data/ 目录下的数据文件)
- 如果数据不足 7 天,应在输出中标注数据较少,仅供参考
- 如果完全没有数据,应提示用户暂无历史价格数据,请先进行几次航班搜索以积累数据
注意事项
- 1. 不要过度承诺:用建议而非一定
- 标注数据来源:说明是基于历史数据
- 考虑时效性:临近出发日期的建议应更积极
- 避免专业术语:不说百分位,说比平时便宜 X%
- 配置检查:使用前确认 SerpAPI Key 已正确配置
与 price-trend 的区别
| 维度 | price-summary | price-trend |
|---|
| 目标用户 | 普通 C 端用户 | 开发者/B 端 |
| 输出形式 |
纯 Markdown 文字 | React 组件/图表 |
| 使用场景 | 对话产品直接输出 | Agent 系统嵌入组件 |
| 复杂度 | 低 | 高 |
| 依赖 | 无 | 需要前端环境 |
示例输出
完整示例
markdown
💰 上海 → 东京 价格分析
当前价格:¥1,299
价格水位:🟢 比均价便宜 12%
| 对比项 | 价格 | 说明 |
|---|
| 60 天最低 | ¥1,199 | 出现在 2/15 |
| 60 天平均 |
¥1,450 | — |
| 60 天最高 | ¥1,899 | 出现在春节期间 |
近期走势:📉 连续 7 天下降
💡 建议:现在购买 ✅
当前价格处于近 2 个月的较低水平,比平时便宜约 ¥151。
如果您行程已确定(4 月 15 日出行的话),现在是比较好的入手时机。
通常来说,国际航班提前 1-2 个月预订价格最优。
📊 数据基于过去 60 天的价格监测,仅供参考
简短示例(移动端)
💰 当前价格:¥1,299
🟢 比均价便宜 12% | 📉 近 7 天下降
💡 建议现在购买 — 价格处于低位,行程确定可入手