daiso 1.0.5 → 1.0.7

package/dist/pages/openapiSpecActions.js

@@ -14,48 +14,314 @@ const ACTION_QUERY_PARAMETERS = [
             enum: ACTION_QUERY_ACTIONS,
         },
     },
-    { name: 'q', in: 'query', required: false, description: '다이소 제품 검색어', schema: { type: 'string' } },
-    { name: 'query', in: 'query', required: false, description: '세븐일레븐 상품 검색어', schema: { type: 'string' } },
-    { name: 'itemCode', in: 'query', required: false, description: 'GS25 상품 코드', schema: { type: 'string' } },
-    { name: 'productId', in: 'query', required: false, description: '제품 ID 또는 상세 조회용 path 파라미터', schema: { type: 'string' } },
-    { name: 'keyword', in: 'query', required: false, description: '공통 키워드 파라미터', 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: '매장 코드', schema: { type: 'string' } },
-    { name: 'storeName', in: 'query', required: false, description: '매장명', 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: '세븐일레븐 inventory 타임아웃', schema: { type: 'integer' } },
+    {
+        name: 'q',
+        in: 'query',
+        required: false,
+        description: '다이소 제품 검색어',
+        schema: { type: 'string' },
+    },
+    {
+        name: 'query',
+        in: 'query',
+        required: false,
+        description: '세븐일레븐 상품 검색어',
+        schema: { type: 'string' },
+    },
+    {
+        name: 'itemCode',
+        in: 'query',
+        required: false,
+        description: 'GS25 상품 코드',
+        schema: { type: 'string' },
+    },
+    {
+        name: 'productId',
+        in: 'query',
+        required: false,
+        description: '제품 ID 또는 상세 조회용 path 파라미터. 상품명만 알면 먼저 daisoSearchProducts 또는 /api/daiso/products로 productId를 확인하세요.',
+        schema: { type: 'string' },
+    },
+    {
+        name: 'keyword',
+        in: 'query',
+        required: false,
+        description: '공통 키워드 파라미터',
+        schema: { type: 'string' },
+    },
+    {
+        name: 'location',
+        in: 'query',
+        required: false,
+        description: '주변 장소 검색 지역/역/주소 키워드',
+        schema: { type: 'string' },
+    },
+    {
+        name: 'category',
+        in: 'query',
+        required: false,
+        description: '주변 장소 카테고리(restaurant, cafe, food, dessert, all)',
+        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: '세븐일레븐 inventory 타임아웃',
+        schema: { type: 'integer' },
+    },
 ];
 export function generateOpenApiSpec(baseUrl) {
     return {

package/dist/pages/openapiSpecPathsCu.js

@@ -114,6 +114,13 @@ export const OPENAPI_PATHS_CU = {
                     description: '재고 정렬 방식',
                     schema: { type: 'string', default: 'recom' },
                 },
+                {
+                    name: 'storeCheck',
+                    in: 'query',
+                    required: false,
+                    description: 'false이면 주변 매장 조회를 생략하고 재고 상품 검색만 수행',
+                    schema: { type: 'boolean', default: true },
+                },
             ],
             responses: {
                 '200': {

package/dist/pages/openapiSpecPathsLotteMart.js

@@ -111,6 +111,20 @@ export const OPENAPI_PATHS_LOTTEMART = {
                     description: '추가 조회할 최대 페이지 수',
                     schema: { type: 'integer', default: 3, minimum: 1, maximum: 20 },
                 },
+                {
+                    name: 'source',
+                    in: 'query',
+                    required: false,
+                    description: '상품 검색 경로',
+                    schema: { type: 'string', enum: ['auto', 'legacy', 'zetta'], default: 'auto' },
+                },
+                {
+                    name: 'timeoutMs',
+                    in: 'query',
+                    required: false,
+                    description: '요청 제한 시간(ms)',
+                    schema: { type: 'integer', default: 45000, minimum: 1 },
+                },
             ],
             responses: {
                 '200': {

package/dist/pages/openapiSpecPathsOliveyoung.js

@@ -44,6 +44,13 @@ export const OPENAPI_PATHS_OLIVEYOUNG = {
                     description: '품절 포함 여부 (true/false)',
                     schema: { type: 'boolean', default: false },
                 },
+                {
+                    name: 'timeoutMs',
+                    in: 'query',
+                    required: false,
+                    description: '요청 제한 시간(ms)',
+                    schema: { type: 'integer', default: 15000, minimum: 1 },
+                },
             ],
             responses: {
                 '200': {
@@ -115,6 +122,13 @@ export const OPENAPI_PATHS_OLIVEYOUNG = {
                     description: '최대 결과 수',
                     schema: { type: 'integer', default: 20, minimum: 1, maximum: 100 },
                 },
+                {
+                    name: 'timeoutMs',
+                    in: 'query',
+                    required: false,
+                    description: '요청 제한 시간(ms)',
+                    schema: { type: 'integer', default: 15000, minimum: 1 },
+                },
             ],
             responses: {
                 '200': {
@@ -199,6 +213,27 @@ export const OPENAPI_PATHS_OLIVEYOUNG = {
                     description: '품절 포함 여부 (true/false)',
                     schema: { type: 'boolean', default: false },
                 },
+                {
+                    name: 'storeLimit',
+                    in: 'query',
+                    required: false,
+                    description: '반환할 주변 매장 최대 수',
+                    schema: { type: 'integer', default: 10, minimum: 1, maximum: 100 },
+                },
+                {
+                    name: 'stockCheckLimit',
+                    in: 'query',
+                    required: false,
+                    description: '주변 매장별 재고를 보강할 상품 수. 낮출수록 빠르게 응답합니다.',
+                    schema: { type: 'integer', default: 5, minimum: 0, maximum: 20 },
+                },
+                {
+                    name: 'timeoutMs',
+                    in: 'query',
+                    required: false,
+                    description: '요청 제한 시간(ms)',
+                    schema: { type: 'integer', default: 15000, minimum: 1 },
+                },
             ],
             responses: {
                 '200': {

package/dist/pages/openapiSpecPathsPlaces.js

@@ -0,0 +1,85 @@
+/**
+ * OpenAPI 경로 정의 (장소 검색)
+ */
+export const OPENAPI_PATHS_PLACES = {
+    '/api/places/search': {
+        get: {
+            operationId: 'placesSearchNearby',
+            summary: '음식점/카페 등 주변 장소 검색',
+            description: '네이버 지역 검색으로 특정 지역의 음식점, 카페, 디저트 가게 등 주변 장소를 조회합니다. 좌표 반경 검색이 아니라 키워드 기반 검색입니다.',
+            parameters: [
+                {
+                    name: 'location',
+                    in: 'query',
+                    required: false,
+                    description: '지역/역/주소 키워드 (예: 강남역, 성수동)',
+                    schema: { type: 'string' },
+                },
+                {
+                    name: 'keyword',
+                    in: 'query',
+                    required: false,
+                    description: '직접 검색어 (예: 라멘, 브런치, 조용한 카페)',
+                    schema: { type: 'string' },
+                },
+                {
+                    name: 'category',
+                    in: 'query',
+                    required: false,
+                    description: '장소 카테고리',
+                    schema: {
+                        type: 'string',
+                        enum: ['restaurant', 'cafe', 'food', 'dessert', 'all'],
+                        default: 'all',
+                    },
+                },
+                {
+                    name: 'limit',
+                    in: 'query',
+                    required: false,
+                    description: '최대 결과 수',
+                    schema: { type: 'integer', default: 5, minimum: 1, maximum: 5 },
+                },
+                {
+                    name: 'sort',
+                    in: 'query',
+                    required: false,
+                    description: '정렬 방식',
+                    schema: { type: 'string', enum: ['random', 'comment'], default: 'random' },
+                },
+            ],
+            responses: {
+                '200': {
+                    description: '검색 성공',
+                    content: {
+                        'application/json': {
+                            schema: {
+                                type: 'object',
+                                properties: {
+                                    success: { type: 'boolean' },
+                                    data: {
+                                        type: 'object',
+                                        properties: {
+                                            provider: { type: 'string', example: 'naverLocal' },
+                                            searchMode: { type: 'string', example: 'keyword' },
+                                            query: { type: 'string', example: '강남역 카페' },
+                                            places: { type: 'array', items: { type: 'object' } },
+                                        },
+                                    },
+                                },
+                            },
+                        },
+                    },
+                },
+                '400': {
+                    description: '잘못된 요청 (위치/검색어 누락)',
+                    content: {
+                        'application/json': {
+                            schema: { $ref: '#/components/schemas/ErrorResponse' },
+                        },
+                    },
+                },
+            },
+        },
+    },
+};

package/dist/pages/promptReferenceText.js

@@ -57,6 +57,7 @@ export function buildPromptReferenceText(baseUrl) {
 | LOTTEMART_STORE_SEARCH_FAILED | 롯데마트 매장 조회 실패 |
 | LOTTEMART_PRODUCT_SEARCH_FAILED | 롯데마트 상품 조회 실패 |
 | SEVENELEVEN_INVENTORY_CHECK_FAILED | 세븐일레븐 재고 조회 실패 |
+| PLACES_SEARCH_FAILED | 주변 장소 검색 실패 |
 
 ---
 
@@ -81,16 +82,23 @@ export function buildPromptReferenceText(baseUrl) {
    - 결과에서 원하는 제품의 id 확인
    - /api/daiso/inventory에 해당 id로 재고 조회
    - 진열 위치가 필요하면 재고 응답의 storeCode를 확인한 뒤 /api/daiso/display-location에 productId + storeCode로 조회
-6. **상품명 단계 검색**:
+   - 다이소 재고 조회는 storeCode가 필요하지 않습니다.
+6. **최소 정보 요청 처리**:
+   - 사용자가 상품명만 주면 먼저 상품 검색 도구로 후보를 찾고, 응답의 productId/itemCode/pluCd를 다음 단계에 전달합니다.
+   - 사용자가 위치를 대강 말하면 keyword/storeKeyword에 그대로 넣어 먼저 조회하고, 결과가 없을 때만 공백 제거, 역/점 접미어 제거 같은 변형을 시도합니다.
+   - 도구가 productId, itemCode, storeCode 같은 내부 ID를 요구하면 사용자에게 바로 ID를 요구하지 말고, 검색/재고 응답에서 먼저 확인합니다.
+   - "근처", "주변"처럼 위치가 없는 표현만 있으면 기본 좌표 결과를 단정하지 말고 사용자의 지역/역명/좌표를 물어봅니다.
+7. **상품명 단계 검색**:
    - 재고 검색은 어떤 서비스이든 검색어 전체를 먼저 그대로 조회하고, 실패할 때만 공백/브랜드어 제거, 표기 변형, 더 짧은 핵심어 순으로 단계적으로 넓혀서 다시 시도합니다.
    - 너무 넓은 축약어로만 매칭된 경우에는 확정 상품처럼 단정하지 말고, 추정 매칭임을 짧게 밝힌 뒤 재고를 안내합니다.
    - 위치/브랜드/상품명은 한 인자에 섞지 말고 가능한 한 분리해서 도구에 전달합니다.
-7. **위치 기반 재고**: lat, lng 파라미터로 가까운 매장 우선 조회
-8. **롯데마트 상품 조회**: /api/lottemart/products는 keyword와 함께 storeCode 또는 storeName이 필요합니다.
-9. **세븐일레븐 재고 조회**: /api/seveneleven/inventory에 keyword + storeKeyword를 함께 주면 매장별 수량을 바로 확인할 수 있습니다.
-10. **이마트24 재고 조회**: /api/emart24/inventory는 pluCd + storeKeyword 조합도 지원하므로, 상품 선택 뒤 매장 코드를 다시 모으지 않아도 됩니다.
-11. **올리브영 재고 해석**: inventory.products[].storeInventory.stores[]가 있으면 그 매장별 stockLabel과 remainQuantity를 우선 사용하고, inStock는 그 주변 매장 기준 결과로 해석합니다.
-12. **올리브영 상품 이미지 표시**: /api/oliveyoung/products 또는 oliveyoung_search_products 결과에 imageUrl이 있으면 목록형 답변에서도 각 상품 이미지를 생략하지 말고 모두 렌더링합니다. 특히 \`?l=ko\` 같은 query string을 삭제하지 말고 전체 URL 그대로 마크다운 이미지 src에 넣습니다.
+8. **위치 기반 재고**: lat, lng 파라미터로 가까운 매장 우선 조회
+9. **롯데마트 상품 조회**: /api/lottemart/products는 keyword와 함께 storeCode 또는 storeName이 필요합니다.
+10. **세븐일레븐 재고 조회**: /api/seveneleven/inventory에 keyword + storeKeyword를 함께 주면 매장별 수량을 바로 확인할 수 있습니다.
+11. **이마트24 재고 조회**: /api/emart24/inventory는 pluCd + storeKeyword 조합도 지원하므로, 상품 선택 뒤 매장 코드를 다시 모으지 않아도 됩니다.
+12. **올리브영 재고 해석**: inventory.products[].storeInventory.stores[]가 있으면 그 매장별 stockLabel과 remainQuantity를 우선 사용하고, inStock는 그 주변 매장 기준 결과로 해석합니다.
+13. **올리브영 상품 이미지 표시**: /api/oliveyoung/products 또는 oliveyoung_search_products 결과에 imageUrl이 있으면 목록형 답변에서도 각 상품 이미지를 생략하지 말고 모두 렌더링합니다. 특히 \`?l=ko\` 같은 query string을 삭제하지 말고 전체 URL 그대로 마크다운 이미지 src에 넣습니다.
+14. **주변 음식점/카페 검색**: 음식점이나 카페만 물으면 \`places_search_nearby\` 또는 /api/places/search를 먼저 사용합니다. 이 기능은 네이버 지역 검색 기반 키워드 검색이므로 좌표 반경 검색처럼 단정하지 말고, \`searchMode: "keyword"\`임을 필요할 때 짧게 밝혀주세요.
 
 ---
 
@@ -115,6 +123,7 @@ MCP 연결 정보: ${baseUrl}/mcp
 - seveneleven_check_inventory: 세븐일레븐 재고 조회
 - seveneleven_get_search_popwords: 세븐일레븐 인기 검색어 조회
 - seveneleven_get_catalog_snapshot: 세븐일레븐 카탈로그 조회
+- places_search_nearby: 음식점/카페 등 주변 장소 검색
 - oliveyoung_search_products: 올리브영 상품 검색
 - oliveyoung_find_nearby_stores: 올리브영 주변 매장 탐색
 - oliveyoung_check_inventory: 올리브영 재고 파악

package/dist/pages/promptRetailCinemaText.js

@@ -2,7 +2,28 @@
  * 프롬프트 리테일/영화 API 섹션
  */
 export function buildPromptRetailCinemaText(baseUrl) {
-    return `### 6-1. 롯데마트 매장/상품 조회
+    return `### 6-0. 주변 음식점/카페 검색
+
+**설명**: 네이버 지역 검색으로 특정 지역의 음식점, 카페, 디저트 가게 등 주변 장소를 조회합니다. 좌표 반경 검색이 아니라 \`강남역 카페\` 같은 키워드 기반 검색입니다.
+
+**URL**:
+- ${baseUrl}/api/places/search?location={지역}&category={카테고리}
+- ${baseUrl}/api/places/search?location={지역}&keyword={검색어}
+
+**선택 파라미터**:
+- location: 지역/역/주소 키워드 (예: 강남역, 성수동)
+- category: restaurant, cafe, food, dessert, all
+- keyword: 직접 검색어 (예: 라멘, 브런치, 조용한 카페)
+- limit: 최대 결과 수 (기본값: 5, 네이버 지역 검색 최대 5)
+- sort: random 또는 comment
+
+**예시**:
+- ${baseUrl}/api/places/search?location=강남역&category=cafe&limit=5
+- ${baseUrl}/api/places/search?location=성수동&keyword=브런치&limit=5
+
+---
+
+### 6-1. 롯데마트 매장/상품 조회
 
 **설명**: 롯데마트 계열 매장 검색과 특정 매장 기준 상품 가격/재고 조회를 제공합니다.
 
@@ -18,12 +39,13 @@ export function buildPromptRetailCinemaText(baseUrl) {
 - limit: 최대 결과 수 (기본값: 20)
 - storeCode 또는 storeName: 상품 검색 대상 매장
 - pageLimit: 추가 조회할 최대 페이지 수 (기본값: 3)
+- source: 상품 검색 경로 (auto, legacy, zetta). 빠른 검색이나 헬스체크에는 zetta 권장
 
 **예시**:
 - ${baseUrl}/api/lottemart/stores?keyword=잠실&area=서울&limit=10
 - ${baseUrl}/api/lottemart/stores?area=경기&brandVariant=lottemart&limit=10
 - ${baseUrl}/api/lottemart/products?keyword=콜라&storeName=강변점&area=서울
-- ${baseUrl}/api/lottemart/products?keyword=우유&storeCode=2301&pageLimit=2
+- ${baseUrl}/api/lottemart/products?keyword=우유&storeCode=2301&pageLimit=2&source=zetta
 
 ---