datalab_shopping_keywords
Analyze shopping keyword trends on Naver to identify market insights and consumer behavior patterns within specific timeframes and categories.
Instructions
Perform a trend analysis on Naver Shopping keywords. (네이버 쇼핑 키워드별 트렌드 분석)
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| category | Yes | Category code | |
| endDate | Yes | End date (yyyy-mm-dd) | |
| keyword | Yes | Array of keyword name and value pairs | |
| startDate | Yes | Start date (yyyy-mm-dd) | |
| timeUnit | Yes | Time unit |
Implementation Reference
- src/handlers/datalab.handlers.ts:129-145 (handler)Handler function that executes the core logic for datalab_shopping_keywords tool by mapping parameters and calling the Naver client API.
/** * 쇼핑 키워드 트렌드 핸들러 (복수 키워드 그룹 지원) * 네이버 데이터랩 쇼핑 키워드 그룹 트렌드 분석 API 호출 * @param params DatalabShoppingKeywords */ export async function handleShoppingKeywordsTrend( params: DatalabShoppingKeywords ) { // 키워드 배열을 네이버 API에 맞는 형식으로 변환 return client.datalabShoppingKeywords({ startDate: params.startDate, endDate: params.endDate, timeUnit: params.timeUnit, category: params.category, keyword: params.keyword, }); } - src/schemas/datalab.schemas.ts:55-65 (schema)Zod schema defining input validation for the datalab_shopping_keywords tool parameters.
export const DatalabShoppingKeywordsSchema = DatalabBaseSchema.extend({ category: z.string().describe("Category code"), keyword: z .array( z.object({ name: z.string().describe("Keyword name"), param: z.array(z.string()).describe("Keyword values"), }) ) .describe("Array of keyword name and value pairs"), }); - src/index.ts:361-374 (registration)MCP tool registration for 'datalab_shopping_keywords' including description, input schema, and handler invocation.
server.registerTool( "datalab_shopping_keywords", { description: "🔍 Compare specific keywords within a shopping category. Use find_category first. BUSINESS CASES: Product keyword optimization, competitor analysis, search trend identification. EXAMPLE: Within '패션' category, compare '원피스' vs '자켓' vs '드레스' trends. For current keyword trends, use get_current_korean_time to set proper analysis period. (카테고리 내 키워드 비교 - 먼저 find_category 도구로 카테고리 코드를 찾고, 현재 키워드 트렌드 분석시 get_current_korean_time으로 적절한 분석 기간 설정)", inputSchema: DatalabShoppingKeywordsSchema.shape, }, async (args) => { const result = await datalabToolHandlers.datalab_shopping_keywords(args); return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }], }; } ); - Client method that makes the actual HTTP POST request to Naver DataLab API for shopping keywords trend analysis.
/** * 쇼핑 키워드 트렌드 분석 메서드 */ async datalabShoppingKeywords( params: DatalabShoppingKeywordsRequest ): Promise<DatalabShoppingResponse> { return this.post( `${this.datalabBaseUrl}/shopping/category/keywords`, params ); }