# 微威比價（mwprice）

> 台灣威士忌搜尋比價網站。彙整買酒網、酒條通、橡木桶、國泰洋酒四個通路的威士忌價格，
> 每日更新一次。價格僅供參考，實際以各通路為準。

主站 https://wprice.cjh.cc/ 的搜尋在前端 JavaScript 執行；
不執行 JS 的客戶端（AI 助手、爬蟲）請改用下列端點。

## 搜尋 API（建議 AI 使用）

GET https://wprice.cjh.cc/api/search

參數（全部選填）：
- q：關鍵字。空白分隔為 AND，前綴 - 為排除（例：`q=雪莉 -調和`）。比對品名／品牌／標籤
- minPrice / maxPrice：最低價（各通路中的最低者）落在此區間，單位新台幣
- minAge / maxAge：酒齡區間（年）。設定後無年份標示（NAS）者會被排除
- sort：asc（價格低→高，預設）或 desc
- limit：回傳筆數，預設 20、上限 50

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

範例（參數一律按字母序排列——部分 AI 工具會把參數重排後做完整網址比對，
照字母序寫可確保重排後仍與本文提供的網址一致）：
https://wprice.cjh.cc/api/search?maxPrice=2000&q=%E5%B8%9D%E7%8E%8B
https://wprice.cjh.cc/api/search?q=%E9%9B%AA%E8%8E%89%E6%A1%B6

## HTML 結果頁（無 JS 也可讀）

GET https://wprice.cjh.cc/search?q=…（參數同上）→ 伺服器算繪的搜尋結果頁。
/s 為 /search 的短別名；q 亦接受 search= 或 keyword= 參數名。

## 完整資料集

GET https://wprice.cjh.cc/data.json（約 1MB，每日更新）

欄位為縮寫：products[].n=品名、e=英文名、b=品牌、a=酒齡、v=容量ml、av=酒精度、
o=各通路報價（s=通路代碼、p=價格（0=洽詢）、u=連結、d=1 已下架、h=價格歷史）、
l=標籤索引（對應頂層 labels[].d）。sources 為通路代碼→名稱對照。
一般用途建議直接用 /api/search，不必自行解析縮寫。

## 注意

- 資料每日 11:00（台北時間）左右更新
- 請節制請求頻率；相同查詢結果會被快取一小時
- 禁止酒駕，未成年請勿飲酒