다이소 파인더

다이소 파인더 개발자 포털

Daiso Finder 는 API 키도, 가입도, 승인 절차도 없는 무료 공개 API 입니다. 아래 예제를 그대로 복사해 실행하면 바로 첫 응답을 받을 수 있습니다.

1분 퀵스타트

매장을 먼저 찾아 code 를 얻고, 그 코드를 branchCode 로 넘겨 매장 안 상품 재고를 조회하는 순서입니다.

# 1. 매장 검색
curl "https://daiso-finder.kr/api/branches/search?keyword=강남"

# 2. 매장 코드로 상품 재고 검색
curl "https://daiso-finder.kr/api/products?branchCode=11199&keyword=수세미"

# 3. 상품 단건의 재고와 진열 위치
curl "https://daiso-finder.kr/api/products/1019373?branchCode=11199"

인증과 요금

  • 인증 없음 — API 키, 토큰, OAuth 모두 필요 없습니다. 익명으로 바로 호출하세요.
  • 무료 — 요금제와 유료 등급이 없습니다. 영업 문의 폼도 없습니다.
  • 셀프 서비스 — 발급받을 자격 증명이 없으므로 별도 온보딩 절차 없이 첫 요청이 곧 시작입니다.
  • 사용량 — 고정 한도는 없지만 요청이 외부 다이소 서비스로 전달되므로 초당 수 건 수준으로 여유 있게 호출하고, 자주 바뀌지 않는 매장 정보는 캐시해 주세요.
  • CORS — 발견 문서와 샌드박스 응답은 Access-Control-Allow-Origin: * 로 내려갑니다.

샌드박스

/api/sandbox 이하는 외부 다이소 API 를 호출하지 않고 고정된 예시 데이터를 돌려줍니다. 응답 형태는 실제 엔드포인트와 같아서 통합 테스트의 기대값으로 그대로 쓸 수 있습니다. 매장 코드 11199, 10528, 10962 가 준비돼 있습니다.

curl "https://daiso-finder.kr/api/sandbox/branches/search?keyword=강남"
curl "https://daiso-finder.kr/api/sandbox/products?branchCode=11199&keyword=수세미"

엔드포인트

  • GET /api/branches/search — 키워드 또는 좌표로 매장 검색 (operationId: searchStores)
  • GET /api/branches/{code} — 매장 코드로 단건 조회 (operationId: getStore)
  • GET /api/products — 매장 내 재고 있는 상품 검색 (NDJSON 스트리밍 지원) (operationId: searchStoreProducts)
  • GET /api/products/{id} — 상품 단건의 재고·진열 위치와 주변 매장 재고 (operationId: getProductAvailability)
  • GET /api — 전체 엔드포인트와 발견 문서 목록 (operationId: getApiIndex)
  • POST /api/mcp — MCP Streamable HTTP JSON-RPC 엔드포인트 (operationId: callMcp)

전체 파라미터와 응답 스키마는 /openapi.json (또는 /openapi.yaml) 에 OpenAPI 3.1 로 기술돼 있으며, 모든 오퍼레이션에 고유한 operationId 와 설명이 있어 LLM 함수 호출 스키마로 바로 변환할 수 있습니다.

오류 응답

모든 오류는 HTML 이 아니라 아래 형태의 JSON 으로 내려갑니다. code 는 기계 판독용 안정 식별자이고 hint 는 무엇을 고치면 되는지 알려줍니다.

{
  "error": "매장 정보가 필요합니다.",
  "code": "missing_parameter",
  "message": "The `branchCode` query parameter is required.",
  "hint": "Call GET /api/branches/search first and pass the `code` field ...",
  "status": 400,
  "documentation": "https://daiso-finder.kr/developers"
}

code 값은 missing_parameter, invalid_parameter, not_found, route_not_found, method_not_allowed, upstream_error, internal_error 중 하나입니다.

MCP 서버

https://daiso-finder.kr/api/mcp 는 Streamable HTTP 전송을 쓰는 MCP 서버입니다. Claude, ChatGPT 등 MCP 를 지원하는 클라이언트에 원격 서버로 등록하면 아래 도구를 그대로 호출할 수 있습니다.

  • search_stores — Search Daiso stores by address or store name. Use a returned code as branchCode for product tools.
  • search_nearby_stores — Search nearby Daiso stores by latitude and longitude. Use a returned code as branchCode.
  • get_store — Get Daiso store details for a branchCode, including address, coordinates, and opening hours.
  • search_products — Search product stock, price, floor, and zone inside a Daiso store. Requires branchCode.
  • get_product_availability — Get one product's stock count and shelf placement in a Daiso store, plus nearby stores that also stock it.
curl -X POST "https://daiso-finder.kr/api/mcp" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

CLI

터미널이나 스크립트에서 바로 쓰려면 공식 CLI 를 설치하지 않고 실행할 수 있습니다. API 키가 없으므로 설정 단계도 없습니다.

npx daiso-finder-cli stores 강남
npx daiso-finder-cli store 11199
npx daiso-finder-cli products 11199 수세미 --json
npx daiso-finder-cli product 1019373 11199

소스는 저장소의 cli/ 디렉터리에 있고, --base-url 옵션으로 샌드박스나 자체 배포본을 가리킬 수 있습니다.

에이전트용 발견 문서

HTML 페이지는 Accept: text/markdown 으로 요청하면 같은 URL 에서 Markdown 표현을 돌려줍니다.

지원

연동 문의와 버그 제보는 contact@daiso-finder.kr 또는 GitHub 이슈로 보내주세요.