8000 daiso-mcp/openapi.json at v1.2.4 · hmmhmmhm/daiso-mcp · GitHub
[go: up one dir, main page]
Skip to content

openapi.json

Latest commit

 

History

History
3340 lines (3340 loc) · 88.9 KB

openapi.json

File metadata and controls

3340 lines (3340 loc) · 88.9 KB
Raw
"required": false,
"description": "문제가 발생했거나 개선이 필요한 MCP 도구 이름",
"schema": {
"type": "string"
}
},
{
"name": "reproduction",
"in": "query",
"required": false,
"description": "오류 재현 방법",
"schema": {
"type": "string"
}
},
{
"name": "expected",
"in": "query",
"required": false,
"description": "기대 결과",
"schema": {
"type": "string"
}
},
{
"name": "actual",
"in": "query",
"required": false,
"description": "실제 결과",
"schema": {
"type": "string"
}
},
{
"name": "source",
"in": "query",
"required": false,
"description": "요청 출처(mcp, chatgpt, claude, cli, api, other)",
"schema": {
"type": "string"
}
},
{
"name": "sido",
"in": "query",
"required": false,
"description": "다이소 시/도",
"schema": {
"type": "string"
}
},
{
"name": "gugun",
"in": "query",
"required": false,
"description": "다이소 구/군",
"schema": {
"type": "string"
}
},
{
"name": "dong",
"in": "query",
"required": false,
"description": "다이소 동",
"schema": {
"type": "string"
}
},
{
"name": "area",
"in": "query",
"required": false,
"description": "롯데마트 지역",
"schema": {
"type": "string"
}
},
{
"name": "area1",
"in": "query",
"required": false,
"description": "이마트24 1차 지역",
"schema": {
"type": "string"
}
},
{
"name": "area2",
"in": "query",
"required": false,
"description": "이마트24 2차 지역",
"schema": {
"type": "string"
}
},
{
"name": "areaCode",
"in": "query",
"required": false,
"description": "메가박스 지역 코드",
"schema": {
"type": "string"
}
},
{
"name": "brandVariant",
"in": "query",
"required": false,
"description": "롯데마트 브랜드 변형",
"schema": {
"type": "string"
}
},
{
"name": "lat",
"in": "query",
"required": false,
"description": "위도",
"schema": {
"type": "number",
"format": "float"
}
},
{
"name": "lng",
"in": "query",
"required": false,
"description": "경도",
"schema": {
"type": "number",
"format": "float"
}
},
{
"name": "page",
"in": "query",
"required": false,
"description": "페이지 번호",
"schema": {
"type": "integer"
}
},
{
"name": "pageIdx",
"in": "query",
"required": false,
"description": "올리브영 페이지 번호",
"schema": {
"type": "integer"
}
},
{
"name": "pageLimit",
"in": "query",
"required": false,
"description": "롯데마트 추가 페이지 수",
"schema": {
"type": "integer"
}
},
{
"name": "pageSize",
"in": "query",
"required": false,
"description": "페이지 크기",
"schema": {
"type": "integer"
}
},
{
"name": "size",
"in": "query",
"required": false,
"description": "페이지 크기 또는 검색 크기",
"schema": {
"type": "integer"
}
},
{
"name": "offset",
"in": "query",
"required": false,
"description": "CU 검색 오프셋",
"schema": {
"type": "integer"
}
},
{
"name": "limit",
"in": "query",
"required": false,
"description": "최대 결과 수",
"schema": {
"type": "integer"
}
},
{
"name": "storeLimit",
"in": "query",
"required": false,
"description": "매장 결과 제한 수",
"schema": {
"type": "integer"
}
},
{
"name": "storeCode",
"in": "query",
"required": false,
"description": "매장 코드. 다이소 진열 위치는 /api/daiso/inventory 응답의 storeInventory.stores[].storeCode에서 확인하세요.",
"schema": {
"type": "string"
}
},
{
"name": "storeName",
"in": "query",
"required": false,
"description": "매장명. 롯데마트 상품 조회에서 storeCode가 없을 때 사용하며, 모르면 먼저 lottemartFindNearbyStores 또는 /api/lottemart/stores로 확인하세요.",
"schema": {
"type": "string"
}
},
{
"name": "storeKeyword",
"in": "query",
"required": false,
"description": "매장 키워드",
"schema": {
"type": "string"
}
},
{
"name": "playDate",
"in": "query",
"required": false,
"description": "상영일(YYYYMMDD)",
"schema": {
"type": "string"
}
},
{
"name": "regionCode",
"in": "query",
"required": false,
"description": "CGV 지역 코드",
"schema": {
"type": "string"
}
},
{
"name": "theaterCode",
"in": "query",
"required": false,
"description": "CGV 극장 코드",
"schema": {
"type": "string"
}
},
{
"name": "theaterId",
"in": "query",
"required": false,
"description": "메가박스/롯데시네마 지점 ID",
"schema": {
"type": "string"
}
},
{
"name": "movieCode",
"in": "query",
"required": false,
"description": "CGV 영화 코드",
"schema": {
"type": "string"
}
},
{
"name": "movieId",
"in": "query",
"required": false,
"description": "메가박스/롯데시네마 영화 ID",
"schema": {
"type": "string"
}
},
{
"name": "pluCd",
"in": "query",
"required": false,
"description": "이마트24 상품 PLU 코드",
"schema": {
"type": "string"
}
},
{
"name": "bizNoArr",
"in": "query",
"required": false,
"description": "이마트24 사업자번호 목록",
"schema": {
"type": "string"
}
},
{
"name": "label",
"in": "query",
"required": false,
"description": "세븐일레븐 인기 검색어 라벨",
"schema": {
"type": "string"
}
},
{
"name": "sort",
"in": "query",
"required": false,
"description": "정렬 기준",
"schema": {
"type": "string"
}
},
{
"name": "searchSort",
"in": "query",
"required": false,
"description": "CU 검색 정렬 기준",
"schema": {
"type": "string"
}
},
{
"name": "service24h",
"in": "query",
"required": false,
"description": "이마트24 24시간 필터",
"schema": {
"type": "boolean"
}
},
{
"name": "includeSoldOut",
"in": "query",
"required": false,
"description": "올리브영 품절 포함 여부",
"schema": {
"type": "boolean"
}
},
{
"name": "includeIssues",
"in": "query",
"required": false,
"description": "세븐일레븐 이달의 행사지 포함 여부",
"schema": {
"type": "boolean"
}
},
{
"name": "includeExhibition",
"in": "query",
"required": false,
"description": "세븐일레븐 전시상품 포함 여부",
"schema": {
"type": "boolean"
}
},
{
"name": "timeoutMs",
"in": "query",
"required": false,
"description": "원본 요청 타임아웃(ms), 디트릭스는 1~60000",
"schema": {
"type": "integer"
}
}
],
"responses": {
"200": {
"description": "프록시 호출 성공",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ActionQueryResponse"
}
}
}
},
"400": {
"description": "잘못된 요청",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
}
}
}
}
},
"components": {
"schemas": {
"Product": {
"type": "object",
"description": "제품 정보",
"properties": {
"id": {
"type": "string",
"description": "제품 ID",
"example": "1234567890"
},
"name": {
"type": "string",
"description": "제품명",
"example": "PP 수납박스 대형"
},
"price": {
"type": "integer",
"description": "가격 (원)",
"example": 5000
},
"imageUrl": {
"type": "string",
"description": "제품 이미지 URL",
"example": "https://cdn.daisomall.co.kr/..."
},
"soldOut": {
"type": "boolean",
"description": "품절 여부",
"example": false
},
"isNew": {
"type": "boolean",
"description": "신상품 여부",
"example": false
},
"pickupAvailable": {
"type": "boolean",
"description": "매장 픽업 가능 여부",
"example": true
}
}
},
"ProductDetail": {
"type": "object",
"description": "제품 상세 정보",
"properties": {
"id": {
"type": "string",
"description": "제품 ID"
},
"name": {
"type": "string",
"description": "제품명"
},
"price": {
"type": "integer",
"description": "가격 (원)"
},
"currency": {
"type": "string",
"description": "통화",
"example": "KRW"
},
"imageUrl": {
"type": "string",
"description": "제품 이미지 URL"
},
"brand": {
"type": "string",
"description": "브랜드명"
},
"soldOut": {
"type": "boolean",
"description": "품절 여부"
},
"isNew": {
"type": "boolean",
"description": "신상품 여부"
}
}
},
"InventoryProduct": {
"type": "object",
"description": "재고 응답에 포함되는 상품 요약 정보",
"properties": {
"id": {
"type": "string",
"description": "제품 ID"
},
"name": {
"type": "string",
"description": "제품명"
},
"imageUrl": {
"type": "string",
"description": "제품 이미지 URL"
},
"brand": {
"type": "string",
"description": "브랜드명"
},
"soldOut": {
"type": "boolean",
"description": "품절 여부"
},
"isNew": {
"type": "boolean",
"description": "신상품 여부"
}
}
},
"Store": {
"type": "object",
"description": "매장 정보",
"properties": {
"name": {
"type": "string",
"description": "매장명",
"example": "다이소 강남역점"
},
"phone": {
"type": "string",
"description": "전화번호",
"example": "02-1234-5678"
},
"address": {
"type": "string",
"description": "주소",
"example": "서울특별시 강남구 강남대로 123"
},
"lat": {
"type": "number",
"format": "float",
"description": "위도",
"example": 37.4979
},
"lng": {
"type": "number",
"format": "float",
"description": "경도",
"example": 127.0276
},
"openTime": {
"type": "string",
"description": "영업 시작 시간",
"example": "10:00"
},
"closeTime": {
"type": "string",
"description": "영업 종료 시간",
"example": "22:00"
},
"options": {
"type": "object",
"description": "매장 옵션",
"properties": {
"parking": {
"type": "boolean",
"description": "주차 가능 여부"
},
"pickup": {
"type": "boolean",
"description": "픽업 가능 여부"
},
"taxFree": {
"type": "boolean",
"description": "면세 가능 여부"
}
}
}
}
},
"StoreInventory": {
"type": "object",
"description": "매장 재고 정보",
"properties": {
"storeCode": {
"type": "string",
"description": "매장 코드",
"example": "ST001"
},
"storeName": {
"type": "string",
"description": "매장명",
"example": "다이소 강남역점"
},
"address": {
"type": "string",
"description": "주소"
},
"distance": {
"type": "string",
"description": "거리",
"example": "0.5km"
},
"quantity": {
"type": "integer",
"description": "재고 수량",
"example": 12
},
"options": {
"type": "object",
"properties": {
"parking": {
"type": "boolean"
},
"pickup": {
"type": "boolean"
}
}
}
}
},
"ProductSearchResponse": {
"type": "object",
"properties": {
"success": {
"type": "boolean",
"example": true
},
"data": {
"type": "object",
"properties": {
"products": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Product"
}
}
}
},
"meta": {
"type": "object",
"properties": {
"total": {
"type": "integer",
"description": "전체 결과 수"
},
"page": {
"type": "integer",
"description": "현재 페이지"
},
"pageSize": {
"type": "integer",
"description": "페이지당 결과 수"
}
}
}
}
},
"ProductDetailResponse": {
"type": "object",
"properties": {
"success": {
"type": "boolean",
"example": true
},
"data": {
"$ref": "#/components/schemas/ProductDetail"
}
}
},
"StoreSearchResponse": {
"type": "object",
"properties": {
"success": {
"type": "boolean",
"example": true
},
"data": {
"type": "object",
"properties": {
"stores": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Store"
}
}
}
},
"meta": {
"type": "object",
"properties": {
"total": {
"type": "integer",
"description": "전체 결과 수"
}
}
}
}
},
"InventoryResponse": {
"type": "object",
"properties": {
"success": {
"type": "boolean",
"example": true
},
"data": {
"type": "object",
"properties": {
"productId": {
"type": "string",
"description": "제품 ID"
},
"product": {
"$ref": "#/components/schemas/InventoryProduct"
},
"location": {
"type": "object",
"properties": {
"latitude": {
"type": "number",
"format": "float"
},
"longitude": {
"type": "number",
"format": "float"
}
}
},
"onlineStock": {
"type": "integer",
"description": "온라인 재고 수량",
"example": 150
},
"storeInventory": {
"type": "object",
"properties": {
"totalStores": {
"type": "integer",
"description": "전체 매장 수"
},
"inStockCount": {
"type": "integer",
"description": "재고 있는 매장 수"
},
"stores": {
"type": "array",
"items": {
"$ref": "#/components/schemas/StoreInventory"
}
}
}
}
}
},
"meta": {
"type": "object",
"properties": {
"total": {
"type": "integer"
},
"page": {
"type": "integer"
},
"pageSize": {
"type": "integer"
}
}
}
}
},
"OliveyoungStore": {
"type": "object",
"description": "올리브영 매장 정보",
"properties": {
View remainder of file in raw view
0