Naver Search MCP Server

Instructions

Implementation Reference

• src/handlers/search.handlers.ts:113-118 (handler)

  Core handler function that executes the shop search using NaverSearchClient.search('shop', params). This is the primary implementation of the tool logic.

  /**
   * 쇼핑 검색 핸들러
   */
  export async function handleShopSearch(params: SearchArgs) {
    return client.search("shop", params);
  }

• src/handlers/search.handlers.ts:23-26 (helper)

  Dispatcher function in searchToolHandlers that logs args, validates with schema, and delegates to handleShopSearch.

  search_shop: (args) => {
    console.error("search_shop called with args:", JSON.stringify(args, null, 2));
    return handleShopSearch(SearchArgsSchema.parse(args));
  },

• src/index.ts:147-160 (registration)

  MCP server registration of the 'search_shop' tool, including description, input schema reference, and handler invocation.

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

• src/schemas/search.schemas.ts:33-41 (schema)

  Zod schema defining the input parameters for search tools, including query, display, start, and sort options. Used for validation in search_shop.

  export const SearchArgsSchema = z.object({
    query: z.string().describe("검색어"),
    display: z.number().optional().describe("한 번에 가져올 결과 수 (기본 10)"),
    start: z.number().optional().describe("검색 시작 위치 (기본 1)"),
    sort: z
      .enum(["sim", "date"])
      .optional()
      .describe("정렬 방식 (sim: 유사도, date: 날짜순)"),
  });