@isnow890/naver-search-mcp 1.0.45 → 1.0.47

package/README.md

@@ -6,76 +6,19 @@
 [![smithery badge](https://smithery.ai/badge/@isnow890/naver-search-mcp)](https://smithery.ai/server/@isnow890/naver-search-mcp)
 [![MCP.so](https://img.shields.io/badge/MCP.so-Naver%20Search%20MCP-blue)](https://mcp.so/server/naver-search-mcp/isnow890)
 
-#### Version History
+MCP server for Naver Search API and DataLab API integration, enabling comprehensive search across various Naver services and data trend analysis.
 
-###### 1.0.45 (2025-09-28)
+## Quick Start: Use Without API Key
 
-- Smithery compatibility issues resolved - Now available through Smithery with latest features
-- Excel compatibility issues fixed in category search - Replaced with JSON functionality
-- Web Korean search (`search_webkr`) functionality restored
-- Full compatibility with Smithery platform installations
-
-###### 1.0.44 (2025-08-31)
-
-- `get_current_korean_time` tool added - Essential time context tool for Korean timezone
-- Enhanced all existing tool descriptions to reference time tool for temporal queries
-- Improved temporal context handling for "today", "now", "current" searches
-- Comprehensive Korean time formatting with multiple output formats
-
-###### 1.0.4 (2025-08-21)
-
-- `find_category` tool added - with fuzzy matching and ranking system support
-- Enhanced parameter validation with Zod schema
-- Improved category search workflow
-
-###### 1.0.30 (2025-08-04)
-
-- MCP SDK upgraded to 1.17.1
-- Fixed compatibility issues with Smithery specification changes
-- Added comprehensive DataLab shopping category code documentation
-
-###### 1.0.2 (2025-04-26)
-
-- README updated: cafe article search tool and version history section improved
-
-###### 1.0.1 (2025-04-26)
-
-- Cafe article search feature added
-- Shopping category info added to zod
-- Source code refactored
-
-###### 1.0.0 (2025-04-08)
-
-- Initial release
-
-#### Prerequisites
-
-- Naver Developers API Key (Client ID and Secret)
-- Node.js 18 or higher
-- NPM 8 or higher
-- Docker (optional, for container deployment)
-
-#### Getting API Keys
-
-1. Visit [Naver Developers](https://developers.naver.com/apps/#/register)
-2. Click "Register Application"
-3. Enter application name and select ALL of the following APIs:
-   - Search (for blog, news, book search, etc.)
-   - DataLab (Search Trends)
-   - DataLab (Shopping Insight)
-4. Set the obtained Client ID and Client Secret as environment variables
+You can use this server immediately without API keys through [Kakao PlayMCP](https://playmcp.kakao.com/mcp/154). Simply visit the link and start using it right away!
 
 ## Tool Details
 
 ### Available tools:
 
-#### 🕐 Time & Context Tools
-
-- **get_current_korean_time**: Get current Korean time (KST) with comprehensive date/time information. Essential for understanding "today", "now", or "current" context in Korean timezone. Always use this tool when temporal context is needed for searches or analysis.
-
 #### 🆕 Category Search
 
-- **find_category**: Category search tool - No more need to manually check category numbers via URL for trend and shopping insight searches. The LLM will find it out as you say.
+- **find_category**: Category search tool so you no longer need to manually check category numbers in URLs for trend and shopping insight searches. Just describe the category in natural language.
 
 #### Search Tools
 
@@ -103,129 +46,26 @@
 - **datalab_shopping_keyword_by_gender**: Analyze shopping keyword trends by gender
 - **datalab_shopping_keyword_by_age**: Analyze shopping keyword trends by age group
 
-#### Complete Category List:
-
-For a complete list of category codes, you can download from Naver Shopping Partner Center or extract them by browsing Naver Shopping categories.
-
-### 🎯 Business Use Cases & Scenarios
-
-#### 🛍️ E-commerce Market Research
-
-```javascript
-// Fashion trend discovery
-find_category("fashion") → Check top fashion categories and codes
-datalab_shopping_category → Analyze seasonal fashion trends
-datalab_shopping_age → Identify fashion target demographics
-datalab_shopping_keywords → Compare "dress" vs "jacket" vs "coat"
-```
-
-#### 📱 Digital Marketing Strategy
-
-```javascript
-// Beauty industry analysis
-find_category("cosmetics") → Find beauty categories
-datalab_shopping_gender → 95% female vs 5% male shoppers
-datalab_shopping_device → Mobile dominance in beauty shopping
-datalab_shopping_keywords → "tint" vs "lipstick" keyword performance
-```
-
-#### 🏢 Business Intelligence & Competitive Analysis
-
-```javascript
-// Tech product insights
-find_category("smartphone") → Check electronics categories
-datalab_shopping_category → Track iPhone vs Galaxy trends
-datalab_shopping_age → 20-30s as main smartphone buyers
-datalab_shopping_device → PC vs mobile shopping behavior
-```
-
-#### 📊 Seasonal Business Planning
-
-```javascript
-// Holiday shopping analysis
-find_category("gift") → Gift categories
-datalab_shopping_category → Black Friday, Christmas trends
-datalab_shopping_keywords → "Mother's Day gift" vs "birthday gift"
-datalab_shopping_age → Age-based gift purchasing patterns
-```
-
-#### 🎯 Customer Persona Development
-
-```javascript
-// Fitness market analysis
-find_category("exercise") → Sports/fitness categories
-datalab_shopping_gender → Male vs female fitness spending
-datalab_shopping_age → Primary fitness demographics (20-40s)
-datalab_shopping_keywords → "home workout" vs "gym" trend analysis
-```
-
-### 📈 Advanced Analysis Scenarios
-
-#### Market Entry Strategy
-
-1. **Category Discovery**: Use `find_category` to explore market segments
-2. **Trend Analysis**: Identify growing vs declining categories
-3. **Demographic Targeting**: Age/gender analysis for customer targeting
-4. **Competitive Intelligence**: Keyword performance comparison
-5. **Device Strategy**: Mobile vs PC shopping optimization
-
-#### Product Launch Planning
-
-1. **Market Validation**: Category growth trends and seasonality
-2. **Target Customers**: Demographic analysis for product positioning
-3. **Marketing Channels**: Device preferences for advertising strategy
-4. **Competitive Landscape**: Keyword competition and opportunities
-5. **Pricing Strategy**: Category performance and price correlation
-
-#### Performance Monitoring
-
-1. **Category Health**: Monitor product category trends
-2. **Keyword Tracking**: Track brand and product keyword performance
-3. **Demographic Shifts**: Monitor changing customer demographics
-4. **Seasonal Patterns**: Plan inventory and marketing campaigns
-5. **Competitive Benchmarking**: Compare performance against category averages
-
-### Quick Reference: Popular Category Codes
-
-| Category            | Code     | Korean        |
-| ------------------- | -------- | ------------- |
-| Fashion/Clothing    | 50000000 | 패션의류      |
-| Cosmetics/Beauty    | 50000002 | 화장품/미용   |
-| Digital/Electronics | 50000003 | 디지털/가전   |
-| Sports/Leisure      | 50000004 | 스포츠/레저   |
-| Food/Beverages      | 50000008 | 식품/음료     |
-| Health/Medical      | 50000009 | 건강/의료용품 |
-
-💡 **Tip**: Use `find_category` with fuzzy searches like "beauty", "fashion", "electronics" to easily find categories.
+## Getting API Keys
+
+1. Visit [Naver Developers](https://developers.naver.com/apps/#/register) and log in with your Naver account
+2. Click the "Application Registration" (애플리케이션 등록) button
+3. Fill in the application information:
+   - **Application Name**: Enter any name (e.g., "Naver Search MCP")
+   - **Usage**: Select "Search" (검색)
+4. In the API Settings section, check ALL of the following APIs:
+   - **Search** (검색) - Required for blog, news, book, cafe article, web, image, kin, encyclopedia, academic, and local search
+   - **DataLab - Search Trends** (데이터랩 - 검색어 트렌드) - Required for search term trend analysis
+   - **DataLab - Shopping Insight** (데이터랩 - 쇼핑인사이트) - Required for shopping trend analysis
+5. Click "Register" to complete registration
+6. After registration, you'll see your **Client ID** and **Client Secret** on the application detail page
+7. Use these credentials in the configuration below
 
 ## Installation
 
-### Method 1: Smithery Installation (Recommended)
-
-The easiest way to use this MCP server is through Smithery.
+### Method 1: NPX Installation (Recommended)
 
-#### For Claude Desktop:
-
-```bash
-npx -y @smithery/cli@latest install @isnow890/naver-search-mcp --client claude
-```
-
-#### For other AI clients:
-
-```bash
-# Cursor
-npx -y @smithery/cli@latest install @isnow890/naver-search-mcp --client cursor
-
-# Windsurf
-npx -y @smithery/cli@latest install @isnow890/naver-search-mcp --client windsurf
-
-# Cline
-npx -y @smithery/cli@latest install @isnow890/naver-search-mcp --client cline
-```
-
-### Method 2: NPX Installation
-
-Alternatively, you can use NPX installation. For detailed package information, see the [NPM package page](https://www.npmjs.com/package/@isnow890/naver-search-mcp).
+The most reliable way to use this MCP server is through NPX. For detailed package information, see the [NPM package page](https://www.npmjs.com/package/@isnow890/naver-search-mcp).
 
 #### Claude Desktop Configuration
 
@@ -246,9 +86,9 @@ Add to Claude Desktop config file (`%APPDATA%\Claude\claude_desktop_config.json`
 }
 ```
 
-#### Cursor AI Configuration
+#### Claude Code Configuration
 
-Add to `mcp.json`:
+Add to your Claude Code settings:
 
 ```json
 {
@@ -265,6 +105,14 @@ Add to `mcp.json`:
 }
 ```
 
+### Method 2: Smithery Installation
+
+Install via Smithery CLI:
+
+```bash
+npx -y @smithery/cli@latest install @isnow890/naver-search-mcp --client claude
+```
+
 ### Method 3: Local Installation
 
 For local development or custom modifications:
@@ -282,7 +130,7 @@ npm run build
 
 ##### Or Download ZIP File
 
-1. Download the latest version from [GitHub Releases](https://github.com/isnow890/naver-search-mcp/releases)
+1. Download the latest version from [GitHub Releases](https://github.com/isnow890/naver-search-mcp)
 2. Extract the ZIP file to your desired location
 3. Navigate to the extracted folder in terminal:
 
@@ -372,51 +220,66 @@ pwd
 
 After completing the configuration, completely close and restart Claude Desktop to activate the Naver Search MCP server.
 
+## Prerequisites
+
+- Naver Developers API Key (Client ID and Secret)
+- Node.js 18 or higher
+- NPM 8 or higher
+
+## License
+
+MIT License
+
 ---
 
-## Alternative Installation Methods
+## Version History
 
-### Method 4: Docker Installation
+### 1.0.47 (2025-01-03)
 
-For containerized deployment:
+- **Added "today" keyword support** for all DataLab date parameters - no need to call separate time tool
+- **Fixed server termination issue** - MCP server now properly exits when client disconnects
+- **Added graceful shutdown handlers** for SIGINT, SIGTERM, and transport close events
+- **Removed get_current_korean_time tool** - redundant with new "today" keyword feature
+- **Removed memory monitoring module** - resolved setInterval blocking process exit
+- **Special thanks to @gloomyrobot** for reporting the server termination issue
 
-```bash
-docker run -i --rm \
-  -e NAVER_CLIENT_ID=your_client_id \
-  -e NAVER_CLIENT_SECRET=your_client_secret \
-  mcp/naver-search
-```
+### 1.0.45 (2025-09-28)
 
-Docker configuration for Claude Desktop:
+- Resolved Smithery compatibility issues so you can use the latest features through Smithery
+- Replaced the Excel export in category search with JSON for better compatibility
+- Restored the `search_webkr` tool for Korean web search
+- Fully compatible with Smithery platform installation
 
-```json
-{
-  "mcpServers": {
-    "naver-search": {
-      "command": "docker",
-      "args": [
-        "run",
-        "-i",
-        "--rm",
-        "-e",
-        "NAVER_CLIENT_ID=your_client_id",
-        "-e",
-        "NAVER_CLIENT_SECRET=your_client_secret",
-        "mcp/naver-search"
-      ]
-    }
-  }
-}
-```
+### 1.0.44 (2025-08-31)
 
-## Build
+- Added the `get_current_korean_time` tool for essential Korea Standard Time context
+- Referenced the time tool across existing tool descriptions for temporal queries
+- Improved handling of "today", "now", and "current" searches with temporal context
+- Expanded Korean date and time formatting outputs with multiple formats
 
-Docker build:
+### 1.0.40 (2025-08-21)
 
-```bash
-docker build -t mcp/naver-search .
-```
+- Added the `find_category` tool with fuzzy matching so you no longer need to check category numbers manually in URLs
+- Enhanced parameter validation with Zod schema
+- Improved the category search workflow
+- Implemented a level-based category ranking system that prioritizes top-level categories
 
-## License
+### 1.0.30 (2025-08-04)
 
-MIT License
+- MCP SDK upgraded to 1.17.1
+- Fixed compatibility issues with Smithery specification changes
+- Added comprehensive DataLab shopping category code documentation
+
+### 1.0.2 (2025-04-26)
+
+- README updated: cafe article search tool and version history section improved
+
+### 1.0.1 (2025-04-26)
+
+- Cafe article search feature added
+- Shopping category info added to zod
+- Source code refactored
+
+### 1.0.0 (2025-04-08)
+
+- Initial release

package/dist/src/clients/naver-api-core.client.d.ts

@@ -0,0 +1,17 @@
+import { AxiosRequestConfig, AxiosInstance } from "axios";
+import { NaverSearchConfig } from "../schemas/search.schemas.js";
+export declare abstract class NaverApiCoreClient {
+    protected searchBaseUrl: string;
+    protected datalabBaseUrl: string;
+    protected config: NaverSearchConfig | null;
+    protected axiosInstance: AxiosInstance;
+    constructor();
+    initialize(config: NaverSearchConfig): void;
+    protected getHeaders(contentType?: string): AxiosRequestConfig;
+    protected get<T>(url: string, params: any): Promise<T>;
+    protected post<T>(url: string, data: any): Promise<T>;
+    /**
+     * 리소스 정리 메서드 (메모리 누수 방지)
+     */
+    protected cleanup(): void;
+}

package/dist/src/clients/naver-api-core.client.js

@@ -4,6 +4,12 @@ export class NaverApiCoreClient {
         this.searchBaseUrl = "https://openapi.naver.com/v1/search";
         this.datalabBaseUrl = "https://openapi.naver.com/v1/datalab";
         this.config = null;
+        // HTTP/HTTPS 에이전트 설정으로 연결 풀링 및 메모리 누수 방지
+        this.axiosInstance = axios.create({
+            timeout: 30000, // 30초 타임아웃
+            maxRedirects: 3,
+            // HTTP 연결 풀링 설정은 운영체제에서 처리하도록 단순화
+        });
     }
     initialize(config) {
         this.config = config;
@@ -20,11 +26,33 @@ export class NaverApiCoreClient {
         };
     }
     async get(url, params) {
-        const response = await axios.get(url, { params, ...this.getHeaders() });
-        return response.data;
+        try {
+            const response = await this.axiosInstance.get(url, {
+                params,
+                ...this.getHeaders()
+            });
+            return response.data;
+        }
+        catch (error) {
+            // 연결 정리는 axios가 자동으로 처리하지만 명시적으로 에러 처리
+            throw error;
+        }
     }
     async post(url, data) {
-        const response = await axios.post(url, data, this.getHeaders());
-        return response.data;
+        try {
+            const response = await this.axiosInstance.post(url, data, this.getHeaders());
+            return response.data;
+        }
+        catch (error) {
+            // 연결 정리는 axios가 자동으로 처리하지만 명시적으로 에러 처리
+            throw error;
+        }
+    }
+    /**
+     * 리소스 정리 메서드 (메모리 누수 방지)
+     */
+    cleanup() {
+        // 연결 정리 - axios가 자동으로 처리
+        this.config = null;
     }
 }

package/dist/src/clients/naver-search.client.d.ts

@@ -0,0 +1,78 @@
+import { NaverApiCoreClient } from "./naver-api-core.client.js";
+import { NaverSearchType, NaverSearchConfig, NaverLocalSearchParams, NaverDocumentSearchParams, SearchArgs } from "../schemas/search.schemas.js";
+import { NaverDocumentSearchResponse, NaverLocalSearchResponse } from "../types/search.types.js";
+import { DatalabSearchRequest, DatalabShoppingResponse, DatalabShoppingCategoryRequest, DatalabShoppingDeviceRequest, DatalabShoppingGenderRequest, DatalabShoppingAgeRequest, DatalabShoppingKeywordsRequest, DatalabShoppingKeywordRequest } from "../types/datalab.types.js";
+/**
+ * NaverSearchClient - 네이버 API 서비스를 위한 싱글톤 클라이언트
+ * 검색, 데이터랩 API 요청 처리
+ */
+export declare class NaverSearchClient extends NaverApiCoreClient {
+    private static instance;
+    private constructor();
+    /**
+     * 싱글톤 인스턴스 반환
+     */
+    static getInstance(): NaverSearchClient;
+    /**
+     * 싱글톤 인스턴스 정리 (메모리 누수 방지)
+     */
+    static destroyInstance(): void;
+    /**
+     * 인스턴스 리소스 정리
+     */
+    protected cleanup(): void;
+    /**
+     * API 자격 증명으로 클라이언트 초기화
+     */
+    initialize(config: NaverSearchConfig): void;
+    /**
+     * 네이버 검색 API 호출 (type별로)
+     * @param type 검색 타입(카테고리)
+     * @param params 검색 파라미터
+     */
+    search(type: NaverSearchType, params: SearchArgs): Promise<any>;
+    /**
+     * 전문자료 검색 메서드
+     */
+    searchAcademic(params: NaverDocumentSearchParams): Promise<NaverDocumentSearchResponse>;
+    /**
+     * 지역 검색 메서드
+     */
+    searchLocal(params: NaverLocalSearchParams): Promise<NaverLocalSearchResponse>;
+    /**
+     * 검색어 트렌드 분석 메서드
+     */
+    searchTrend(params: DatalabSearchRequest): Promise<any>;
+    /**
+     * 쇼핑 카테고리 트렌드 분석 메서드
+     */
+    datalabShoppingCategory(params: DatalabShoppingCategoryRequest): Promise<DatalabShoppingResponse>;
+    /**
+     * 쇼핑 기기별 트렌드 분석 메서드
+     */
+    datalabShoppingByDevice(params: DatalabShoppingDeviceRequest): Promise<DatalabShoppingResponse>;
+    /**
+     * 쇼핑 성별 트렌드 분석 메서드
+     */
+    datalabShoppingByGender(params: DatalabShoppingGenderRequest): Promise<DatalabShoppingResponse>;
+    /**
+     * 쇼핑 연령별 트렌드 분석 메서드
+     */
+    datalabShoppingByAge(params: DatalabShoppingAgeRequest): Promise<DatalabShoppingResponse>;
+    /**
+     * 쇼핑 키워드 트렌드 분석 메서드
+     */
+    datalabShoppingKeywords(params: DatalabShoppingKeywordsRequest): Promise<DatalabShoppingResponse>;
+    /**
+     * 쇼핑 키워드 기기별 트렌드 분석 메서드
+     */
+    datalabShoppingKeywordByDevice(params: DatalabShoppingKeywordRequest): Promise<DatalabShoppingResponse>;
+    /**
+     * 쇼핑 키워드 성별 트렌드 분석 메서드
+     */
+    datalabShoppingKeywordByGender(params: DatalabShoppingKeywordRequest): Promise<DatalabShoppingResponse>;
+    /**
+     * 쇼핑 키워드 연령별 트렌드 분석 메서드
+     */
+    datalabShoppingKeywordByAge(params: DatalabShoppingKeywordRequest): Promise<DatalabShoppingResponse>;
+}

package/dist/src/clients/naver-search.client.js

@@ -16,6 +16,23 @@ export class NaverSearchClient extends NaverApiCoreClient {
         }
         return NaverSearchClient.instance;
     }
+    /**
+     * 싱글톤 인스턴스 정리 (메모리 누수 방지)
+     */
+    static destroyInstance() {
+        if (NaverSearchClient.instance) {
+            NaverSearchClient.instance.cleanup();
+            NaverSearchClient.instance = null;
+        }
+    }
+    /**
+     * 인스턴스 리소스 정리
+     */
+    cleanup() {
+        this.config = null;
+        // HTTP 연결 정리는 부모 클래스에서 처리
+        super.cleanup();
+    }
     /**
      * API 자격 증명으로 클라이언트 초기화
      */

package/dist/src/handlers/category.handlers.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 캐시 정리 함수 (메모리 누수 방지)
+ */
+export declare function clearCategoriesCache(): void;
+/**
+ * 카테고리 검색 핸들러
+ */
+export declare const findCategoryHandler: ({ query, max_results }: any) => Promise<any>;
+export declare const categoryToolHandlers: Record<string, (args: any) => Promise<any>>;

package/dist/src/handlers/category.handlers.js

@@ -1,18 +1,26 @@
 // Import JSON data - bundle-safe approach
-import * as fs from 'fs';
-import * as path from 'path';
+import { existsSync, readFileSync } from 'fs';
+import { join } from 'path';
+// 메모리 누수 방지를 위한 지연 로딩 캐시
+let categoriesCache = null;
 // Load categories data with fallback paths for different environments
 function getCategoriesData() {
+    // 캐시된 데이터가 있으면 반환 (메모리 효율성)
+    if (categoriesCache !== null) {
+        return categoriesCache;
+    }
     try {
         // Try bundled data path first (dist/data)
-        const bundledPath = path.join(process.cwd(), 'dist', 'data', 'categories.json');
-        if (fs.existsSync(bundledPath)) {
-            return JSON.parse(fs.readFileSync(bundledPath, 'utf8'));
+        const bundledPath = join(process.cwd(), 'dist', 'data', 'categories.json');
+        if (existsSync(bundledPath)) {
+            categoriesCache = JSON.parse(readFileSync(bundledPath, 'utf8'));
+            return categoriesCache;
         }
         // Fallback to source data path
-        const sourcePath = path.join(process.cwd(), 'data', 'categories.json');
-        if (fs.existsSync(sourcePath)) {
-            return JSON.parse(fs.readFileSync(sourcePath, 'utf8'));
+        const sourcePath = join(process.cwd(), 'data', 'categories.json');
+        if (existsSync(sourcePath)) {
+            categoriesCache = JSON.parse(readFileSync(sourcePath, 'utf8'));
+            return categoriesCache;
         }
         throw new Error('카테고리 데이터 파일을 찾을 수 없습니다');
     }
@@ -21,14 +29,20 @@ function getCategoriesData() {
         return [];
     }
 }
-const categoriesData = getCategoriesData();
+/**
+ * 캐시 정리 함수 (메모리 누수 방지)
+ */
+export function clearCategoriesCache() {
+    categoriesCache = null;
+}
 /**
  * Load category data from bundled JSON file
  */
 async function loadCategoryData() {
-    // Return the pre-loaded JSON data - no file system access needed
-    console.error(`Loaded ${categoriesData.length} categories from bundled JSON data`);
-    return categoriesData;
+    // 지연 로딩된 캐시 데이터 사용
+    const data = getCategoriesData();
+    console.error(`Loaded ${data.length} categories from bundled JSON data`);
+    return data;
 }
 /**
  * Smart category search with fuzzy matching and ranking

package/dist/src/handlers/datalab.handlers.d.ts

@@ -0,0 +1,61 @@
+import { DatalabSearch, DatalabShopping, DatalabShoppingDevice, DatalabShoppingGender, DatalabShoppingAge, DatalabShoppingKeywords, DatalabShoppingKeywordDevice, DatalabShoppingKeywordGender, DatalabShoppingKeywordAge } from "../schemas/datalab.schemas.js";
+/**
+ * 데이터랩 도구 핸들러 맵
+ * 각 도구 이름을 키로, 실행할 핸들러 함수를 값으로 가짐
+ * index.ts에서 도구 실행 분기 없이 바로 사용
+ */
+export declare const datalabToolHandlers: Record<string, (args: any) => Promise<any>>;
+/**
+ * 검색어 트렌드 핸들러
+ * 네이버 데이터랩 검색어 트렌드 분석 API 호출
+ * @param params DatalabSearch
+ */
+export declare function handleSearchTrend(params: DatalabSearch): Promise<any>;
+/**
+ * 쇼핑 카테고리 트렌드 핸들러
+ * 네이버 데이터랩 쇼핑 카테고리별 트렌드 분석 API 호출
+ * @param params DatalabShopping
+ */
+export declare function handleShoppingCategoryTrend(params: DatalabShopping): Promise<import("../types/datalab.types.js").DatalabShoppingResponse>;
+/**
+ * 쇼핑 기기별 트렌드 핸들러
+ * 네이버 데이터랩 쇼핑 기기별 트렌드 분석 API 호출
+ * @param params DatalabShoppingDevice
+ */
+export declare function handleShoppingByDeviceTrend(params: DatalabShoppingDevice): Promise<import("../types/datalab.types.js").DatalabShoppingResponse>;
+/**
+ * 쇼핑 성별 트렌드 핸들러
+ * 네이버 데이터랩 쇼핑 성별 트렌드 분석 API 호출
+ * @param params DatalabShoppingGender
+ */
+export declare function handleShoppingByGenderTrend(params: DatalabShoppingGender): Promise<import("../types/datalab.types.js").DatalabShoppingResponse>;
+/**
+ * 쇼핑 연령별 트렌드 핸들러
+ * 네이버 데이터랩 쇼핑 연령별 트렌드 분석 API 호출
+ * @param params DatalabShoppingAge
+ */
+export declare function handleShoppingByAgeTrend(params: DatalabShoppingAge): Promise<import("../types/datalab.types.js").DatalabShoppingResponse>;
+/**
+ * 쇼핑 키워드 트렌드 핸들러 (복수 키워드 그룹 지원)
+ * 네이버 데이터랩 쇼핑 키워드 그룹 트렌드 분석 API 호출
+ * @param params DatalabShoppingKeywords
+ */
+export declare function handleShoppingKeywordsTrend(params: DatalabShoppingKeywords): Promise<import("../types/datalab.types.js").DatalabShoppingResponse>;
+/**
+ * 쇼핑 키워드 기기별 트렌드 핸들러
+ * 네이버 데이터랩 쇼핑 키워드 기기별 트렌드 분석 API 호출
+ * @param params DatalabShoppingKeywordDevice
+ */
+export declare function handleShoppingKeywordByDeviceTrend(params: DatalabShoppingKeywordDevice): Promise<import("../types/datalab.types.js").DatalabShoppingResponse>;
+/**
+ * 쇼핑 키워드 성별 트렌드 핸들러
+ * 네이버 데이터랩 쇼핑 키워드 성별 트렌드 분석 API 호출
+ * @param params DatalabShoppingKeywordGender
+ */
+export declare function handleShoppingKeywordByGenderTrend(params: DatalabShoppingKeywordGender): Promise<import("../types/datalab.types.js").DatalabShoppingResponse>;
+/**
+ * 쇼핑 키워드 연령별 트렌드 핸들러
+ * 네이버 데이터랩 쇼핑 키워드 연령별 트렌드 분석 API 호출
+ * @param params DatalabShoppingKeywordAge
+ */
+export declare function handleShoppingKeywordByAgeTrend(params: DatalabShoppingKeywordAge): Promise<import("../types/datalab.types.js").DatalabShoppingResponse>;