datalab_shopping_keyword_by_gender
Analyze Naver Shopping keyword trends by gender to identify purchasing patterns. Input category, keyword, date range, and gender to generate insights for targeted marketing strategies.
Instructions
Perform a trend analysis on Naver Shopping keywords by gender. (네이버 쇼핑 키워드 성별 트렌드 분석)
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| category | Yes | Category code | |
| endDate | Yes | End date (yyyy-mm-dd) | |
| gender | Yes | Gender | |
| keyword | Yes | Search keyword | |
| startDate | Yes | Start date (yyyy-mm-dd) | |
| timeUnit | Yes | Time unit |
Implementation Reference
- src/handlers/datalab.handlers.ts:170-181 (handler)The main handler function that receives validated parameters, maps them to the API request format, and delegates to the Naver client for execution.
export async function handleShoppingKeywordByGenderTrend( params: DatalabShoppingKeywordGender ) { return client.datalabShoppingKeywordByGender({ startDate: params.startDate, endDate: params.endDate, timeUnit: params.timeUnit, category: params.category, keyword: params.keyword, gender: params.gender, }); } - src/schemas/datalab.schemas.ts:75-79 (schema)Zod schema defining the input parameters for the tool: category code, keyword, and gender.
export const DatalabShoppingKeywordGenderSchema = DatalabBaseSchema.extend({ category: z.string().describe("Category code"), keyword: z.string().describe("Search keyword"), gender: z.enum(["f", "m"]).describe("Gender"), }); - src/index.ts:392-406 (registration)Registers the MCP tool with name, description, input schema, and handler that calls the datalabToolHandlers dispatcher.
server.registerTool( "datalab_shopping_keyword_by_gender", { description: "👥🔍 Analyze keyword performance by gender within shopping categories. Use find_category first to get category codes. Essential for gender-targeted marketing and product positioning strategies. (쇼핑 키워드 성별 트렌드 - 먼저 find_category 도구로 카테고리 코드를 찾으세요)", inputSchema: DatalabShoppingKeywordGenderSchema.shape, }, async (args) => { const result = await datalabToolHandlers.datalab_shopping_keyword_by_gender(args); return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }], }; } ); - Client method that performs the actual HTTP POST request to the Naver DataLab API endpoint for shopping keyword trends by gender.
async datalabShoppingKeywordByGender( params: DatalabShoppingKeywordRequest ): Promise<DatalabShoppingResponse> { return this.post( `${this.datalabBaseUrl}/shopping/category/keyword/gender`, params ); }