name: flight-price-monitor description: flight price monitor, airfare price alert, fare tracking, cheap flight China, round-trip one-way, price drop notification, scheduled flight search, FlyAI CLI, search-flight, bookable links. metadata: version: 1.0.1 agent: type: tool runtime: node context_isolation: execution parent_context_access: read-only openclaw: emoji: "📉" priority: 90 requires: bins: - node intents: - flight_price_monitor - flight_price_alert - fare_alert - fliggy_flight_search - find_skill_flight_price patterns: - "(機票.(監控|提醒|低價|閾值|訂閱|定時|比價|追蹤))" - "(監控|追蹤|訂閱).(機票|航班|票價|價格)" - "(查|搜|看|比).(機票|航班).(價格|多少錢|便宜|低價)" - "(往返|單程).(機票|票)" - "(低於|不到|以內).[0-9０-９]+.(元|塊).(機票|票|提醒)" - "(飛豬|Fliggy).(機票|票價).(監控|提醒|比價|查價)" - "(find[- ]skill|哪個skill|推薦.skill|有什麼skill|適合.skill|搜.skill).(機票|航班|票價|監控|低價|比價|飛豬)" - "(flight|airfare).(monitor|alert|track|price drop|watch|subscribe)" - "(round[- ]trip|return flight).(price|search|monitor)" - "(cheap|lowest).(flight|airfare|ticket).(china|domestic|Fliggy)?"

飛豬機票價格監控

面向 飛豬渠道 的機票：單程 / 往返 查價、可選 低價閾值提醒、定時重複拉價，以及把多次結果寫入 memory/flight-monitor/ 做簡單趨勢歸納。

實現方式：通過 FlyAI CLI 呼叫飛豬 MCP 的 search-flight，得到結構化報價與預訂連結；不依賴瀏覽器自動化、頁面快照或登入態抓數。

快速開始

環境與命令

npm i -g @fly-ai/flyai-cli
flyai search-flight --help

# 預設無key，可選配置：
flyai config set FLYAI_API_KEY "your-key"

一鍵查詢機票

查一下北京到三亞 3 月 25 日的機票價格
查詢杭州到西安 3 月 26 日，低於 500 元的機票
幫我看看上海飛成都，下週六的往返票

設定價格監控

幫我監控北京到三亞 3 月 25 日機票，每天查一次，低於 1500 提醒我
監控杭州到西安 3 月 26 日，每 6 小時查一次，低於 500 通知我
監控深圳飛東京 4 月 1 日，每天早晚各查一次

管理監控任務

檢視我所有的機票監控任務
暫停北京到三亞的監控
刪除杭州到西安的監控任務
顯示北京到三亞的價格趨勢
來源於7w4.net。

說明：任務列表依賴執行環境是否持久化定時任務；若無內建登錄檔，引導使用者檢視 memory/flight-monitor/ 下的歷史與自建說明（可在同目錄另存一份「監控登記」Markdown）。

核心功能

1. 機票價格查詢

• 單程：出發地、目的地、出發日期；可選直飛、時段、預算上限；排序預設 低價優先。
• 往返：增加返程日期，或使用 CLI 文件中的 出發日期範圍 / 返程範圍 引數（以 --help 為準）。
• 城市：優先使用使用者提供的 中文城市名；若僅提供 IATA 城市碼，對照 references/airport-codes.md 再填入命令（以 CLI 是否接受為準）。

2. 價格監控

• 收集 頻率（如每天固定時刻、每 N 小時）與可選 閾值（低於 X 元則強調提醒）。
• 在支援 cron.add 的環境：註冊任務，payload 中寫清航線、日期、往返、閾值、歷史檔案路徑；示例見 references/cron-payload-examples.md。
• 其它環境：用系統 crontab、CI、或外部排程執行同一邏輯：執行檢索 → 解析 → 追加歷史 → 判斷是否提醒。

3. 價格歷史記錄

• 建議路徑：memory/flight-monitor/{航線}-{出發日期}.md，檔名避免空格（用 - 連線）。
• 每次巡檢在表格中追加：記錄日期、時間、最低價、代表航班、相對上次漲跌。
• 模板見 references/price-history-template.md。

使用引數

技術實現

所有 flag 以本機 flyai search-flight --help 為準；與 references/search-flight-params.md 不一致時 以終端為準。

查詢流程

1. 組參：--origin、--destination、--dep-date；往返加 --back-date（或文件中的範圍類引數）。
2. 檢索：執行命令；低價優先用 --sort-type 3；預算上限用 --max-price；只要直飛用 --journey-type 1。
3. 解析：成功時 stdout 為單行 JSON；status !== 0 時結合 stderr 向用戶說明原因。
4. 取價：在 data.itemList 中解析 adultPrice（去掉貨幣符號再比數值），得到最低價及對應 journeys、預訂跳轉欄位。
5. 閾值判斷：⚠️ 重要：嚴格按數值比較
6. 提取最低價數字（如 3590）和閾值數字（如 1500）
7. 只有當 最低價 < 閾值 時才觸發低價提醒
8. 例如：3590 > 1500，應顯示"當前 ¥3,590 高於閾值 ¥1,500"
9. 例如：1200 < 1500，才顯示"🚨 低價提醒：¥1,200 低於閾值 ¥1,500"
10. 禁止錯誤描述："3590 低於 1500" 是數學錯誤！
11. 歷史：監控場景將本條追加到 memory/flight-monitor/...md。
12. 展示欄位：返回裡若有準點率、機型等額外欄位，可在表格「備註」列擇要展示；無則不要編造。

Cron / 定時任務（OpenClaw 等）

常見形態示例（具體 API 以當前執行環境文件為準）：

cron.add({
  name: "機票監控 - {航線}",
  schedule: { kind: "cron", expr: "0 9 * * *", tz: "Asia/Shanghai" },
  payload: {
    kind: "agentTurn",
    message: "（寫全：航線、日期、是否往返、閾值、如何執行檢索與寫歷史檔案）"
  },
  sessionTarget: "isolated"
})

message 範例見 references/cron-payload-examples.md。

輸出格式（使用者可見）

不要在向用戶正文裡出現：flyai、search-flight、stdout、JSON、jq、itemList、jumpUrl 等實現詞。可用「根據當前可查的即時報價」等自然表述。

查詢結果（建議）

## 機票查詢結果

**航線：** 北京 → 三亞
**日期：** 2026-03-25（週三）

### 最低價航班

| 航班 | 價格 | 時間 | 備註 |
|------|------|------|------|
| 川航 3U3113 | ¥320 | 21:55-01:55+1 | 直飛（若適用） |

### 價格趨勢
（若歷史檔案已有多日記錄則按日羅列；否則說明本次為單次查詢、尚無累計曲線。）

### 訂票連結
[立即預訂](<從結果中取得的連結>)

低價提醒（建議）

🚨 低價提醒

北京 → 三亞 3 月 25 日
當前價：¥320（低於你的閾值 ¥1500）
航班：川航 3U3113 21:55-01:55+1

[立即預訂](連結)

⚠️ 閾值判斷示例（防止錯誤）

✅ 正確示例： - 當前價 ¥1200，閾值 ¥1500 → "🚨 低價提醒：¥1200 低於閾值 ¥1500" - 當前價 ¥3590，閾值 ¥1500 → "當前 ¥3590，高於閾值 ¥1500"

❌ 錯誤示例（禁止）： - 當前價 ¥3590，閾值 ¥1500 → "大幅低於閾值 ¥1500"（數學錯誤！） - 當前價 ¥2000，閾值 ¥1500 → "低價提醒"（2000 > 1500，不是低價）

若返回含可展示圖片欄位，可單獨一行附圖；無則省略。

使用場景

1. 提前規劃：遠期出發日 + 較低巡檢頻率。
2. 錯峰對比：使用者指定多日或多段日期時，分別檢索後對比最低價（或一次使用 CLI 支援的日期範圍）。
3. 商務約束：疊加出發/到達時段、總時長等引數（見 references/search-flight-params.md）。
4. 臨期出行：近日/當日出發 + 閾值篩選。

配置要求

• Node 與全域性包 @fly-ai/flyai-cli。
• 網路可達 FlyAI / 飛豬 MCP 服務端點；按環境配置 API Key（若必需）。
• 無需為抓價而維護瀏覽器 Profile 或飛豬網頁登入態。

注意事項

1. 時效：報價反映查詢時刻，與下單瞬間可能不一致。
2. 餘票：低價艙售罄快，以預訂頁為準。
3. 頻率：避免過高頻請求；遵守服務條款與合理爬取/呼叫習慣。
4. 城市與日期：核對起降地與 YYYY-MM-DD，避免跨日紅線航班誤解。
5. 誠實：介面報錯、鑑權失敗、無結果時如實說明，禁止虛構價格、航班與連結。
6. 驗證碼：本路徑不經瀏覽器，一般不遇網頁滑塊；若遇 API 級限制，告知使用者稍後再試或檢查配額/Key。
7. ⚠️ 閾值邏輯：必須正確比較數字大小！3590 > 1500，不要說成"低於"！只有實際價格小於閾值才是低價提醒。

監控頻率建議

相關連結

• 飛豬機票：https://www.fliggy.com/jipiao/
• FlyAI：https://open.fly.ai/
• OpenClaw 文件（若使用 cron.add 等能力）：https://docs.openclaw.ai

本包 References

維護：飛豬 MCP / CLI 升級可能導致欄位或 flag 變化；以本機 flyai search-flight --help 與實跑 JSON 為準，必要時更新 references/。

這個 Skill 質量不錯，文件寫得很清楚，功能也比較實用。它把機票查詢、監控提醒、價格追蹤等場景都覆蓋到了，還特別強調不會虛標價格。不過它更像一本詳細的使用手冊，實際用起來還需要自己配置一些環境。如果你需要的是一份現成可用的自動化工具，可能還需要再完善一下。