Olive Young Search

このスキルの概要

upstream オリジナルの hmmhmmhm/daiso-mcp と npm パッケージ daiso をそのまま使用して、Olive Young の店舗検索、商品検索、在庫確認のワークフローをガイドします。

このリポジトリはオリジナルの MCP サーバーコードをベンダリングしません。代わりに、MCP サーバーを Claude Code に直接インストールするのではなく、まず CLI の形式で確認するパスをデフォルトにしています。

主な照会パス：

• 店舗検索：/api/oliveyoung/stores
• 商品検索：/api/oliveyoung/products
• 在庫確認：/api/oliveyoung/inventory
• ヘルスチェック：npx --yes daiso health

使用場面

• 「明洞近くの Olive Young の店舗を探してほしい」
• 「Olive Young にはどんな日焼け止めがあるか見せてほしい」
• 「明洞近くの Olive Young での日焼け止めの在庫を確認してほしい」
• 「Olive Young 検索用の CLI を接続してほしい」

使用しない場面

• ログイン、注文、ショッピングカート、決済の自動化
• Olive Young アカウント/セッションが必要なプライベート機能
• upstream サーバーコードをこのリポジトリにコピーして保守したい場合

前提条件

• インターネット接続
• node 20 推奨（hmmhmmhm/daiso-mcp 2026-04-05 時点で engines.node は >=20 <21）
• npx または npm
• 必要に応じて git

Node 22 でもローカル smoke test は成功していますが、EBADENGINE 警告が表示されるため、安定したパスは Node 20 LTS と考えます。

推奨セットアップ：MCP 直接インストールではなく CLI ファースト

最速のパスは MCP 接続からではなく、upstream CLI で公開エンドポイントを確認することです。

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

フォールバック：オリジナルリポジトリをクローンして同じ CLI をローカルで実行

公開エンドポイントの再試行またはバージョン固定が必要な場合は、オリジナルリポジトリをクローンしてビルド結果物 dist/bin.js を node で直接実行します。 クローンチェックアウト内では npx daiso ... が Permission denied で失敗する可能性があるため、ローカルフォールバックは以下のパスをデフォルトにしています。

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

つまり、このスキルの基本原則は、オリジナルの hmmhmmhm/daiso-mcp をインストール/実行して使用し、k-skill にはガイドのみを追加することです。

必須入力

1. 場所のコンテキストがない場合は、まず店舗または地域キーワード

• 推奨質問：どの地域/店舗を基準に見ましょうか？例：明洞、江南駅、聖水
• 在庫確認の質問で地域がない場合は、まず地域/店舗キーワードを受け取ります。

2. 在庫確認が要求された場合は、まず商品キーワード

• 推奨質問：探す商品のキーワードも教えてください。例：日焼け止め、リップバーム、マスクシート
• 商品の種類を尋ねる場合でも、キーワードを広すぎない範囲で受け取ります。

ワークフロー

1. サーバーのヘルスチェック

npx --yes daiso health

2. 近くの店舗を特定

npx --yes daiso get /api/oliveyoung/stores --keyword 明洞 --limit 5 --json

店舗の候補が複数ある場合は、上位 2～3 個のみをまとめ、再度確認を取ります。

3. 商品の候補を特定

npx --yes daiso get /api/oliveyoung/products --keyword 日焼け止め --size 5 --json

商品の候補が多い場合は、goodsNumber、価格、画像 URL、inStock の有無を一緒に短くまとめます。

4. 選択した地域/店舗キーワードの在庫を確認

npx --yes daiso get /api/oliveyoung/inventory --keyword 日焼け止め --storeKeyword 明洞 --size 5 --json

応答の inventory.products[].storeInventory.stores[] 内で、以下の値を優先的に確認します。

• stockLabel
• remainQuantity
• stockStatus
• storeName

5. 控えめに応答

最終応答は以下の順序で短くまとめます。

• 基準地域/店舗キーワード
• 上位店舗の候補
• 商品の候補または選択された商品
• 在庫がある店舗/品切れ/未販売の区別
• 必要に応じて imageUrl 参考リンク
• 公開エンドポイントの特性上、在庫はリアルタイム 100% 保証値ではないため、訪問直前の再確認を推奨

完了条件

• hmmhmmhm/daiso-mcp オリジナルリポジトリと daiso CLI 使用パスを明示した。
• MCP サーバーを直接インストールする代わりに CLI ファーストなワークフローを提示した。
• 店舗検索 → 商品検索 → 在庫確認の順序に従った。
• /api/oliveyoung/stores、/api/oliveyoung/products、/api/oliveyoung/inventory の中から必要な呼び出しを実際にガイドした。
• 在庫結果を店舗別 stockLabel 中心にまとめた。

障害モード

• 公開エンドポイントは upstream の内部収集パス（Zyte 依存）の事情により、間欠的な 5xx/503 を返す可能性があります。
• 地域キーワードが広すぎると、遠く離れた同名の店舗が混在する可能性があります。
• 人気商品は検索結果が多くなるため、上位数個をまず確認する方が安全です。
• 在庫数量は時間差により実際の訪問時に異なる場合があります。

注釈

• オリジナルプロジェクト：https://github.com/hmmhmmhm/daiso-mcp
• npm パッケージ：https://www.npmjs.com/package/daiso
• このリポジトリは upstream コードをベンダリングせず、スキル/ドキュメントのみを保守します。