Naver Search MCP Server

Instructions

Implementation Reference

• src/handlers/datalab.handlers.ts:129-145 (handler)

  Handler function that executes the core logic for datalab_shopping_keywords tool by mapping parameters and calling the Naver client API.

  /**
   * 쇼핑 키워드 트렌드 핸들러 (복수 키워드 그룹 지원)
   * 네이버 데이터랩 쇼핑 키워드 그룹 트렌드 분석 API 호출
   * @param params DatalabShoppingKeywords
   */
  export async function handleShoppingKeywordsTrend(
    params: DatalabShoppingKeywords
  ) {
    // 키워드 배열을 네이버 API에 맞는 형식으로 변환
    return client.datalabShoppingKeywords({
      startDate: params.startDate,
      endDate: params.endDate,
      timeUnit: params.timeUnit,
      category: params.category,
      keyword: params.keyword,
    });
  }

• src/schemas/datalab.schemas.ts:55-65 (schema)

  Zod schema defining input validation for the datalab_shopping_keywords tool parameters.

  export const DatalabShoppingKeywordsSchema = DatalabBaseSchema.extend({
    category: z.string().describe("Category code"),
    keyword: z
      .array(
        z.object({
          name: z.string().describe("Keyword name"),
          param: z.array(z.string()).describe("Keyword values"),
        })
      )
      .describe("Array of keyword name and value pairs"),
  });

• src/index.ts:361-374 (registration)

  MCP tool registration for 'datalab_shopping_keywords' including description, input schema, and handler invocation.

  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. 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);
      return {
        content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
      };
    }
  );

• src/clients/naver-search.client.ts:141-151 (helper)

  Client method that makes the actual HTTP POST request to Naver DataLab API for shopping keywords trend analysis.

  /**
   * 쇼핑 키워드 트렌드 분석 메서드
   */
  async datalabShoppingKeywords(
    params: DatalabShoppingKeywordsRequest
  ): Promise<DatalabShoppingResponse> {
    return this.post(
      `${this.datalabBaseUrl}/shopping/category/keywords`,
      params
    );
  }