search_image
Search and retrieve images from Naver using a query with options to filter by sort method, display count, and start position.
Instructions
Perform a search on Naver Image. (네이버 이미지 검색)
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| display | No | Number of results to display (default: 10) | |
| query | Yes | Search query | |
| sort | No | Sort method (sim: similarity, date: date) | |
| start | No | Start position of search results (default: 1) |
Implementation Reference
- src/handlers/search.handlers.ts:78-83 (handler)The core handler function for search_image tool that performs the actual Naver image search using the NaverSearchClient.
/** * 이미지 검색 핸들러 */ export async function handleImageSearch(params: SearchArgs) { return client.search("image", params); } - src/schemas/search.schemas.ts:33-41 (schema)Input schema (SearchArgsSchema) used for validating parameters to the search_image tool, including query, display count, start position, and sort order.
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: 날짜순)"), }); - src/index.ts:162-175 (registration)MCP server registration of the 'search_image' tool, specifying description, input schema, and handler that delegates to searchToolHandlers.search_image.
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. 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); return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }], }; } ); - Wrapper function in searchToolHandlers that logs args, validates with schema, and delegates to the handleImageSearch handler.
search_image: (args) => { console.error("search_image called with args:", JSON.stringify(args, null, 2)); return handleImageSearch(SearchArgsSchema.parse(args)); },