packative/naver-searchad-mcp

本页由 AI 翻译，技术细节请以原文为准。查看原文

5 stars 3 forks 质量 75 趋势 17MIT

概览

An MCP (Model Context Protocol) server for the Naver SearchAd API. Manage campaigns, ad groups, ads, keywords, and retrieve performance statistics directly from Claude Desktop or any MCP-compatible client. This project is a fork of ND-SPACE/naver-searchad-mcp, extended with additional features and improvements by Packative. - covering the full Naver SearchAd API - : List, get, create, update, and delete campaigns - : Full CRUD for ad groups - : List, get, create, update, and delete ads - : Full CRUD for keywords - : Manage negative keywords at campaign or ad group level - : Manage sitelinks, callouts, and other ad extensions - : Get keyword suggestions, search volume, and bid estimates - : Detailed stats with flexible date ranges, breakdowns, and async reports - : Check account balance, transaction history, and cost breakdowns - : Organize campaigns, ad groups, and other entities - : List and inspect business channels - : Member info, keyword quality index, IP exclusions - : --ro,...

README

以下为原文 README 节选，完整内容请查看原文。

 _   _                         _____                     _               _   __  __  _____ _____
| \ | |                       / ____|                   | |             | | |  \/  |/ ____|  __ \
|  \| | __ ___   _____ _ __  | (___   ___  __ _ _ __ ___| |__   __ _  __| | | \  / | |    | |__) |
| . ` |/ _` \ \ / / _ \ '__|  \___ \ / _ \/ _` | '__/ __| '_ \ / _` |/ _` | | |\/| | |    |  ___/
| |\  | (_| |\ V /  __/ |     ____) |  __/ (_| | | | (__| | | | (_| | (_| | | |  | | |____| |
|_| \_|\__,_| \_/ \___|_|    |_____/ \___|\__,_|_|  \___|_| |_|\__,_|\__,_| |_|  |_|\_____|_|

@packative/naver-searchad-mcp

Credits

This project is a fork of ND-SPACE/naver-searchad-mcp, extended with additional features and improvements by Packative.

Features

47 Tools covering the full Naver SearchAd API
Campaign Management: List, get, create, update, and delete campaigns
Ad Group Management: Full CRUD for ad groups
Ad/Creative Management: List, get, create, update, and delete ads
Keyword Management: Full CRUD for keywords
Negative Keywords: Manage negative keywords at campaign or ad group level
Ad Extensions: Manage sitelinks, callouts, and other ad extensions
Keyword Tool: Get keyword suggestions, search volume, and bid estimates
Performance Statistics: Detailed stats with flexible date ranges, breakdowns, and async reports
Bizmoney/Budget: Check account balance, transaction history, and cost breakdowns
Labels: Organize campaigns, ad groups, and other entities
Business Channels: List and inspect business channels
Account & Quality: Member info, keyword quality index, IP exclusions
Permission Modes: --ro, --rw, --rwd flags to control access (read-only by default)
TypeScript: Fully typed with modular architecture

Installation

npm install -g @packative/naver-searchad-mcp

Or with pnpm:

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

Permission Modes

The server supports three permission modes to protect against accidental destructive operations. The default is read-only.

Flag	Mode	Tools	Description
`--ro`	Read-only	26	List, get, stats, and download operations only (default)
`--rw`	Read-write	39	Adds create and update operations

在 GitHub 查看完整 README

安装

npx -y @packative/naver-searchad-mcp --rw

新手？先看 mcpskill.org 教程 →

配置

{
  "mcpServers": {
    "naver-searchad": {
      "command": "npx",
      "args": ["-y", "@packative/naver-searchad-mcp", "--rw"],
      "env": {
        "NAVER_API_KEY": "your-api-key",
        "NAVER_SIGN_KEY": "your-secret-key",
        "NAVER_CUSTOMER_ID": "your-customer-id"
      }
    }
  }
}