olive-young-search

Olive Young 搜索

技能说明

直接使用上游原版 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 账号/会话的私有功能
• 将上游服务器代码复制并维护到本仓库中

前提条件

• 互联网连接
• 推荐 node 20（hmmhmmhm/daiso-mcp 截至 2026-04-05 的 engines.node 为 >=20 <21）
• npx 或 npm
• 如果需要，git

Node 22 本地冒烟测试成功，但出现 EBADENGINE 警告，因此 稳定路径为 Node 20 LTS。

推荐设置：先 CLI，不直接安装 MCP

最快路径是不先进行 MCP 连接，而是通过上游 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

如果需要重试公开端点或固定版本，可以克隆原始仓库，然后用 node 直接运行构建产物 dist/bin.js。
在克隆仓库内，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 的使用路径。
• 已提供 CLI 优先流程，而非直接安装 MCP 服务器。
• 已遵循门店搜索 → 商品搜索 → 库存检查的顺序。
• 已实际引导 /api/oliveyoung/stores、/api/oliveyoung/products、/api/oliveyoung/inventory 中所需的调用。
• 已按门店 stockLabel 为中心总结库存结果。

失败模式

• 公开端点可能因上游内部采集路径（依赖 Zyte）而间歇性返回 5xx/503。
• 区域关键词过于宽泛时，可能混入较远地区的同名门店。
• 热门商品搜索结果较多，先确认前几个较为安全。
• 库存数量因时间差异，实际到店时可能不同。

备注

• 原始项目：https://github.com/hmmhmmhm/daiso-mcp
• npm 包：https://www.npmjs.com/package/daiso
• 本仓库不包含上游代码，仅维护技能/文档。