@packative/naver-searchad-mcp 1.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Provotive CO., Ltd
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,280 @@
+```
+ _   _                         _____                     _               _   __  __  _____ _____
+| \ | |                       / ____|                   | |             | | |  \/  |/ ____|  __ \
+|  \| | __ ___   _____ _ __  | (___   ___  __ _ _ __ ___| |__   __ _  __| | | \  / | |    | |__) |
+| . ` |/ _` \ \ / / _ \ '__|  \___ \ / _ \/ _` | '__/ __| '_ \ / _` |/ _` | | |\/| | |    |  ___/
+| |\  | (_| |\ V /  __/ |     ____) |  __/ (_| | | | (__| | | | (_| | (_| | | |  | | |____| |
+|_| \_|\__,_| \_/ \___|_|    |_____/ \___|\__,_|_|  \___|_| |_|\__,_|\__,_| |_|  |_|\_____|_|
+```
+
+# @packative/naver-searchad-mcp
+
+An MCP (Model Context Protocol) server for the Naver SearchAd API. Manage campaigns, ad groups, keywords, and retrieve performance statistics directly from Claude Desktop or any MCP-compatible client.
+
+## Credits
+
+This project is a fork of [ND-SPACE/naver-searchad-mcp](https://github.com/ND-SPACE/naver-searchad-mcp), extended with additional features and improvements by [Packative](https://packative.com).
+
+## Features
+
+- **Campaign Management**: List, create, and delete campaigns
+- **Ad Group Management**: List, get details, and create ad groups
+- **Keyword Management**: List and add keywords to ad groups
+- **Performance Statistics**: Retrieve detailed stats with flexible date ranges and breakdowns
+- **Active Campaign Filtering**: Automatically filters to show only active (ELIGIBLE) campaigns
+- **TypeScript**: Fully typed for better developer experience
+
+## Installation
+
+```bash
+npm install -g @packative/naver-searchad-mcp
+```
+
+Or with pnpm:
+
+```bash
+pnpm add -g @packative/naver-searchad-mcp
+```
+
+## Configuration
+
+### Environment Variables
+
+The server requires the following environment variables:
+
+| Variable | Description |
+|----------|-------------|
+| `NAVER_API_KEY` | Your Naver SearchAd API key |
+| `NAVER_SIGN_KEY` | Your Naver SearchAd secret key for signing requests |
+| `NAVER_CUSTOMER_ID` | Your Naver advertiser customer ID |
+
+### Claude Desktop Setup
+
+Add the following to your Claude Desktop configuration file:
+
+**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
+**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "naver-searchad": {
+      "command": "npx",
+      "args": ["-y", "@packative/naver-searchad-mcp"],
+      "env": {
+        "NAVER_API_KEY": "your-api-key",
+        "NAVER_SIGN_KEY": "your-secret-key",
+        "NAVER_CUSTOMER_ID": "your-customer-id"
+      }
+    }
+  }
+}
+```
+
+### Claude Code Setup
+
+Add to your Claude Code settings:
+
+```json
+{
+  "mcpServers": {
+    "naver-searchad": {
+      "command": "npx",
+      "args": ["-y", "@packative/naver-searchad-mcp"],
+      "env": {
+        "NAVER_API_KEY": "your-api-key",
+        "NAVER_SIGN_KEY": "your-secret-key",
+        "NAVER_CUSTOMER_ID": "your-customer-id"
+      }
+    }
+  }
+}
+```
+
+## Available Tools
+
+### Campaign Tools
+
+#### `list_campaigns`
+List all Naver SearchAd campaigns.
+
+#### `create_campaign`
+Create a new campaign.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `name` | string | Yes | Campaign name |
+| `campaignTp` | string | Yes | Campaign type (e.g., `WEB_SITE`, `SHOPPING`) |
+| `customerId` | string | No | Customer ID |
+| `dailyBudget` | number | No | Daily budget in KRW |
+| `deliveryMethod` | string | No | `STANDARD` or `ACCELERATED` |
+
+#### `delete_campaign`
+Delete a campaign.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `campaignId` | string | Yes | Campaign ID to delete |
+
+### Ad Group Tools
+
+#### `list_adgroups`
+List all ad groups, optionally filtered by campaign.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `campaignId` | string | No | Filter by campaign ID |
+
+#### `get_adgroup`
+Get details of a specific ad group.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `adgroupId` | string | Yes | Ad group ID |
+
+#### `create_adgroup`
+Create a new ad group.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `nccCampaignId` | string | Yes | Parent campaign ID |
+| `name` | string | Yes | Ad group name |
+| `pcChannelId` | string | No | PC channel ID |
+| `mobileChannelId` | string | No | Mobile channel ID |
+| `bidAmt` | number | No | Bid amount in KRW |
+
+### Keyword Tools
+
+#### `list_keywords`
+List all keywords in an ad group.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `adgroupId` | string | Yes | Ad group ID |
+
+#### `create_keyword`
+Add a keyword to an ad group.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `adgroupId` | string | Yes | Ad group ID |
+| `keyword` | string | Yes | Keyword text |
+| `bidAmt` | number | No | Bid amount in KRW |
+
+### Statistics Tools
+
+#### `get_stats`
+Get performance statistics for campaigns, ad groups, or keywords.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `id` | string | No | Single ID to query |
+| `ids` | array | No | Multiple IDs to query |
+| `fields` | array | No | Metrics to retrieve (default: `impCnt`, `clkCnt`, `salesAmt`, `ctr`, `cpc`, `ccnt`) |
+| `datePreset` | string | No | `today`, `yesterday`, `last7days`, `last30days`, `lastweek`, `lastmonth`, `lastquarter` |
+| `timeRange` | object | No | Custom date range with `since` and `until` (YYYY-MM-DD) |
+| `timeIncrement` | string | No | `1` (daily) or `allDays` (summary) |
+| `breakdown` | string | No | `pcMblTp` (device), `dayw` (day of week), `hh24` (hour), `regnNo` (region) |
+
+**Available metrics:**
+- `impCnt` - Impressions
+- `clkCnt` - Clicks
+- `salesAmt` - Cost/Spend
+- `ctr` - Click-through rate
+- `cpc` - Cost per click
+- `ccnt` - Conversions
+- `crto` - Conversion rate
+- `convAmt` - Conversion value
+- `ror` - Return on ad spend
+- `cpConv` - Cost per conversion
+- `avgRnk` - Average rank
+
+#### `get_campaign_stats`
+Get performance statistics for all active campaigns.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `startDate` | string | No | Start date (YYYY-MM-DD) |
+| `endDate` | string | No | End date (YYYY-MM-DD) |
+| `datePreset` | string | No | Use preset instead of custom dates |
+
+## Usage Examples
+
+### List all campaigns
+```
+"Show me all my Naver SearchAd campaigns"
+```
+
+### Get campaign performance
+```
+"What's the performance of my Naver campaigns for the last 30 days?"
+```
+
+### Create a new campaign
+```
+"Create a new Naver SearchAd campaign called 'Summer Sale' with type WEB_SITE"
+```
+
+### Get keyword statistics
+```
+"Show me the click-through rate for my keywords in the last week"
+```
+
+## Getting API Credentials
+
+1. Log in to [Naver SearchAd](https://searchad.naver.com/)
+2. Go to Tools > API Management
+3. Create a new API key
+4. Note your API Key, Secret Key, and Customer ID
+
+For detailed API documentation, see the [Official Naver SearchAd API Documentation](https://naver.github.io/searchad-apidoc/#/guides).
+
+## Development
+
+```bash
+# Install dependencies
+pnpm install
+
+# Run tests
+pnpm test
+
+# Run tests in watch mode
+pnpm test:watch
+
+# Run tests with coverage
+pnpm test:coverage
+
+# Type check
+pnpm typecheck
+
+# Build
+pnpm build
+```
+
+## Requirements
+
+- Node.js 18 or higher
+- Naver SearchAd API credentials
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details.
+
+## Contributing
+
+We use [Conventional Commits](https://www.conventionalcommits.org/) for automatic versioning and changelog generation.
+
+- **`development`** branch for ongoing work
+- **`master`** branch is protected - merging triggers automatic releases
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for detailed guidelines.
+
+Issues and pull requests are welcome on [GitHub](https://github.com/packative/naver-searchad-mcp).
+
+---
+
+### About Packative
+
+[Packative](https://packative.com) is a Korean packaging e-commerce platform that helps businesses find and order custom packaging solutions. We build tools to streamline our marketing operations and share them with the community.
+
+This MCP server is part of our marketing automation toolkit, enabling AI-assisted management of Naver SearchAd campaigns.

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,435 @@
+#!/usr/bin/env node
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { fetchWithAuth } from "./utils/fetchWithAuth.js";
+const server = new Server({
+    name: "@packative/naver-searchad-mcp",
+    version: "1.0.0",
+}, {
+    capabilities: {
+        tools: {},
+    },
+});
+// Define all tools
+const tools = [
+    {
+        name: "list_campaigns",
+        description: "List all Naver SearchAd campaigns",
+        inputSchema: {
+            type: "object",
+            properties: {},
+            required: [],
+        },
+    },
+    {
+        name: "create_campaign",
+        description: "Create a new Naver SearchAd campaign",
+        inputSchema: {
+            type: "object",
+            properties: {
+                name: {
+                    type: "string",
+                    description: "Campaign name",
+                },
+                campaignTp: {
+                    type: "string",
+                    description: "Campaign type (e.g., WEB_SITE, SHOPPING)",
+                },
+                customerId: {
+                    type: "string",
+                    description: "Customer ID",
+                },
+                dailyBudget: {
+                    type: "number",
+                    description: "Daily budget in KRW",
+                },
+                deliveryMethod: {
+                    type: "string",
+                    description: "Delivery method (STANDARD or ACCELERATED)",
+                },
+            },
+            required: ["name", "campaignTp"],
+        },
+    },
+    {
+        name: "delete_campaign",
+        description: "Delete a Naver SearchAd campaign",
+        inputSchema: {
+            type: "object",
+            properties: {
+                campaignId: {
+                    type: "string",
+                    description: "Campaign ID to delete",
+                },
+            },
+            required: ["campaignId"],
+        },
+    },
+    {
+        name: "list_adgroups",
+        description: "List all ad groups, optionally filtered by campaign",
+        inputSchema: {
+            type: "object",
+            properties: {
+                campaignId: {
+                    type: "string",
+                    description: "Optional: Campaign ID to filter ad groups",
+                },
+            },
+            required: [],
+        },
+    },
+    {
+        name: "get_adgroup",
+        description: "Get details of a specific ad group",
+        inputSchema: {
+            type: "object",
+            properties: {
+                adgroupId: {
+                    type: "string",
+                    description: "Ad group ID",
+                },
+            },
+            required: ["adgroupId"],
+        },
+    },
+    {
+        name: "create_adgroup",
+        description: "Create a new ad group within a campaign",
+        inputSchema: {
+            type: "object",
+            properties: {
+                nccCampaignId: {
+                    type: "string",
+                    description: "Campaign ID to create ad group in",
+                },
+                name: {
+                    type: "string",
+                    description: "Ad group name",
+                },
+                pcChannelId: {
+                    type: "string",
+                    description: "PC channel ID",
+                },
+                mobileChannelId: {
+                    type: "string",
+                    description: "Mobile channel ID",
+                },
+                bidAmt: {
+                    type: "number",
+                    description: "Bid amount in KRW",
+                },
+            },
+            required: ["nccCampaignId", "name"],
+        },
+    },
+    {
+        name: "list_keywords",
+        description: "List all keywords in an ad group",
+        inputSchema: {
+            type: "object",
+            properties: {
+                adgroupId: {
+                    type: "string",
+                    description: "Ad group ID",
+                },
+            },
+            required: ["adgroupId"],
+        },
+    },
+    {
+        name: "create_keyword",
+        description: "Add a keyword to an ad group",
+        inputSchema: {
+            type: "object",
+            properties: {
+                adgroupId: {
+                    type: "string",
+                    description: "Ad group ID",
+                },
+                keyword: {
+                    type: "string",
+                    description: "Keyword text",
+                },
+                bidAmt: {
+                    type: "number",
+                    description: "Bid amount in KRW",
+                },
+            },
+            required: ["adgroupId", "keyword"],
+        },
+    },
+    {
+        name: "get_stats",
+        description: "Get performance statistics for campaigns, ad groups, or keywords. Returns impressions, clicks, cost, conversions, etc.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                id: {
+                    type: "string",
+                    description: "Single ID (campaign, adgroup, or keyword ID)",
+                },
+                ids: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Multiple IDs to query at once",
+                },
+                fields: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Metrics to retrieve: impCnt, clkCnt, salesAmt, ctr, cpc, ccnt, crto, convAmt, ror, cpConv, avgRnk",
+                },
+                datePreset: {
+                    type: "string",
+                    description: "Predefined date range: today, yesterday, last7days, last30days, lastweek, lastmonth, lastquarter",
+                },
+                timeRange: {
+                    type: "object",
+                    properties: {
+                        since: { type: "string", description: "Start date (YYYY-MM-DD)" },
+                        until: { type: "string", description: "End date (YYYY-MM-DD)" },
+                    },
+                    description: "Custom date range (use instead of datePreset)",
+                },
+                timeIncrement: {
+                    type: "string",
+                    description: "Time granularity: 1 (daily) or allDays (summary)",
+                },
+                breakdown: {
+                    type: "string",
+                    description: "Breakdown dimension: pcMblTp (device), dayw (day of week), hh24 (hour), regnNo (region)",
+                },
+            },
+            required: [],
+        },
+    },
+    {
+        name: "get_campaign_stats",
+        description: "Get performance statistics for all active campaigns",
+        inputSchema: {
+            type: "object",
+            properties: {
+                startDate: {
+                    type: "string",
+                    description: "Start date (YYYY-MM-DD)",
+                },
+                endDate: {
+                    type: "string",
+                    description: "End date (YYYY-MM-DD)",
+                },
+                datePreset: {
+                    type: "string",
+                    description: "Or use preset: today, yesterday, last7days, last30days, lastweek, lastmonth, lastquarter",
+                },
+            },
+            required: [],
+        },
+    },
+];
+// Handle list tools request
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+    return { tools };
+});
+// Handle tool calls
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args = {} } = request.params;
+    try {
+        let result;
+        switch (name) {
+            case "list_campaigns": {
+                const response = await fetchWithAuth("/ncc/campaigns");
+                result = response.data;
+                break;
+            }
+            case "create_campaign": {
+                const typedArgs = args;
+                const campaign = {
+                    name: typedArgs.name,
+                    campaignTp: typedArgs.campaignTp,
+                    customerId: typedArgs.customerId,
+                    dailyBudget: typedArgs.dailyBudget,
+                    deliveryMethod: typedArgs.deliveryMethod,
+                };
+                const response = await fetchWithAuth("/ncc/campaigns", "POST", campaign);
+                result = response.data;
+                break;
+            }
+            case "delete_campaign": {
+                const typedArgs = args;
+                const response = await fetchWithAuth(`/ncc/campaigns/${typedArgs.campaignId}`, "DELETE");
+                result = response.data;
+                break;
+            }
+            case "list_adgroups": {
+                const typedArgs = args;
+                const endpoint = typedArgs.campaignId
+                    ? `/ncc/adgroups?nccCampaignId=${typedArgs.campaignId}`
+                    : `/ncc/adgroups`;
+                const response = await fetchWithAuth(endpoint);
+                result = response.data;
+                break;
+            }
+            case "get_adgroup": {
+                const typedArgs = args;
+                const response = await fetchWithAuth(`/ncc/adgroups/${typedArgs.adgroupId}`);
+                result = response.data;
+                break;
+            }
+            case "create_adgroup": {
+                const typedArgs = args;
+                const adgroup = {
+                    nccCampaignId: typedArgs.nccCampaignId,
+                    name: typedArgs.name,
+                    pcChannelId: typedArgs.pcChannelId,
+                    mobileChannelId: typedArgs.mobileChannelId,
+                    bidAmt: typedArgs.bidAmt,
+                };
+                const response = await fetchWithAuth("/ncc/adgroups", "POST", adgroup);
+                result = response.data;
+                break;
+            }
+            case "list_keywords": {
+                const typedArgs = args;
+                const response = await fetchWithAuth(`/ncc/keywords?nccAdgroupId=${typedArgs.adgroupId}`);
+                result = response.data;
+                break;
+            }
+            case "create_keyword": {
+                const typedArgs = args;
+                const keyword = {
+                    keyword: typedArgs.keyword,
+                    bidAmt: typedArgs.bidAmt,
+                };
+                const response = await fetchWithAuth(`/ncc/keywords?nccAdgroupId=${typedArgs.adgroupId}`, "POST", keyword);
+                result = response.data;
+                break;
+            }
+            case "get_stats": {
+                const typedArgs = args;
+                const params = new URLSearchParams();
+                if (typedArgs.id) {
+                    params.append("id", typedArgs.id);
+                }
+                if (typedArgs.ids && typedArgs.ids.length > 0) {
+                    params.append("ids", JSON.stringify(typedArgs.ids));
+                }
+                // Fields - default to common metrics
+                const fields = typedArgs.fields || [
+                    "impCnt",
+                    "clkCnt",
+                    "salesAmt",
+                    "ctr",
+                    "cpc",
+                    "ccnt",
+                ];
+                params.append("fields", JSON.stringify(fields));
+                // Date range
+                if (typedArgs.timeRange) {
+                    params.append("timeRange", JSON.stringify(typedArgs.timeRange));
+                }
+                else if (typedArgs.datePreset) {
+                    params.append("datePreset", typedArgs.datePreset);
+                }
+                else {
+                    params.append("datePreset", "last30days");
+                }
+                // Time increment
+                params.append("timeIncrement", typedArgs.timeIncrement || "allDays");
+                // Breakdown
+                if (typedArgs.breakdown) {
+                    params.append("breakdown", typedArgs.breakdown);
+                }
+                const response = await fetchWithAuth(`/stats?${params.toString()}`);
+                result = response.data;
+                break;
+            }
+            case "get_campaign_stats": {
+                const typedArgs = args;
+                // First get all campaigns
+                const campaignsResponse = await fetchWithAuth("/ncc/campaigns");
+                const campaigns = campaignsResponse.data;
+                // Filter to ELIGIBLE campaigns only
+                const activeCampaigns = campaigns.filter((c) => c.status === "ELIGIBLE");
+                const campaignIds = activeCampaigns.map((c) => c.nccCampaignId);
+                if (campaignIds.length === 0) {
+                    result = { message: "No active campaigns found", campaigns: [] };
+                    break;
+                }
+                // Build stats query
+                const params = new URLSearchParams();
+                params.append("ids", JSON.stringify(campaignIds));
+                params.append("fields", JSON.stringify([
+                    "impCnt",
+                    "clkCnt",
+                    "salesAmt",
+                    "ctr",
+                    "cpc",
+                    "ccnt",
+                    "crto",
+                    "convAmt",
+                ]));
+                if (typedArgs.startDate && typedArgs.endDate) {
+                    params.append("timeRange", JSON.stringify({
+                        since: typedArgs.startDate,
+                        until: typedArgs.endDate,
+                    }));
+                }
+                else if (typedArgs.datePreset) {
+                    params.append("datePreset", typedArgs.datePreset);
+                }
+                else {
+                    params.append("datePreset", "last30days");
+                }
+                params.append("timeIncrement", "allDays");
+                const statsResponse = await fetchWithAuth(`/stats?${params.toString()}`);
+                // Merge campaign info with stats
+                const statsMap = {};
+                if (Array.isArray(statsResponse.data)) {
+                    statsResponse.data.forEach((stat) => {
+                        statsMap[stat.id] = stat;
+                    });
+                }
+                result = activeCampaigns.map((campaign) => ({
+                    ...campaign,
+                    stats: statsMap[campaign.nccCampaignId] || null,
+                }));
+                break;
+            }
+            default:
+                throw new Error(`Unknown tool: ${name}`);
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(result, null, 2),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        const err = error;
+        const errorMessage = err.response?.data?.message || err.message;
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Error: ${errorMessage}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+});
+// Start the server
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("Naver SearchAd MCP server running on stdio");
+}
+main().catch((error) => {
+    console.error("Server error:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,106 @@
+import type { AxiosResponse } from "axios";
+export interface Campaign {
+    nccCampaignId: string;
+    customerId: number;
+    name: string;
+    campaignTp: string;
+    deliveryMethod: string;
+    trackingMode: string;
+    dailyBudget: number;
+    useDailyBudget: boolean;
+    status: "ELIGIBLE" | "PAUSED" | "SUSPENDED" | "DELETED";
+    statusReason: string;
+    regTm: string;
+    editTm: string;
+}
+export interface AdGroup {
+    nccAdgroupId: string;
+    nccCampaignId: string;
+    customerId: number;
+    name: string;
+    pcChannelId?: string;
+    mobileChannelId?: string;
+    bidAmt: number;
+    status: string;
+    regTm: string;
+    editTm: string;
+}
+export interface Keyword {
+    nccKeywordId: string;
+    nccAdgroupId: string;
+    customerId: number;
+    keyword: string;
+    bidAmt: number;
+    status: string;
+    regTm: string;
+    editTm: string;
+}
+export interface Stats {
+    id: string;
+    impCnt?: number;
+    clkCnt?: number;
+    salesAmt?: number;
+    ctr?: number;
+    cpc?: number;
+    ccnt?: number;
+    crto?: number;
+    convAmt?: number;
+    ror?: number;
+    cpConv?: number;
+    avgRnk?: number;
+}
+export interface CampaignWithStats extends Campaign {
+    stats: Stats | null;
+}
+export interface CreateCampaignArgs {
+    name: string;
+    campaignTp: string;
+    customerId?: string;
+    dailyBudget?: number;
+    deliveryMethod?: string;
+}
+export interface DeleteCampaignArgs {
+    campaignId: string;
+}
+export interface ListAdgroupsArgs {
+    campaignId?: string;
+}
+export interface GetAdgroupArgs {
+    adgroupId: string;
+}
+export interface CreateAdgroupArgs {
+    nccCampaignId: string;
+    name: string;
+    pcChannelId?: string;
+    mobileChannelId?: string;
+    bidAmt?: number;
+}
+export interface ListKeywordsArgs {
+    adgroupId: string;
+}
+export interface CreateKeywordArgs {
+    adgroupId: string;
+    keyword: string;
+    bidAmt?: number;
+}
+export interface TimeRange {
+    since: string;
+    until: string;
+}
+export interface GetStatsArgs {
+    id?: string;
+    ids?: string[];
+    fields?: string[];
+    datePreset?: string;
+    timeRange?: TimeRange;
+    timeIncrement?: string;
+    breakdown?: string;
+}
+export interface GetCampaignStatsArgs {
+    startDate?: string;
+    endDate?: string;
+    datePreset?: string;
+}
+export type HttpMethod = "GET" | "POST" | "PUT" | "DELETE";
+export type ApiResponse<T = unknown> = AxiosResponse<T>;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAG3C,MAAM,WAAW,QAAQ;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,OAAO,CAAC;IACxB,MAAM,EAAE,UAAU,GAAG,QAAQ,GAAG,WAAW,GAAG,SAAS,CAAC;IACxD,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,OAAO;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,OAAO;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAkB,SAAQ,QAAQ;IACjD,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACrB;AAGD,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,oBAAoB;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAGD,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,CAAC;AAG3D,MAAM,MAAM,WAAW,CAAC,CAAC,GAAG,OAAO,IAAI,aAAa,CAAC,CAAC,CAAC,CAAC"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/utils/fetchWithAuth.d.ts

@@ -0,0 +1,6 @@
+import type { HttpMethod, ApiResponse } from "../types.js";
+/**
+ * Make authenticated request to Naver SearchAd API
+ */
+export declare function fetchWithAuth<T = unknown>(path: string, method?: HttpMethod, data?: unknown): Promise<ApiResponse<T>>;
+//# sourceMappingURL=fetchWithAuth.d.ts.map

package/dist/utils/fetchWithAuth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetchWithAuth.d.ts","sourceRoot":"","sources":["../../src/utils/fetchWithAuth.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAmB3D;;GAEG;AACH,wBAAsB,aAAa,CAAC,CAAC,GAAG,OAAO,EAC7C,IAAI,EAAE,MAAM,EACZ,MAAM,GAAE,UAAkB,EAC1B,IAAI,GAAE,OAAc,GACnB,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CA0BzB"}

package/dist/utils/fetchWithAuth.js

@@ -0,0 +1,38 @@
+import axios from "axios";
+import crypto from "crypto";
+const NAVER_API_BASE_URL = "https://api.naver.com";
+/**
+ * Generate HMAC-SHA256 signature for Naver API authentication
+ */
+function generateSignature(timestamp, method, path, secretKey) {
+    const message = `${timestamp}.${method}.${path}`;
+    const hmac = crypto.createHmac("sha256", secretKey);
+    hmac.update(message);
+    return hmac.digest("base64");
+}
+/**
+ * Make authenticated request to Naver SearchAd API
+ */
+export async function fetchWithAuth(path, method = "GET", data = null) {
+    const apiKey = process.env.NAVER_API_KEY;
+    const secretKey = process.env.NAVER_SIGN_KEY;
+    const customerId = process.env.NAVER_CUSTOMER_ID;
+    if (!apiKey || !secretKey || !customerId) {
+        throw new Error(`Missing environment variables: NAVER_API_KEY=${!!apiKey}, NAVER_SIGN_KEY=${!!secretKey}, NAVER_CUSTOMER_ID=${!!customerId}`);
+    }
+    const timestamp = Date.now().toString();
+    const signature = generateSignature(timestamp, method, path, secretKey);
+    return axios({
+        method,
+        url: `${NAVER_API_BASE_URL}${path}`,
+        headers: {
+            "X-API-KEY": apiKey,
+            "X-Customer": customerId,
+            "X-Timestamp": timestamp,
+            "X-Signature": signature,
+            "Content-Type": "application/json",
+        },
+        data,
+    });
+}
+//# sourceMappingURL=fetchWithAuth.js.map

package/dist/utils/fetchWithAuth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetchWithAuth.js","sourceRoot":"","sources":["../../src/utils/fetchWithAuth.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,MAAM,MAAM,QAAQ,CAAC;AAG5B,MAAM,kBAAkB,GAAG,uBAAuB,CAAC;AAEnD;;GAEG;AACH,SAAS,iBAAiB,CACxB,SAAiB,EACjB,MAAc,EACd,IAAY,EACZ,SAAiB;IAEjB,MAAM,OAAO,GAAG,GAAG,SAAS,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC;IACjD,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IACpD,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACrB,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,IAAY,EACZ,SAAqB,KAAK,EAC1B,OAAgB,IAAI;IAEpB,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;IACzC,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;IAC7C,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;IAEjD,IAAI,CAAC,MAAM,IAAI,CAAC,SAAS,IAAI,CAAC,UAAU,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CACb,gDAAgD,CAAC,CAAC,MAAM,oBAAoB,CAAC,CAAC,SAAS,uBAAuB,CAAC,CAAC,UAAU,EAAE,CAC7H,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC;IACxC,MAAM,SAAS,GAAG,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;IAExE,OAAO,KAAK,CAAI;QACd,MAAM;QACN,GAAG,EAAE,GAAG,kBAAkB,GAAG,IAAI,EAAE;QACnC,OAAO,EAAE;YACP,WAAW,EAAE,MAAM;YACnB,YAAY,EAAE,UAAU;YACxB,aAAa,EAAE,SAAS;YACxB,aAAa,EAAE,SAAS;YACxB,cAAc,EAAE,kBAAkB;SACnC;QACD,IAAI;KACL,CAAC,CAAC;AACL,CAAC"}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@packative/naver-searchad-mcp",
+  "version": "1.2.0",
+  "type": "module",
+  "description": "MCP server for Naver SearchAd API - manage campaigns, ad groups, keywords, and retrieve performance statistics",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "naver-searchad-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist/"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "prepublishOnly": "pnpm run build",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": [
+    "claude",
+    "mcp",
+    "model-context-protocol",
+    "naver",
+    "searchad",
+    "advertising",
+    "ppc",
+    "korea"
+  ],
+  "author": "Provotive Co., Ltd",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/packative/naver-searchad-mcp"
+  },
+  "homepage": "https://github.com/packative/naver-searchad-mcp#readme",
+  "bugs": {
+    "url": "https://github.com/packative/naver-searchad-mcp/issues"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.25.2",
+    "axios": "^1.7.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@vitest/coverage-v8": "^2.1.0",
+    "typescript": "^5.7.0",
+    "vitest": "^2.1.0"
+  }
+}