flight-price-advisor

# Flight Price Advisor 为普通用户生成简洁、易懂的航班价格总结，包含购买建议和价格分析。 ## ⚠️ 使用前必需配置 **本 skill 需要 SerpAPI Key 才能获取实时航班价格数据。** 如果用户尚未配置 SerpAPI Key，请先引导用户完成以下步骤： 1. **注册 SerpAPI 账号**：访问 [https://serpapi.com/users/sign_up](https://serpapi.com/users/sign_up) 免费注册 2. **获取 API Key**：登录后在 Dashboard 中复制你的 API Key 3. **配置项目**： - 复制 `price/config.example.json` 为 `price/config.json` - 将 API Key 填入 `config.json` 中的 `serpapi.apiKey` 字段 - 重启服务器使配置生效 > 💡 SerpAPI 提供免费额度，足够个人使用。配置完成后即可获取真实的航班价格数据。 ## 核心原则 1. **文字为主**：不使用任何图表组件，纯 Markdown 输出 2. **结论先行**：第一句给出明确建议（买/等） 3. **数据支撑**：用简单数字说明为什么 4. **语气友好**：像朋友一样给建议，不是冷冰冰的数据 ## 输出结构 ```markdown ## 💰 价格分析 ### 当前价格：¥1,299 **价格水位**：🟢 低于均价 12% | 对比项 | 价格 | |--------|------| | 60 天最低 | ¥1,199 | | 60 天平均 | ¥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](https://serpapi.com/users/sign_up) 免费注册 2. 获取 API Key 并填入 `price/config.json` 3. 重新搜索航班，我将为你提供详细的价格分析 > 目前我可以基于模拟数据提供基础建议，但真实数据会更准确哦～ ``` ### 数据可用性判断 在生成价格总结前，应先检查： - 是否有历史价格数据（`price/data/` 目录下的数据文件） - 如果数据不足 7 天，应在输出中标注"数据较少，仅供参考" - 如果完全没有数据，应提示用户"暂无历史价格数据，请先进行几次航班搜索以积累数据" ## 注意事项 1. **不要过度承诺**：用"建议"而非"一定" 2. **标注数据来源**：说明是基于历史数据 3. **考虑时效性**：临近出发日期的建议应更积极 4. **避免专业术语**：不说"百分位"，说"比平时便宜 X%" 5. **配置检查**：使用前确认 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 天下降 💡 **建议现在购买** — 价格处于低位，行程确定可入手 ```