daiso-product-search

SKILL.md

Daiso Product Search

What this skill does

다이소몰 공식 검색/매장/재고 표면을 사용해 특정 다이소 매장의 상품 재고를 확인한다.

공식 매장 검색으로 매장 코드를 찾는다.

공식 상품 검색으로 상품 후보를 찾는다.

공식 매장 픽업 재고 표면으로 해당 매장의 재고를 확인한다.

공식 표면이 매장 내 진열 위치를 주지 않으면 재고 중심으로만 답한다.

When to use

"강남역2호점에 리들샷 있어?"

"다이소 특정 매장 재고 확인해줘"

"이 상품 어느 매장에 있는지 확인해줘"

"다이소 매장명 주면 그 매장 재고 봐줘"

When not to use

매장명도 상품명도 전혀 없는 상태에서 바로 재고를 단정해야 하는 경우

결제/주문/픽업 예약까지 자동화해야 하는 경우

비공식 크롤링 결과를 우선해야 하는 경우

Prerequisites

인터넷 연결

node 18+

이 저장소의 daiso-product-search package 또는 동일 로직

Required inputs

1. Ask the store name first if it is missing

매장명이 없으면 바로 조회하지 말고 먼저 물어본다.

권장 질문: 어느 다이소 매장을 확인할까요? 매장명(예: 강남역2호점)을 알려주세요.

비슷한 매장이 여러 개면: 후보 매장이 여러 개예요. 정확한 매장명을 하나만 골라주세요.

2. Ask the product name or keyword if it is missing

상품명/검색어도 반드시 필요하다.

권장 질문: 찾을 상품명이나 검색어도 알려주세요. 예: VT 리들샷 100

너무 넓으면: 검색어가 너무 넓어요. 브랜드나 용량까지 같이 알려주세요.

Official Daiso Mall surfaces

store keyword catalog: https://www.daisomall.co.kr/api/ms/msg/selStrSrchKeyword

store search: https://www.daisomall.co.kr/api/ms/msg/selStr

store detail: https://www.daisomall.co.kr/api/dl/dla-api/selStrInfo

product search summary: https://www.daisomall.co.kr/ssn/search/Search

product search list: https://www.daisomall.co.kr/ssn/search/SearchGoods

product summary list: https://www.daisomall.co.kr/ssn/search/GoodsMummResult

auth (비로그인 JWT 발급): https://www.daisomall.co.kr/api/auth/request

store pickup stock: https://www.daisomall.co.kr/api/pd/pdh/selStrPkupStck  ← 인증 필요

pickup eligibility fallback: https://www.daisomall.co.kr/api/ms/msg/selPkupStr

optional online stock cross-check: https://www.daisomall.co.kr/api/pdo/selOnlStck

Workflow

1. Resolve the store

공식 매장 검색 API로 매장명을 먼저 해결한다.

const { searchStores } = require("daiso-product-search")

const storeResult = await searchStores("강남역2호점", {
  limit: 5
})

console.log(storeResult.items)

매장 후보가 여러 개면 상위 2~3개만 보여주고 다시 확인받는다.

2. Resolve the product

공식 SearchGoods 표면으로 상품 후보를 찾는다.

const { searchProducts } = require("daiso-product-search")

const productResult = await searchProducts("VT 리들샷 100", {
  limit: 10
})

console.log(productResult.items)

상품 후보가 여러 개면 아래 우선순위로 짧게 정리한다.

정확히 일치하는 이름

브랜드 + 용량/호수까지 포함된 이름

리뷰 수/검색 점수가 높은 후보

온라인 재고 교차 확인이 필요하면 후보의 onldPdNo 를 함께 보존한다

3. Check the store pickup stock

selStrPkupStck는 Authorization 헤더 없이 호출하면 403을 반환한다.
로그인 없이 /api/auth/request로 비로그인 JWT를 발급받아 AES-CBC로 암호화한 뒤 Bearer 헤더로 전달한다.

Bearer 토큰 생성 방법:

GET /api/auth/request → 응답 바디: JWT 평문, 응답 헤더 x-dm-uid 보존 (유효 30초)

랜덤 16바이트 IV 생성 후 JWT를 AES-128-CBC / PKCS7 / 키 "PRE_AUTH_ENC_KEY"로 암호화

bearer = base64(IV) + base64(암호문) 으로 조합 후 Authorization: Bearer <bearer>, X-DM-UID: <uid> 헤더로 전달

바디는 {pdNo, strCd} 쌍 배열로 여러 매장을 한 번에 조회할 수 있다.
응답의 stck 필드가 "0" 또는 빈 값이면 재고 없음.

const { getStorePickupStock } = require("daiso-product-search")

const stock = await getStorePickupStock({
  pdNo: "1049275",
  strCd: "10224"
})

console.log(stock)

4. Use the end-to-end helper when both names are already known

const { lookupStoreProductAvailability } = require("daiso-product-search")

const result = await lookupStoreProductAvailability({
  storeQuery: "강남역2호점",
  productQuery: "VT 리들샷 100"
})

console.log(result.selectedStore)
console.log(result.selectedProduct)
console.log(result.pickupStock)

5. Respond conservatively

응답은 짧고 명확하게 정리한다.

매장명

상품명

매장 재고 수량 또는 재고 없음

필요하면 온라인 재고 참고값

공식 표면이 매장 내 진열 위치를 주지 않으면 공식 표면에서는 매장 재고까지만 확인된다고 분명히 말한다.

Done when

매장명과 상품명이 모두 확인되었다.

공식 표면으로 매장 후보와 상품 후보를 찾았다.

공식 매장 재고 결과를 최소 1회 반환했다.

위치 정보가 없으면 없다고 분명히 고지했다.

Failure modes

매장명이 너무 넓으면 같은 상권의 여러 지점이 동시에 잡힐 수 있다.

상품명이 너무 넓으면 다른 용량/호수 후보가 많이 섞일 수 있다.

공식 재고는 시점 차이로 실제 방문 시 수량이 달라질 수 있다.

현재 확인된 공식 표면은 매장 내 aisle/진열 위치를 직접 주지 않을 수 있다.

selStrPkupStck 403 → /api/auth/request 재호출 후 Bearer를 새로 빌드해 재시도한다.

Bearer 재시도 후에도 401/403이면 재고 수량은 retrievalStatus: "blocked" 로 표시하고, selPkupStr 기반 pickupEligibility(픽업 가능 여부)만 보조 정보로 제공한다.

Notes

조회형 스킬이다.

공식 표면 우선 원칙을 유지한다.

공식 표면이 위치를 주지 않으면 억지 추정을 하지 않는다.

인증 키(PRE_AUTH_ENC_KEY)는 JS 번들에 하드코딩되어 있으며 변경될 수 있다.

selStrPkupStck 호출 시: /api/auth/request 호출 후 Bearer를 만들어 시도한다.

fallback order: Bearer 재고 조회 → 401/403 시 토큰 재발급 후 1회 재시도 → 구조화된 blocked 재고 → 선택적 selPkupStr 픽업 가능 여부.