Naver Search MCP Server

Instructions

Implementation Reference

• src/handlers/datalab.handlers.ts:170-181 (handler)

  The main handler function that receives validated parameters, maps them to the API request format, and delegates to the Naver client for execution.

  export async function handleShoppingKeywordByGenderTrend(
    params: DatalabShoppingKeywordGender
  ) {
    return client.datalabShoppingKeywordByGender({
      startDate: params.startDate,
      endDate: params.endDate,
      timeUnit: params.timeUnit,
      category: params.category,
      keyword: params.keyword,
      gender: params.gender,
    });
  }

• src/schemas/datalab.schemas.ts:75-79 (schema)

  Zod schema defining the input parameters for the tool: category code, keyword, and gender.

  export const DatalabShoppingKeywordGenderSchema = DatalabBaseSchema.extend({
    category: z.string().describe("Category code"),
    keyword: z.string().describe("Search keyword"),
    gender: z.enum(["f", "m"]).describe("Gender"),
  });

• src/index.ts:392-406 (registration)

  Registers the MCP tool with name, description, input schema, and handler that calls the datalabToolHandlers dispatcher.

  server.registerTool(
    "datalab_shopping_keyword_by_gender",
    {
      description:
        "👥🔍 Analyze keyword performance by gender within shopping categories. Use find_category first to get category codes. Essential for gender-targeted marketing and product positioning strategies. (쇼핑 키워드 성별 트렌드 - 먼저 find_category 도구로 카테고리 코드를 찾으세요)",
      inputSchema: DatalabShoppingKeywordGenderSchema.shape,
    },
    async (args) => {
      const result =
        await datalabToolHandlers.datalab_shopping_keyword_by_gender(args);
      return {
        content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
      };
    }
  );

• src/clients/naver-search.client.ts:168-175 (helper)

  Client method that performs the actual HTTP POST request to the Naver DataLab API endpoint for shopping keyword trends by gender.

  async datalabShoppingKeywordByGender(
    params: DatalabShoppingKeywordRequest
  ): Promise<DatalabShoppingResponse> {
    return this.post(
      `${this.datalabBaseUrl}/shopping/category/keyword/gender`,
      params
    );
  }