API 與 MCP 說明
重點摘要：網站提供 8 個免費 JSON API 端點與 5 個 MCP 工具，涵蓋 2027 連假、請假攻略、各國假日人潮、機票購票時機與訂票須知，不用註冊；進階行程規劃每次 0.02 USDC、全部匯出 0.05 USDC。
基本 API 與 MCP 免費、不用註冊。進階行程規劃用 x402 收費（USDC，Base 網路）。
| 端點 | 說明 |
|---|---|
GET /api/long-weekends-2027 | 2027 年 9 個連假 |
GET /api/holidays-2027 | 2027 年所有放假日 |
GET /api/leave-plan?leave=3 | 請 N 天假的最佳連休組合 |
GET /api/strategies-2027 | 每個連假請 1～5 天的攻略 |
GET /api/abroad?country=JP | 目的地 2027 國定假日、旺季與台灣連假撞期 |
GET /api/crowd?country=JP&start=2027-04-03&end=2027-04-06 | 某段日期在目的地的人潮等級 |
GET /api/flight-timing?depart=2027-02-05&dest=JP | 機票購票時機評估 |
GET /api/tickets-guide | 沉浸式劇場、密室逃脫訂票須知 |
GET /api/pro/trip-plan?leave=5&countries=JP,KR,TH | 付費 0.02 USDC：最佳請假窗 × 各目的地人潮 × 購票期，一次排好 |
GET /api/pro/export | 付費 0.05 USDC：全部資料匯出 |
POST /mcp | MCP 工具：get_2027_long_weekends、plan_leave_2027、check_destination_crowd、flight_booking_timing、ticket_booking_guide |
常見問題
怎麼用 API 查請 N 天假的最佳連休？
呼叫 GET /api/leave-plan?leave=3，把 3 換成可請的天數，就會回傳 2027 年請該天數假可連休最長的組合，預設列出 8 組、最多 20 組。
MCP 提供哪些工具？
POST /mcp 提供 5 個工具：get_2027_long_weekends、plan_leave_2027、check_destination_crowd、flight_booking_timing、ticket_booking_guide。
API 需要付費嗎？
基本 API 與 MCP 免費、不用註冊。只有進階的 /api/pro/trip-plan（0.02 USDC）與 /api/pro/export（0.05 USDC）透過 x402 協定在 Base 網路以 USDC 收費。
怎麼查某段日期在目的地的人潮等級？
呼叫 GET /api/crowd，帶入 country（國碼，例如 JP）、start 與 end（YYYY-MM-DD），會回傳當地假日、旺季與人潮等級。