search_local
Find local businesses and services in a specific area by querying Naver’s database, with options to sort results by accuracy or review count and control the number of displayed outcomes.
Instructions
Perform a search on Naver Local. (네이버 지역 검색)
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| display | No | Number of results to display (default: 1, max: 5) | |
| query | Yes | Search query | |
| sort | No | Sort method (random: accuracy, comment: review count) | |
| start | No | Start position of search results (default: 1, max: 1) |
Implementation Reference
- src/index.ts:237-250 (registration)Registration of the 'search_local' MCP tool, including description, input schema, and handler that delegates to searchToolHandlers and formats the response as MCP content.
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. 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); return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }], }; } ); - src/handlers/search.handlers.ts:92-97 (handler)Specific handler function for local search that invokes the NaverSearchClient's searchLocal method.
/** * 지역 검색 핸들러 */ export async function handleLocalSearch(params: NaverLocalSearchParams) { return client.searchLocal(params); } - src/schemas/search.schemas.ts:58-69 (schema)Zod input schema definition for the search_local tool parameters, extending the base SearchArgsSchema with local-specific fields.
// 지역 검색 파라미터 export const NaverLocalSearchParamsSchema = SearchArgsSchema.extend({ sort: z .enum(["random", "comment"]) .optional() .describe("정렬 방식 (random: 정확도순, comment: 리뷰 많은순)"), display: z.number().optional().describe("한 번에 가져올 결과 수 (최대 5)"), start: z.number().optional().describe("검색 시작 위치 (최대 1)"), }); export type NaverLocalSearchParams = z.infer< typeof NaverLocalSearchParamsSchema >; - Core helper function in NaverSearchClient that performs the actual HTTP GET request to the Naver local search API endpoint.
/** * 지역 검색 메서드 */ async searchLocal( params: NaverLocalSearchParams ): Promise<NaverLocalSearchResponse> { return this.get(`${this.searchBaseUrl}/local`, params); }