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

MCP 初心者？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"
      }
    }
  }
}