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
```
本仓库不引入上游代码副本，仅维护工具/文档内容