Olive Young Search

What this skill does

直接使用 upstream 原版 hmmhmmhm/daiso-mcp 與 npm 套件 daiso，提供 Olive Young 門市搜尋、商品搜尋、庫存確認 的完整流程指引。

本儲存庫不會 vendoring 原版 MCP 伺服器程式碼。相反地，預設採用 不安裝 MCP 伺服器至 Claude Code，而是先以 CLI 形式驗證 的路徑。

核心查詢路徑：

門市搜尋：/api/oliveyoung/stores
商品搜尋：/api/oliveyoung/products
庫存確認：/api/oliveyoung/inventory
健康檢查 (health check)：npx --yes daiso health

When to use

「幫我找明洞附近的 Olive Young 門市」
「幫我看看 Olive Young 有哪些防曬乳」
「幫我查明洞附近的 Olive Young 有沒有防曬乳庫存」
「請掛載 Olive Young 搜尋用的 CLI」

When not to use

登入、下單、購物車、付款等自動化操作
需要 Olive Young 帳號/Session 的私有功能
想要將 upstream 伺服器程式碼複製並維護在本儲存庫內的情況

Prerequisites

網路連線
建議使用 node 20（依據 hmmhmmhm/daiso-mcp 2026-04-05 基準，engines.node 為 >=20 <21）
npx 或 npm
必要時需備有 git

雖然在 Node 22 環境下本機冒煙測試 (smoke test) 成功，但會出現 EBADENGINE 警告，因此建議以 Node 20 LTS 作為穩定執行路徑。

Preferred setup: CLI first, not direct MCP install

最快速的方式是先不進行 MCP 連接，而是直接使用 upstream CLI 來驗證公開 API 端點 (endpoint)。

npx --yes daiso health
npx --yes daiso get /api/oliveyoung/stores --keyword 명동 --limit 5 --json
npx --yes daiso get /api/oliveyoung/products --keyword 선크림 --size 5 --json
npx --yes daiso get /api/oliveyoung/inventory --keyword 선크림 --storeKeyword 명동 --size 5 --json

若需頻繁使用，也可進行全域安裝。

npm install -g daiso
export NODE_PATH="$(npm root -g)"
daiso health

Fallback: clone the original repository and run the same CLI locally

若需要重試公開端點或固定版本，可 clone 原版儲存庫，並直接以 node 執行建置產物 dist/bin.js。
在 clone 後的目錄下執行 npx daiso ... 可能會因 Permission denied 而失敗，因此本機備用方案 (local fallback) 建議採用以下流程：

git clone https://github.com/hmmhmmhm/daiso-mcp.git
cd daiso-mcp
npm install
npm run build
node dist/bin.js health
node dist/bin.js get /api/oliveyoung/stores --keyword 명동 --limit 5 --json
node dist/bin.js get /api/oliveyoung/products --keyword 선크림 --size 5 --json
node dist/bin.js get /api/oliveyoung/inventory --keyword 선크림 --storeKeyword 명동 --size 5 --json

簡而言之，本 Skill 的基本原則是直接安裝/執行原版 hmmhmmhm/daiso-mcp 來使用，在 k-skill 中僅提供指引說明。

Required inputs

1. Store or area keyword first when place context is missing

建議詢問：要以哪個地區/門市為基準？例如：明洞、江南站、聖水
若使用者詢問庫存但未指定地區，請先取得地區/門市關鍵字。

2. Product keyword first when inventory is requested

建議詢問：請提供要搜尋的商品關鍵字，例如：防曬乳、護唇膏、面膜
即使詢問商品種類，也不要接收範圍過於寬泛的關鍵字。

Workflow

1. Check server health

npx --yes daiso health

2. Resolve nearby stores

npx --yes daiso get /api/oliveyoung/stores --keyword 명동 --limit 5 --json

若有多個門市候選，僅摘要前 2~3 個並再次向使用者確認。

3. Resolve product candidates

npx --yes daiso get /api/oliveyoung/products --keyword 선크림 --size 5 --json

若商品候選較多，簡要整理並附上 goodsNumber、價格、圖片 URL 以及 inStock（是否有貨）狀態。

4. Check inventory for the chosen area/store keyword

npx --yes daiso get /api/oliveyoung/inventory --keyword 선크림 --storeKeyword 명동 --size 5 --json

優先檢視回應中 inventory.products[].storeInventory.stores[] 內的以下數值：

stockLabel
remainQuantity
stockStatus
storeName

5. Respond conservatively

最終回覆請按以下順序簡要整理：

基準地區/門市關鍵字
前幾名門市候選
商品候選或已選定的商品
分類標示「有庫存門市 / 售完 / 未販售」
必要時附上 imageUrl 參考連結
由於公開 API 端點的特性，庫存無法 100% 保證即時準確，建議提醒使用者在前往門市前再次確認

Done when

已明確指出 hmmhmmhm/daiso-mcp 原版儲存庫與 daiso CLI 的使用路徑。
已提供 CLI 優先 (CLI-first) 的流程，而非直接安裝 MCP 伺服器。
已遵循「門市搜尋 → 商品搜尋 → 庫存確認」的順序。
已實際指引所需調用的端點，如 /api/oliveyoung/stores、/api/oliveyoung/products、/api/oliveyoung/inventory。
已針對各門市以 stockLabel 為中心摘要庫存結果。

Failure modes

公開端點因 upstream 內部擷取路徑（依賴 Zyte）的狀況，可能會偶發性傳回 5xx / 503 錯誤。
若地區關鍵字範圍過大，可能會混入距離較遠且同名的其他門市。
熱門商品的搜尋結果較多，先整理前幾個供使用者確認會更為穩妥。
庫存數量可能因時間差而與實際到店時有所不同。

Notes

原版專案：https://github.com/hmmhmmhm/daiso-mcp
npm 套件：https://www.npmjs.com/package/daiso
本儲存庫不會 vendoring upstream 程式碼，僅維護 Skill 與相關文件。

olive-young-search

相關技能