@isnow890/naver-search-mcp 1.0.43 → 1.0.44

package/README.md

@@ -12,6 +12,13 @@ MCP server for Naver Search API and DataLab API integration, enabling comprehens
 
 #### Version History
 
+###### 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
@@ -59,6 +66,10 @@ MCP server for Naver Search API and DataLab API integration, enabling comprehens
 
 ### 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.

package/dist/src/handlers/time.handlers.js

@@ -0,0 +1,32 @@
+/**
+ * Get current Korean time (KST/UTC+9)
+ * @param args - No arguments required
+ * @returns Current Korean time in multiple formats
+ */
+export async function getCurrentKoreanTime(args) {
+    const now = new Date();
+    const koreanTime = new Date(now.toLocaleString("en-US", { timeZone: "Asia/Seoul" }));
+    return {
+        current_korean_time: {
+            iso_string: koreanTime.toISOString(),
+            korean_date: koreanTime.toLocaleDateString("ko-KR", {
+                year: "numeric",
+                month: "long",
+                day: "numeric",
+                weekday: "long"
+            }),
+            korean_time: koreanTime.toLocaleTimeString("ko-KR", {
+                hour: "2-digit",
+                minute: "2-digit",
+                second: "2-digit",
+                hour12: false
+            }),
+            formatted: `${koreanTime.getFullYear()}년 ${koreanTime.getMonth() + 1}월 ${koreanTime.getDate()}일 ${koreanTime.toLocaleDateString("ko-KR", { weekday: "long" })} ${koreanTime.toLocaleTimeString("ko-KR", { hour12: false })}`,
+            timezone: "Asia/Seoul (KST)",
+            timestamp: koreanTime.getTime()
+        }
+    };
+}
+export const timeToolHandlers = {
+    getCurrentKoreanTime,
+};

package/dist/src/index.js

@@ -9,6 +9,8 @@ import { SearchArgsSchema, NaverLocalSearchParamsSchema, } from "./schemas/searc
 import { DatalabSearchSchema, DatalabShoppingSchema, DatalabShoppingDeviceSchema, DatalabShoppingGenderSchema, DatalabShoppingAgeSchema, DatalabShoppingKeywordsSchema, DatalabShoppingKeywordDeviceSchema, DatalabShoppingKeywordGenderSchema, DatalabShoppingKeywordAgeSchema, } from "./schemas/datalab.schemas.js";
 import { FindCategorySchema } from "./schemas/category.schemas.js";
 import { findCategoryHandler } from "./handlers/category.handlers.js";
+import { GetKoreanTimeSchema } from "./schemas/time.schemas.js";
+import { timeToolHandlers } from "./handlers/time.handlers.js";
 // Configuration schema for Smithery
 export const configSchema = z.object({
     NAVER_CLIENT_ID: z.string().describe("Naver API Client ID"),
@@ -24,7 +26,7 @@ export function createNaverSearchServer({ config, }) {
     // Create a new MCP server only once
     const server = new McpServer({
         name: "naver-search",
-        version: "1.0.43",
+        version: "1.0.44",
     });
     // Initialize Naver client with config
     const client = NaverSearchClient.getInstance();
@@ -33,7 +35,7 @@ export function createNaverSearchServer({ config, }) {
         clientSecret: config.NAVER_CLIENT_SECRET,
     });
     server.registerTool("search_news", {
-        description: "📰 Search latest Korean news articles from major outlets. Perfect for current events, breaking news, and recent developments. Covers politics, economy, society, and international news. (네이버 뉴스 검색 - 최신 뉴스와 시사 정보)",
+        description: "📰 Search latest Korean news articles from major outlets. Perfect for current events, breaking news, and recent developments. Covers politics, economy, society, and international news. For today's news or current events, use get_current_korean_time first to understand what 'today' means. (네이버 뉴스 검색 - 최신 뉴스와 시사 정보, 오늘 뉴스를 찾을 때는 먼저 get_current_korean_time으로 현재 시간을 확인하세요)",
         inputSchema: SearchArgsSchema.shape,
     }, async (args) => {
         const result = await searchToolHandlers.search_news(args);
@@ -42,7 +44,7 @@ export function createNaverSearchServer({ config, }) {
         };
     });
     server.registerTool("search_blog", {
-        description: "✍️ Search personal blogs and reviews for authentic user experiences. Great for product reviews, personal stories, detailed tutorials, and real user opinions. Find genuine Korean perspectives. (네이버 블로그 검색 - 실제 사용자 후기와 개인적 경험)",
+        description: "✍️ Search personal blogs and reviews for authentic user experiences. Great for product reviews, personal stories, detailed tutorials, and real user opinions. Find genuine Korean perspectives. For recent posts or 'today's content', use get_current_korean_time first. (네이버 블로그 검색 - 실제 사용자 후기와 개인적 경험, 최근 글이나 오늘 내용을 찾을 때는 먼저 get_current_korean_time으로 현재 시간을 확인하세요)",
         inputSchema: SearchArgsSchema.shape,
     }, async (args) => {
         const result = await searchToolHandlers.search_blog(args);
@@ -51,7 +53,7 @@ export function createNaverSearchServer({ config, }) {
         };
     });
     server.registerTool("search_shop", {
-        description: "🛒 Search Naver Shopping for products, prices, and shopping deals. Compare prices across vendors, find product specifications, and discover shopping trends in Korea. (네이버 쇼핑 검색 - 상품 정보와 가격 비교)",
+        description: "🛒 Search Naver Shopping for products, prices, and shopping deals. Compare prices across vendors, find product specifications, and discover shopping trends in Korea. For current deals or today's specials, use get_current_korean_time first. (네이버 쇼핑 검색 - 상품 정보와 가격 비교, 현재 할인이나 오늘 특가를 찾을 때는 먼저 get_current_korean_time으로 현재 시간을 확인하세요)",
         inputSchema: SearchArgsSchema.shape,
     }, async (args) => {
         const result = await searchToolHandlers.search_shop(args);
@@ -60,7 +62,7 @@ export function createNaverSearchServer({ config, }) {
         };
     });
     server.registerTool("search_image", {
-        description: "🖼️ Search for images with Korean context and relevance. Find visual content, infographics, charts, and photos related to your search terms. Great for visual research and content discovery. (네이버 이미지 검색 - 시각적 컨텐츠 발견)",
+        description: "🖼️ Search for images with Korean context and relevance. Find visual content, infographics, charts, and photos related to your search terms. Great for visual research and content discovery. For recent images or current visual content, use get_current_korean_time first. (네이버 이미지 검색 - 시각적 컨텐츠 발견, 최근 이미지나 현재 시각 자료를 찾을 때는 먼저 get_current_korean_time으로 현재 시간을 확인하세요)",
         inputSchema: SearchArgsSchema.shape,
     }, async (args) => {
         const result = await searchToolHandlers.search_image(args);
@@ -69,7 +71,7 @@ export function createNaverSearchServer({ config, }) {
         };
     });
     server.registerTool("search_kin", {
-        description: "❓ Search Naver KnowledgeiN for Q&A and community-driven answers. Find solutions to problems, get expert advice, and discover community insights on various topics. (네이버 지식iN 검색 - 질문과 답변, 커뮤니티 지식)",
+        description: "❓ Search Naver KnowledgeiN for Q&A and community-driven answers. Find solutions to problems, get expert advice, and discover community insights on various topics. For recent questions or current discussions, use get_current_korean_time first. (네이버 지식iN 검색 - 질문과 답변, 커뮤니티 지식, 최근 질문이나 현재 토론을 찾을 때는 먼저 get_current_korean_time으로 현재 시간을 확인하세요)",
         inputSchema: SearchArgsSchema.shape,
     }, async (args) => {
         const result = await searchToolHandlers.search_kin(args);
@@ -78,7 +80,7 @@ export function createNaverSearchServer({ config, }) {
         };
     });
     server.registerTool("search_book", {
-        description: "📚 Search for books, publications, and literary content. Find book reviews, author information, publication details, and reading recommendations in Korean literature and translated works. (네이버 책 검색 - 도서 정보와 서평)",
+        description: "📚 Search for books, publications, and literary content. Find book reviews, author information, publication details, and reading recommendations in Korean literature and translated works. For new releases or current bestsellers, use get_current_korean_time first. (네이버 책 검색 - 도서 정보와 서평, 신간도서나 현재 베스트셀러를 찾을 때는 먼저 get_current_korean_time으로 현재 시간을 확인하세요)",
         inputSchema: SearchArgsSchema.shape,
     }, async (args) => {
         const result = await searchToolHandlers.search_book(args);
@@ -87,7 +89,7 @@ export function createNaverSearchServer({ config, }) {
         };
     });
     server.registerTool("search_encyc", {
-        description: "📖 Search Naver Encyclopedia for authoritative knowledge and definitions. Best for academic research, getting reliable information, and understanding Korean concepts and terminology. (네이버 지식백과 검색 - 신뢰할 수 있는 정보와 정의)",
+        description: "📖 Search Naver Encyclopedia for authoritative knowledge and definitions. Best for academic research, getting reliable information, and understanding Korean concepts and terminology. For current definitions or recent updates, use get_current_korean_time for context. (네이버 지식백과 검색 - 신뢰할 수 있는 정보와 정의, 현재 정의나 최근 업데이트를 찾을 때는 get_current_korean_time으로 상황을 파악하세요)",
         inputSchema: SearchArgsSchema.shape,
     }, async (args) => {
         const result = await searchToolHandlers.search_encyc(args);
@@ -96,7 +98,7 @@ export function createNaverSearchServer({ config, }) {
         };
     });
     server.registerTool("search_academic", {
-        description: "🎓 Search academic papers, research documents, and scholarly content. Access Korean academic resources, research papers, theses, and professional publications. (네이버 전문자료 검색 - 학술 논문과 전문 자료)",
+        description: "🎓 Search academic papers, research documents, and scholarly content. Access Korean academic resources, research papers, theses, and professional publications. For recent publications or current research, use get_current_korean_time first. (네이버 전문자료 검색 - 학술 논문과 전문 자료, 최근 발표나 현재 연구를 찾을 때는 먼저 get_current_korean_time으로 현재 시간을 확인하세요)",
         inputSchema: SearchArgsSchema.shape,
     }, async (args) => {
         const result = await searchToolHandlers.search_academic(args);
@@ -105,7 +107,7 @@ export function createNaverSearchServer({ config, }) {
         };
     });
     server.registerTool("search_local", {
-        description: "📍 Search for local businesses, restaurants, and places in Korea. Find location information, reviews, contact details, and business hours for Korean establishments. (네이버 지역 검색 - 지역 업체와 장소 정보)",
+        description: "📍 Search for local businesses, restaurants, and places in Korea. Find location information, reviews, contact details, and business hours for Korean establishments. For current business hours or today's availability, use get_current_korean_time first. (네이버 지역 검색 - 지역 업체와 장소 정보, 현재 영업시간이나 오늘 이용 가능 여부를 확인할 때는 먼저 get_current_korean_time으로 현재 시간을 확인하세요)",
         inputSchema: NaverLocalSearchParamsSchema.shape,
     }, async (args) => {
         const result = await searchToolHandlers.search_local(args);
@@ -114,7 +116,7 @@ export function createNaverSearchServer({ config, }) {
         };
     });
     server.registerTool("search_cafearticle", {
-        description: "☕ Search Naver Cafe articles for community discussions and specialized content. Find niche communities, hobby groups, and specialized discussions on various topics. (네이버 카페글 검색 - 커뮤니티 토론과 전문 정보)",
+        description: "☕ Search Naver Cafe articles for community discussions and specialized content. Find niche communities, hobby groups, and specialized discussions on various topics. For recent discussions or current community topics, use get_current_korean_time first. (네이버 카페글 검색 - 커뮤니티 토론과 전문 정보, 최근 논의나 현재 커뮤니티 주제를 찾을 때는 먼저 get_current_korean_time으로 현재 시간을 확인하세요)",
         inputSchema: SearchArgsSchema.shape,
     }, async (args) => {
         const result = await searchToolHandlers.search_cafearticle(args);
@@ -124,7 +126,7 @@ export function createNaverSearchServer({ config, }) {
     });
     // Register datalab tools
     server.registerTool("datalab_search", {
-        description: "📊 Analyze search keyword trends over time using Naver DataLab. Track popularity changes, seasonal patterns, and compare multiple keywords. Perfect for market research and trend analysis. (네이버 데이터랩 검색어 트렌드 분석)",
+        description: "📊 Analyze search keyword trends over time using Naver DataLab. Track popularity changes, seasonal patterns, and compare multiple keywords. Perfect for market research and trend analysis. For current trend analysis or 'recent trends', use get_current_korean_time to determine proper date ranges. (네이버 데이터랩 검색어 트렌드 분석, 현재 트렌드나 최근 동향 분석 시 get_current_korean_time으로 적절한 날짜 범위를 설정하세요)",
         inputSchema: DatalabSearchSchema.shape,
     }, async (args) => {
         const result = await datalabToolHandlers.datalab_search(args);
@@ -133,7 +135,7 @@ export function createNaverSearchServer({ config, }) {
         };
     });
     server.registerTool("datalab_shopping_category", {
-        description: "🛍️ STEP 2: Analyze shopping category trends over time. Use find_category first to get category codes. BUSINESS CASES: Market size analysis, seasonal trend identification, category performance comparison. EXAMPLE: Compare '패션의류' vs '화장품' trends over 6 months. (네이버 쇼핑 카테고리별 트렌드 분석 - 먼저 find_category 도구로 카테고리 코드를 찾으세요)",
+        description: "🛍️ STEP 2: Analyze shopping category trends over time. Use find_category first to get category codes. BUSINESS CASES: Market size analysis, seasonal trend identification, category performance comparison. EXAMPLE: Compare '패션의류' vs '화장품' trends over 6 months. For current period analysis, use get_current_korean_time to set proper date ranges. (네이버 쇼핑 카테고리별 트렌드 분석 - 먼저 find_category 도구로 카테고리 코드를 찾고, 현재 기간 분석시 get_current_korean_time으로 적절한 날짜 범위 설정)",
         inputSchema: DatalabShoppingSchema.shape,
     }, async (args) => {
         const result = await datalabToolHandlers.datalab_shopping_category(args);
@@ -142,7 +144,7 @@ export function createNaverSearchServer({ config, }) {
         };
     });
     server.registerTool("datalab_shopping_by_device", {
-        description: "📱 Analyze shopping trends by device (PC vs Mobile). Use find_category first. BUSINESS CASES: Mobile commerce strategy, responsive design priority, device-specific campaigns. EXAMPLE: 'PC 사용자가 더 많이 구매하는 카테고리는?' (기기별 쇼핑 트렌드 분석 - 먼저 find_category 도구로 카테고리 코드를 찾으세요)",
+        description: "📱 Analyze shopping trends by device (PC vs Mobile). Use find_category first. BUSINESS CASES: Mobile commerce strategy, responsive design priority, device-specific campaigns. EXAMPLE: 'PC 사용자가 더 많이 구매하는 카테고리는?' For current device trends, use get_current_korean_time to set proper analysis period. (기기별 쇼핑 트렌드 분석 - 먼저 find_category 도구로 카테고리 코드를 찾고, 현재 기기 트렌드 분석시 get_current_korean_time으로 적절한 분석 기간 설정)",
         inputSchema: DatalabShoppingDeviceSchema.pick({
             startDate: true,
             endDate: true,
@@ -157,7 +159,7 @@ export function createNaverSearchServer({ config, }) {
         };
     });
     server.registerTool("datalab_shopping_by_gender", {
-        description: "👥 Analyze shopping trends by gender (Male vs Female). Use find_category first. BUSINESS CASES: Gender-targeted marketing, product positioning, demographic analysis. EXAMPLE: '화장품 쇼핑에서 남녀 비율은?' (성별 쇼핑 트렌드 분석 - 먼저 find_category 도구로 카테고리 코드를 찾으세요)",
+        description: "👥 Analyze shopping trends by gender (Male vs Female). Use find_category first. BUSINESS CASES: Gender-targeted marketing, product positioning, demographic analysis. EXAMPLE: '화장품 쇼핑에서 남녀 비율은?' For current gender trends, use get_current_korean_time to set proper analysis period. (성별 쇼핑 트렌드 분석 - 먼저 find_category 도구로 카테고리 코드를 찾고, 현재 성별 트렌드 분석시 get_current_korean_time으로 적절한 분석 기간 설정)",
         inputSchema: DatalabShoppingGenderSchema.pick({
             startDate: true,
             endDate: true,
@@ -172,7 +174,7 @@ export function createNaverSearchServer({ config, }) {
         };
     });
     server.registerTool("datalab_shopping_by_age", {
-        description: "👶👦👨👴 Analyze shopping trends by age groups (10s, 20s, 30s, 40s, 50s, 60s+). Use find_category first. BUSINESS CASES: Age-targeted products, generational preferences, lifecycle marketing. EXAMPLE: '개발 도구는 어느 연령대가 많이 구매하나?' (연령별 쇼핑 트렌드 - 먼저 find_category 도구로 카테고리 코드를 찾으세요)",
+        description: "👶👦👨👴 Analyze shopping trends by age groups (10s, 20s, 30s, 40s, 50s, 60s+). Use find_category first. BUSINESS CASES: Age-targeted products, generational preferences, lifecycle marketing. EXAMPLE: '개발 도구는 어느 연령대가 많이 구매하나?' For current age trends, use get_current_korean_time to set proper analysis period. (연령별 쇼핑 트렌드 - 먼저 find_category 도구로 카테고리 코드를 찾고, 현재 연령 트렌드 분석시 get_current_korean_time으로 적절한 분석 기간 설정)",
         inputSchema: DatalabShoppingAgeSchema.pick({
             startDate: true,
             endDate: true,
@@ -187,7 +189,7 @@ export function createNaverSearchServer({ config, }) {
         };
     });
     server.registerTool("datalab_shopping_keywords", {
-        description: "🔍 Compare specific keywords within a shopping category. Use find_category first. BUSINESS CASES: Product keyword optimization, competitor analysis, search trend identification. EXAMPLE: Within '패션' category, compare '원피스' vs '자켓' vs '드레스' trends. (카테고리 내 키워드 비교 - 먼저 find_category 도구로 카테고리 코드를 찾으세요)",
+        description: "🔍 Compare specific keywords within a shopping category. Use find_category first. BUSINESS CASES: Product keyword optimization, competitor analysis, search trend identification. EXAMPLE: Within '패션' category, compare '원피스' vs '자켓' vs '드레스' trends. For current keyword trends, use get_current_korean_time to set proper analysis period. (카테고리 내 키워드 비교 - 먼저 find_category 도구로 카테고리 코드를 찾고, 현재 키워드 트렌드 분석시 get_current_korean_time으로 적절한 분석 기간 설정)",
         inputSchema: DatalabShoppingKeywordsSchema.shape,
     }, async (args) => {
         const result = await datalabToolHandlers.datalab_shopping_keywords(args);
@@ -222,6 +224,16 @@ export function createNaverSearchServer({ config, }) {
             content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
         };
     });
+    // Register current time tool
+    server.registerTool("get_current_korean_time", {
+        description: "🕐 Get current Korean time (KST) with date and time information. Use this tool whenever you need to know 'today', 'now', 'current time', or any time-related queries. Essential for understanding what 'today' means in Korean context. Always use this tool when users mention 'today' or 'current' to provide accurate time context. (현재 한국 시간 조회 - '오늘', '현재', '지금' 등의 시간 정보가 필요할 때 항상 사용하세요)",
+        inputSchema: GetKoreanTimeSchema.shape,
+    }, async (args) => {
+        const result = await timeToolHandlers.getCurrentKoreanTime(args);
+        return {
+            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        };
+    });
     // Register category search tool
     server.registerTool("find_category", {
         description: "🚀 STEP 1: Find shopping categories with Korean search terms. Search in KOREAN (패션, 화장품, 가전제품, etc.) to find category codes needed for datalab tools. Smart fuzzy matching finds similar categories even with partial matches. (카테고리 검색: 한국어로 검색하여 데이터랩 분석에 필요한 카테고리 코드를 찾아주는 필수 도구)",

package/dist/src/schemas/time.schemas.js

@@ -0,0 +1,7 @@
+import { z } from "zod";
+/**
+ * Schema for Korean time tool - no parameters needed
+ */
+export const GetKoreanTimeSchema = z.object({
+// No parameters required for getting current time
+});

package/dist/src/types/time.types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@isnow890/naver-search-mcp",
-  "version": "1.0.43",
+  "version": "1.0.44",
   "description": "Naver Search MCP Server",
   "main": "dist/src/index.js",
   "module": "./src/index.ts",