AI导哈

Naver搜索广告管理协议服务器

一个用于Naver搜索广告API的MCP服务器，可管理广告系列、广告组、广告、关键词并获取性能统计数据。

  • by packative
  • TypeScript
  • 本地部署
  • 5 星标
  • 更新于
在 GitHub 查看 packative/naver-searchad-mcp

使用说明

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

@包装/导航搜索广告mcp

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

学分

这个项目是 ND-SPACE/导航搜索广告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

配置

环境变量

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

变量 描述
NAVER_API_KEY 您的Naver SearchAd API密钥
NAVER_SIGN_KEY 用于签名请求的Naver SearchAd密钥
NAVER_CUSTOMER_ID 您的Naver广告商客户ID

权限模式

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

标志 模式 工具 描述
--ro 只读 26 仅列出、获取、统计和下载操作（默认）
--rw 读写 39 添加创建和更新操作
--rwd 读写删除 47 包括删除操作在内的完全访问权限

将标志作为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）

活动工具

工具 权限 描述
list_campaigns read 列出所有活动
get_campaign 阅读 获取特定活动的详细信息
create_campaign 编写 创建新活动
update_campaign write 更新活动（名称、预算、交付方式、暂停/启用）
delete_campaign delete 删除活动

广告组工具

工具 权限 描述
list_adgroups read 列出广告组，可选择按广告系列筛选
get_adgroup read 获取特定广告组的详细信息
create_adgroup write 在广告系列中创建新的广告组
update_adgroup 写 更新广告组（出价、预算、暂停/启用）
delete_adgroup delete 删除广告组

广告（创意）工具

工具 权限 描述
list_ads read 列出广告组中的所有广告
get_ad 阅读 获取特定广告的详细信息
create_ad write 在广告组中创建新广告
update_ad 写 更新广告（创意内容、暂停/启用）
delete_ad delete 删除广告

关键字工具

工具 权限 描述
list_keywords read 列出广告组中的所有关键字
get_keyword read 获取特定关键字的详细信息
create_keyword write 将关键字添加到广告组
update_keyword write 更新关键字（出价金额、暂停/启用）
delete_keyword delete 删除关键字

负面关键字工具

工具 权限 描述
list_negative_keywords read 列出广告组或广告系列的负面关键字
create_negative_keywords write 添加否定关键字（精确匹配或短语匹配）
delete_negative_keywords delete 按ID删除负面关键字

广告扩展工具

工具 权限 描述
list_ad_extensions read 列出广告组的广告扩展名
create_ad_extension write 创建广告扩展（站点链接、标注等）
delete_ad_extension delete 删除广告扩展名

统计工具

工具 权限 描述
get_stats read 获取性能统计数据（展示次数、点击次数、成本、转化率等）
get_campaign_stats read 获取所有活动的统计数据和活动详细信息
create_stat_report write 创建异步统计报告作业
get_stat_report read 检查异步报告作业的状态
download_stat_report read 下载完整的统计报告

可用指标： 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 （地区）

关键词研究和评标工具

工具 权限 描述
get_keyword_suggestions 阅读 利用搜索量、点击率和竞争数据获取关键字创意
get_estimate_performance read 估算给定出价金额下的展示次数、点击次数和成本
get_estimate_median_bid read 让中间出价出现在第一页

Bizmoney（预算）工具

工具 权限 描述
get_bizmoney read 获取当前账户余额
get_bizmoney_histories read 获取交易历史记录（费用、退款）
get_bizmoney_cost read 按日期获取成本明细

商业渠道工具

工具 权限 描述
list_channels read 列出所有业务渠道
get_channel read 获取特定频道的详细信息

标签工具

工具 权限 描述
list_labels read 列出所有标签
create_label write 创建标签（名称+颜色）
delete_label delete 删除标签

其他工具

工具 权限 描述
get_member_info read 获取帐户/会员信息
get_quality_index read 获取关键字质量分数和改进建议
list_ip_exclusions read 列出阻止点击欺诈的IP地址
create_ip_exclusion write 阻止IP地址
delete_ip_exclusion delete 取消阻止IP地址

使用示例

列出所有活动

"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 详细指南。

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

关于Packative

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

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

相关 MCP