API 與 MCP 說明
重點摘要：生活即時查詢提供 11 個免註冊 JSON API 端點與 7 個 MCP 工具，涵蓋連假補班、彩券開獎與對獎、統一發票號碼與對獎、中油油價；付費端點以 x402（USDC）收費，批次對獎每次最多 500 張。
免費 JSON API，不用註冊。連假、彩券、發票、油價都可以查。
| 端點 | 說明 |
|---|---|
GET /api/fuel | 本週中油牌價與漲跌 |
GET /api/fuel/history?product=95無鉛汽油 | 近 12 週牌價 |
GET /api/invoice/latest | 最新一期發票中獎號碼 |
GET /api/invoice/{期別} | 指定期別，例如 115-05-06 |
GET /api/invoice/check?number=12345678&period= | 對獎（period 不填 = 最新一期） |
GET /api/holidays?year=2026 | 全年國定假日、連假、補班日 |
GET /api/holidays/next | 今天是否放假、下一個連假、近期假日 |
GET /api/is-holiday?date=2026-10-09 | 指定日期是否放假 |
GET /api/lottery/latest | 大樂透、威力彩、今彩539 最新開獎 |
GET /api/lottery/{lotto649|superlotto638|daily539} | 近 20 期開獎 |
GET /api/lottery/check?game=lotto649&numbers=1,2,3,4,5,6&second= | 彩券對獎（威力彩要帶 second） |
POST /mcp | MCP 工具：get_holidays、is_holiday、get_lottery_results、check_lottery、get_invoice_numbers、check_invoice、get_fuel_prices |
付費端點（x402，USDC）
GET /api/pro/fuel/history?product= 完整油價歷史；POST /api/pro/invoice/check-batch 批次對獎（最多 500 張）。沒有付款時回 HTTP 402。
常見問題
有哪些 MCP 工具？
共 7 個：get_holidays、is_holiday、get_lottery_results、check_lottery、get_invoice_numbers、check_invoice、get_fuel_prices，透過 POST /mcp 呼叫。
發票對獎 API 怎麼用？
呼叫 GET /api/invoice/check?number=12345678，period 不填代表最新一期，也可指定期別如 115-05-06；回傳是否中獎、獎別、獎金與領獎期間。
付費端點有哪些？
GET /api/pro/fuel/history 提供完整油價歷史（0.01 USDC），POST /api/pro/invoice/check-batch 提供批次對獎，一次最多 500 張；未付款時回應 HTTP 402，尚未開放時會顯示未開放。
假日 API 可以查哪些資料？
/api/holidays?year= 取得全年國定假日、連假與補班日；/api/holidays/next 取得今天是否放假、下一個連假與近期假日；/api/is-holiday?date= 查單日。