Back to Details

olive-young-search

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Olive Young Search

欧利芙洋搜索

What this skill does

本工具功能

upstream 원본 
hmmhmmhm/daiso-mcp
 와 npm package 
daiso
 를 그대로 사용해 올리브영 매장 검색, 상품 검색, 재고 확인 흐름을 안내한다.
이 저장소는 원본 MCP 서버 코드를 vendoring 하지 않는다. 대신 MCP 서버를 Claude Code에 직접 설치하지 않고 CLI 형태로 먼저 확인하는 경로를 기본값으로 둔다.
핵심 조회 경로:
  • 매장 검색: 
    /api/oliveyoung/stores
  • 상품 검색: 
    /api/oliveyoung/products
  • 재고 확인: 
    /api/oliveyoung/inventory
  • health check: 
    npx --yes daiso health
直接使用上游原始项目 
hmmhmmhm/daiso-mcp
 和npm包 
daiso
，为你提供欧利芙洋门店搜索、商品搜索、库存查询的使用流程指引。
本仓库不引入原始MCP服务器代码的副本，而是默认采用无需将MCP服务器直接安装到Claude Code中，先通过CLI形式验证功能的路径。
核心查询路径:
  • 门店搜索: 
    /api/oliveyoung/stores
  • 商品搜索: 
    /api/oliveyoung/products
  • 库存查询: 
    /api/oliveyoung/inventory
  • 健康检查: 
    npx --yes daiso health

When to use

适用场景

  • "명동 근처 올리브영 매장 찾아줘"
  • "올리브영 선크림 어떤 거 있나 보여줘"
  • "명동 근처 올리브영에서 선크림 재고 확인해줘"
  • "올리브영 검색용 CLI 붙여줘"
  • "帮我找明洞附近的欧利芙洋门店"
  • "给我看看欧利芙洋有哪些防晒霜"
  • "帮我查下明洞附近欧利芙洋的防晒霜库存"
  • "给我对接欧利芙洋搜索用的CLI"

When not to use

不适用场景

  • 로그인, 주문, 장바구니, 결제 자동화
  • 올리브영 계정/세션이 필요한 private 기능
  • 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 로 본다.
  • 互联网连接
  • 推荐使用
    Node
    20（截至2026-04-05，
    hmmhmmhm/daiso-mcp
    的
    engines.node
    要求为
    >=20 <21
    ）
  • 安装了
    npx
    或
    npm
  • 按需可安装
    git
Node 22版本本地冒烟测试也可通过，但会出现
EBADENGINE
警告，因此稳定路径推荐使用Node 20 LTS。

Preferred setup: CLI first, not direct MCP install

推荐配置：优先使用CLI，而非直接安装MCP

가장 빠른 경로는 MCP 연결부터 하지 않고 upstream CLI로 공개 endpoint를 확인하는 것이다.
bash
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
반복 사용이면 전역 설치도 가능하다.
bash
npm install -g daiso
export NODE_PATH="$(npm root -g)"
daiso health
最快的验证路径是无需先对接MCP，直接通过上游CLI访问公开接口：
bash
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
如果需要频繁使用，也可以全局安装：
bash
npm install -g daiso
export NODE_PATH="$(npm root -g)"
daiso health

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

备选方案：克隆原始仓库，在本地运行相同CLI

public endpoint 재시도나 버전 고정이 필요하면 원본 저장소를 clone 해서 build 결과물 
dist/bin.js
를 
node
로 직접 실행한다. clone checkout 안에서는 
npx daiso ...
가 
Permission denied
로 실패할 수 있으므로, local fallback은 아래 경로를 기본으로 둔다.
bash
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
에는 가이드만 추가하는 것이다.
如果需要重试公开接口或者固定版本，可以克隆原始仓库，直接用
node
运行构建产物
dist/bin.js
。在克隆的项目目录内运行
npx daiso ...
可能会因为
Permission denied
报错，因此本地备选方案默认使用以下路径：
bash
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
仅补充使用指南。

Required inputs

所需输入

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

1. 缺少位置上下文时，优先索要门店/地区关键词

  • 권장 질문: 
    어느 지역/매장을 기준으로 볼까요? 예: 명동, 강남역, 성수
  • 재고 질문인데 지역이 없으면 먼저 지역/매장 키워드를 받는다.
  • 推荐提问: 
    请问你要查询哪个地区/门店？例如：明洞、江南站、圣水
  • 如果是查询库存但没有提供地区，优先索要地区/门店关键词。

2. Product keyword first when inventory is requested

2. 查询库存时，优先索要商品关键词

  • 권장 질문: 
    찾을 상품 키워드도 알려주세요. 예: 선크림, 립밤, 마스크팩
  • 상품 종류를 묻는 경우에도 키워드를 너무 넓게 받지 않는다.
  • 推荐提问: 
    请告知你要查找的商品关键词，例如：防晒霜、润唇膏、面膜
  • 即便是询问商品类别，也不要接受过于宽泛的关键词。

Workflow

使用流程

1. Check server health

1. 检查服务器健康状态

bash
npx --yes daiso health
bash
npx --yes daiso health

2. Resolve nearby stores

2. 获取附近门店列表

bash
npx --yes daiso get /api/oliveyoung/stores --keyword 명동 --limit 5 --json
매장 후보가 여러 개면 상위 2~3개만 요약하고 다시 확인받는다.
bash
npx --yes daiso get /api/oliveyoung/stores --keyword 명동 --limit 5 --json
如果门店候选较多，仅汇总前2~3个并再次和用户确认。

3. Resolve product candidates

3. 获取候选商品列表

bash
npx --yes daiso get /api/oliveyoung/products --keyword 선크림 --size 5 --json
상품 후보가 많으면 
goodsNumber
, 가격, 이미지 URL, 
inStock
여부를 함께 짧게 정리한다.
bash
npx --yes daiso get /api/oliveyoung/products --keyword 선크림 --size 5 --json
如果商品候选较多，简要整理
goodsNumber
、价格、图片URL、
inStock
状态同步展示。

4. Check inventory for the chosen area/store keyword

4. 针对选中的地区/门店关键词查询库存

bash
npx --yes daiso get /api/oliveyoung/inventory --keyword 선크림 --storeKeyword 명동 --size 5 --json
응답의 
inventory.products[].storeInventory.stores[]
안에서 다음 값을 우선 본다.
  • stockLabel
  • remainQuantity
  • stockStatus
  • storeName
bash
npx --yes daiso get /api/oliveyoung/inventory --keyword 선크림 --storeKeyword 명동 --size 5 --json
优先读取返回结果中
inventory.products[].storeInventory.stores[]
里的以下字段：
  • stockLabel
  • remainQuantity
  • stockStatus
  • storeName

5. Respond conservatively

5. 保守返回结果

최종 응답은 아래 순서로 짧게 정리한다.
  • 기준 지역/매장 키워드
  • 상위 매장 후보
  • 상품 후보 또는 선택 상품
  • 재고 있는 매장 / 품절 / 미판매 구분
  • 필요하면 
    imageUrl
    참고 링크
  • 공개 endpoint 특성상 재고는 실시간 100% 보장값이 아니므로 방문 직전 재확인을 권장
最终返回结果按以下顺序简要整理：
  • 基准地区/门店关键词
  • top门店候选
  • 商品候选或选中的商品
  • 区分有库存门店/缺货/未售卖状态
  • 按需提供
    imageUrl
    参考链接
  • 提示公开接口无法100%保证库存实时准确，建议到访前再次确认

Done when

完成标准

  • hmmhmmhm/daiso-mcp
    원본 repo와 
    daiso
    CLI 사용 경로를 명시했다.
  • MCP 서버를 직접 설치하는 대신 CLI first 흐름을 제시했다.
  • 매장 검색 → 상품 검색 → 재고 확인 순서를 따랐다.
  • /api/oliveyoung/stores
    , 
    /api/oliveyoung/products
    , 
    /api/oliveyoung/inventory
    중 필요한 호출을 실제로 안내했다.
  • 재고 결과를 매장별 
    stockLabel
    중심으로 요약했다.
  • 明确说明
    hmmhmmhm/daiso-mcp
    原始仓库和
    daiso
    CLI的使用路径
  • 给出优先使用CLI而非直接安装MCP服务器的流程
  • 遵循门店搜索→商品搜索→库存查询的顺序
  • 实际指引了
    /api/oliveyoung/stores
    、
    /api/oliveyoung/products
    、
    /api/oliveyoung/inventory
    中所需的接口调用
  • 以各门店的
    stockLabel
    为核心汇总库存结果

Failure modes

异常情况

  • public endpoint는 upstream 내부 수집 경로(Zyte 의존) 사정으로 간헐적인 5xx/503을 줄 수 있다.
  • 지역 키워드가 너무 넓으면 멀리 떨어진 동명이점 매장이 섞일 수 있다.
  • 인기 상품은 검색 결과가 많아 상위 몇 개만 먼저 확인받는 편이 안전하다.
  • 재고 수량은 시점 차이로 실제 방문 시 달라질 수 있다.
  • 受上游内部采集路径（依赖Zyte）影响，公开接口可能偶尔返回5xx/503错误
  • 如果地区关键词过于宽泛，可能会混入距离较远的同名门店
  • 热门商品搜索结果较多，建议仅先确认前几个结果更稳妥
  • 库存数量存在时间差，实际到店时可能会有变动

Notes

注意事项

  • 원본 프로젝트: 
    https://github.com/hmmhmmhm/daiso-mcp
  • npm package: 
    https://www.npmjs.com/package/daiso
  • 이 저장소는 upstream 코드를 vendoring 하지 않고 skill/docs만 유지한다.
  • 原始项目: 
    https://github.com/hmmhmmhm/daiso-mcp
  • npm包地址: 
    https://www.npmjs.com/package/daiso
  • 本仓库不引入上游代码副本，仅维护工具/文档内容