微威比價：AI 與程式化存取說明

台灣威士忌搜尋比價。彙整買酒網、酒條通、橡木桶、國泰洋酒四個通路的價格，每日更新一次。 主站 https://wprice.cjh.cc/ 的搜尋在前端 JavaScript 執行； 不執行 JS 的客戶端（AI 助手、爬蟲）請用以下端點。

HTML 搜尋結果頁（最簡單）

GET /search?q=關鍵字 → 伺服器算繪的結果頁，無需 JS。 範例：/search?q=帝王、 /search?maxPrice=2000&q=雪莉桶 （多參數時請按字母序排列，部分 AI 工具會重排參數後做完整網址比對）

JSON API

GET /api/search，參數全部選填：

• q：關鍵字。空白分隔為 AND，前綴 - 為排除（例：q=雪莉 -調和）。也接受 search= 或 keyword=
• minPrice / maxPrice：最低價落在此區間（新台幣）
• minAge / maxAge：酒齡區間（年）；設定後無年份標示（NAS）者排除
• sort：asc（價格低→高，預設）或 desc
• limit：回傳筆數，預設 20、上限 50

回傳 { total, shown, generatedAt, products: [...] }；每支酒含 name／nameEn／brand／ageYears／volumeMl／abv／lowestPrice／labels／offers （各通路 sourceName、price（null＝價格洽詢）、url、delisted（true＝該通路已下架）、 priceHistory（僅價格變動過的通路才有））。

範例：/api/search?maxPrice=2000&q=帝王

完整資料集

GET /data.json（約 1MB，每日更新）。欄位為縮寫（n=品名、o=報價、l=標籤索引…）， 一般用途建議直接用 /api/search。另有 /llms.txt（同內容的純文字版）。

使用禮節

• 資料每日 11:00（台北時間）左右更新；相同查詢結果快取一小時
• 請節制請求頻率（有速率限制）
• 價格僅供參考，實際以各通路為準。禁止酒駕，未成年請勿飲酒