daiso-product-search
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseDaiso Product Search
Daiso商品搜索
What this skill does
功能说明
다이소몰 공식 검색/매장/재고 표면을 사용해 특정 다이소 매장의 상품 재고를 확인한다.
- 공식 매장 검색으로 매장 코드를 찾는다.
- 공식 상품 검색으로 상품 후보를 찾는다.
- 공식 매장 픽업 재고 표면으로 해당 매장의 재고를 확인한다.
- 공식 표면이 매장 내 진열 위치를 주지 않으면 재고 중심으로만 답한다.
使用大创商城官方搜索/门店/库存接口，查询特定大创门店的商品库存。
- 通过官方门店搜索获取门店代码。
- 通过官方商品搜索获取候选商品。
- 通过官方门店自提库存接口查询对应门店的库存。
- 如果官方接口未提供店内陈列位置，仅围绕库存情况进行回复。
When to use
适用场景
- "강남역2호점에 리들샷 있어?"
- "다이소 특정 매장 재고 확인해줘"
- "이 상품 어느 매장에 있는지 확인해줘"
- "다이소 매장명 주면 그 매장 재고 봐줘"
- "江南站2号店有Liddle Shot吗？"
- "帮我查下大创指定门店的库存"
- "帮我看看这款商品在哪家门店有货"
- "你只要拿到大创门店名，就能帮我查这家店的库存对吧"
When not to use
不适用场景
- 매장명도 상품명도 전혀 없는 상태에서 바로 재고를 단정해야 하는 경우
- 결제/주문/픽업 예약까지 자동화해야 하는 경우
- 비공식 크롤링 결과를 우선해야 하는 경우
- 完全没有门店名和商品名的前提下，需要直接判定库存的场景
- 需要自动完成支付/下单/自提预约的场景
- 需要优先使用非官方爬虫结果的场景
Prerequisites
前置要求
- 인터넷 연결
- 18+
node - 이 저장소의 package 또는 동일 로직
daiso-product-search
- 互联网连接
- 18+
node - 本仓库的包或相同逻辑的实现
daiso-product-search
Required inputs
必选输入
1. Ask the store name first if it is missing
1. 缺少门店名时先询问用户
매장명이 없으면 바로 조회하지 말고 먼저 물어본다.
- 권장 질문:
어느 다이소 매장을 확인할까요? 매장명(예: 강남역2호점)을 알려주세요. - 비슷한 매장이 여러 개면:
후보 매장이 여러 개예요. 정확한 매장명을 하나만 골라주세요.
没有门店名不要直接查询，先向用户确认。
- 推荐提问话术：
请问要查询哪家大创门店？请告知门店名（例如：江南站2号店）。 - 存在多家相似门店时：
匹配到多个候选门店，请选择唯一的准确门店名。
2. Ask the product name or keyword if it is missing
2. 缺少商品名或关键词时询问用户
상품명/검색어도 반드시 필요하다.
- 권장 질문:
찾을 상품명이나 검색어도 알려주세요. 예: VT 리들샷 100 - 너무 넓으면:
검색어가 너무 넓어요. 브랜드나 용량까지 같이 알려주세요.
必须提供商品名/搜索词。
- 推荐提问话术：
也请告知要查找的商品名或搜索词，例如：VT Liddle Shot 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 - store pickup stock:
https://www.daisomall.co.kr/api/pd/pdh/selStrPkupStck - optional online stock cross-check:
https://www.daisomall.co.kr/api/pdo/selOnlStck
- 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 - store pickup stock:
https://www.daisomall.co.kr/api/pd/pdh/selStrPkupStck - optional online stock cross-check:
https://www.daisomall.co.kr/api/pdo/selOnlStck
Workflow
工作流
1. Resolve the store
1. 匹配门店
공식 매장 검색 API로 매장명을 먼저 해결한다.
js
const { searchStores } = require("daiso-product-search")
const storeResult = await searchStores("강남역2호점", {
limit: 5
})
console.log(storeResult.items)매장 후보가 여러 개면 상위 2~3개만 보여주고 다시 확인받는다.
通过官方门店搜索API先匹配门店名。
js
const { searchStores } = require("daiso-product-search")
const storeResult = await searchStores("강남역2호점", {
limit: 5
})
console.log(storeResult.items)如果有多个候选门店，仅展示排名前2~3个，再次向用户确认。
2. Resolve the product
2. 匹配商品
공식 표면으로 상품 후보를 찾는다.
SearchGoodsjs
const { searchProducts } = require("daiso-product-search")
const productResult = await searchProducts("VT 리들샷 100", {
limit: 10
})
console.log(productResult.items)상품 후보가 여러 개면 아래 우선순위로 짧게 정리한다.
- 정확히 일치하는 이름
- 브랜드 + 용량/호수까지 포함된 이름
- 리뷰 수/검색 점수가 높은 후보
- 온라인 재고 교차 확인이 필요하면 후보의 를 함께 보존한다
onldPdNo
通过官方接口查找候选商品。
SearchGoodsjs
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
3. 查询门店自提库存
공식 매장 픽업 재고 API로 해당 매장의 재고를 확인한다.
js
const { getStorePickupStock } = require("daiso-product-search")
const stock = await getStorePickupStock({
pdNo: "1049275",
strCd: "10224"
})
console.log(stock)通过官方门店自提库存API查询对应门店的库存。
js
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
4. 已明确门店和商品名时，可使用端到端辅助方法
js
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)js
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
5. 谨慎回复
응답은 짧고 명확하게 정리한다.
- 매장명
- 상품명
- 매장 재고 수량 또는 재고 없음
- 필요하면 온라인 재고 참고값
- 공식 표면이 매장 내 진열 위치를 주지 않으면 고 분명히 말한다.
공식 표면에서는 매장 재고까지만 확인된다
回复要简洁明确，包含以下内容：
- 门店名
- 商品名
- 门店库存数量或无库存
- 必要时附上线上库存参考值
- 如果官方接口未提供店内陈列位置，需明确说明
官方接口仅可查询到门店库存信息
Done when
完成条件
- 매장명과 상품명이 모두 확인되었다.
- 공식 표면으로 매장 후보와 상품 후보를 찾았다.
- 공식 매장 재고 결과를 최소 1회 반환했다.
- 위치 정보가 없으면 없다고 분명히 고지했다.
- 已确认门店名和商品名
- 已通过官方接口匹配到候选门店和候选商品
- 已至少返回1次官方门店库存查询结果
- 若无位置信息，已明确告知用户
Failure modes
失败场景
- 매장명이 너무 넓으면 같은 상권의 여러 지점이 동시에 잡힐 수 있다.
- 상품명이 너무 넓으면 다른 용량/호수 후보가 많이 섞일 수 있다.
- 공식 재고는 시점 차이로 실제 방문 시 수량이 달라질 수 있다.
- 현재 확인된 공식 표면은 매장 내 aisle/진열 위치를 직접 주지 않을 수 있다.
- 门店名过于宽泛，可能会同时匹配到同一商圈的多家门店
- 商品名过于宽泛，可能会混入大量其他容量/型号的候选商品
- 官方库存存在时间差，实际到店时数量可能有变动
- 目前可调用的官方接口可能不会直接提供店内货架/陈列位置
Notes
注意事项
- 조회형 스킬이다.
- 공식 표면 우선 원칙을 유지한다.
- 공식 표면이 위치를 주지 않으면 억지 추정을 하지 않는다.
- 本工具为查询类工具。
- 遵循官方接口优先原则。
- 若官方接口未提供位置信息，不要随意猜测。