Naver Searchad MCP

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

@包装/导航搜索广告mcp

用于Naver SearchAd API的MCP（模型上下文协议）服务器。管理活动、广告组、广告、关键字，并直接从Claude Desktop或任何兼容MCP的客户端检索性能统计数据。

学分

特性

• 47工具 涵盖整个Naver SearchAd API
• 活动管理：列出、获取、创建、更新和删除活动
• 广告组管理：广告组的完整CRUD
• 广告/创意管理：列出、获取、创建、更新和删除广告
• 关键字管理：关键字的完整CRUD
• 否定关键词：在活动或广告组级别管理负面关键字
• 广告扩展：管理网站链接、标注和其他广告扩展
• 关键字工具：获取关键字建议、搜索量和出价估算
• 性能统计数据：具有灵活日期范围、细分和异步报告的详细统计数据
• 商业货币/预算：检查账户余额、交易历史和成本明细
• 标签：组织活动、广告组和其他实体
• 商业渠道：列出并检查业务渠道
• 账户与质量：会员信息、关键字质量指数、IP排除
• 权限模式: --ro, --rw, --rwd 控制访问的标志（默认情况下为只读）
• TypeScript：完全类型化，采用模块化架构

安装

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

或者使用pnpm：

pnpm add -g @packative/naver-searchad-mcp

配置

环境变量

服务器需要以下环境变量：

权限模式

服务器支持三种权限模式，以防止意外的破坏性操作。 默认设置为只读。

将标志作为CLI参数传递：

# Read-only (default, safest)
naver-searchad-mcp

# Allow creating and updating
naver-searchad-mcp --rw

# Full access including deletes
naver-searchad-mcp --rwd

如果调用了当前权限模式不允许的工具，服务器将返回一条明确的错误消息，指示需要哪种模式。

Claude桌面设置

将以下内容添加到您的Claude Desktop配置文件中：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json 视窗: %APPDATA%\Claude\claude_desktop_config.json

{
  "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"
      }
    }
  }
}

Claude代码设置

添加到您的克劳德代码设置中：

{
  "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"
      }
    }
  }
}

可用工具（47）

活动工具

广告组工具

广告（创意）工具

关键字工具

负面关键字工具

广告扩展工具

统计工具

可用指标： impCnt （印象）， clkCnt （点击）， salesAmt （成本）， ctr （CTR）， cpc （CPC）， ccnt （转换）， crto （转换率）， convAmt （转换值）， ror （ROAS） cpConv （每次转换的成本）， avgRnk （平均排名）

预设日期： today, yesterday, last7days, last30days, lastweek, lastmonth, lastquarter

故障： pcMblTp （设备）， dayw （星期几）， hh24 （小时）， regnNo （地区）

关键词研究和评标工具

Bizmoney（预算）工具

商业渠道工具

标签工具

其他工具

使用示例

列出所有活动

"Show me all my Naver SearchAd campaigns"

获得活动绩效

"What's the performance of my Naver campaigns for the last 30 days?"

创建新活动

"Create a new Naver SearchAd campaign called 'Summer Sale' with type WEB_SITE"

关键词研究

"Find keyword suggestions for '패키지 디자인' with search volume data"

检查账户余额

"What's my current Naver SearchAd budget balance?"

获取关键字统计信息

"Show me the click-through rate for my keywords in the last week"

正在获取API凭据

1. 登录 Naver搜索广告
2. 前往“工具”>“API管理”
3. 创建新的API密钥
4. 注意您的API密钥、密钥和客户ID

有关API的详细文档，请参阅 官方Naver搜索广告API文档.

发展

# 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

项目结构

src/
  index.ts                  # Server setup, permission mode, tool registration
  types/
    common.ts               # Shared types (ToolDefinition, AccessLevel, PermissionMode)
    campaigns.ts            # Campaign types
    adgroups.ts             # Ad group types
    keywords.ts             # Keyword types
    ads.ts                  # Ad/creative types
    stats.ts                # Stats & report types
    channels.ts             # Channel types
    bizmoney.ts             # Bizmoney types
    keyword-tool.ts         # Keyword suggestion & estimate types
    ad-extensions.ts        # Ad extension types
    negative-keywords.ts    # Negative keyword types
    labels.ts               # Label types
    misc.ts                 # Member, quality index, IP exclusion types
  tools/
    campaigns.ts            # Campaign tool definitions & handlers
    adgroups.ts             # Ad group tools
    keywords.ts             # Keyword tools
    ads.ts                  # Ad/creative tools
    stats.ts                # Stats & report tools
    channels.ts             # Channel tools
    bizmoney.ts             # Bizmoney tools
    keyword-tool.ts         # Keyword research & bid estimate tools
    ad-extensions.ts        # Ad extension tools
    negative-keywords.ts    # Negative keyword tools
    labels.ts               # Label tools
    misc.ts                 # Member, quality index, IP exclusion tools
  utils/
    fetchWithAuth.ts        # Authenticated HTTP client (HMAC-SHA256)

需求

• Node.js 18或更高版本
• Naver搜索广告API凭证

许可证

MIT许可证-请参阅 许可证 了解详情。

贡献

我们使用 常规承诺 用于自动版本控制和变更日志生成。

• development 正在进行的工作分支
• master 分支受到保护-合并会触发自动释放

看 贡献.md 详细指南。

欢迎发布问题和拉取请求 .

______________________________________________________________________

关于Packative

包装 是一个韩国包装电子商务平台，帮助企业寻找和订购定制包装解决方案。我们构建工具来简化我们的营销运营，并与社区分享。

此MCP服务器是我们营销自动化工具包的一部分，可实现Naver SearchAd活动的人工智能辅助管理。