search_shop
Search for products on Naver Shopping by entering a query, sorting results by relevance or date, and customizing the number and start position of displayed results for targeted shopping inquiries.
Instructions
Perform a search on Naver Shopping. (네이버 쇼핑 검색)
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: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); }
- 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: 날짜순)"), });