Naver Searchad MCP

一个用于Naver搜索广告API的MCP服务器，提供47个工具管理广告活动、广告组、关键词和性能统计，支持只读、读写和读写删除三种权限模式。

营销人工智能聊天机器人 #广告管理 #搜索广告 #API工具 #性能统计 .TypeScript

评分 : 2.5分

下载量 : 6.5K

更新时间 : 2026-03-13

打开站点

什么是Naver SearchAd MCP服务器?

这是一个连接AI助手（如Claude）与Naver搜索广告平台的桥梁工具。它允许您通过简单的对话指令来管理您的Naver广告账户，包括查看广告表现、调整预算、添加关键词、创建新广告等操作。传统上，管理广告需要登录复杂的广告后台界面，而通过这个MCP服务器，您可以直接告诉AI助手您的需求，它会自动帮您执行相应的操作。

如何使用Naver SearchAd MCP服务器?

使用过程非常简单： 1. 安装MCP服务器并配置您的Naver广告API凭证 2. 在Claude Desktop或Claude Code中配置服务器连接 3. 开始用自然语言与Claude对话来管理广告例如，您可以说“查看我上周的广告表现”或“为夏季促销活动创建一个新广告”，Claude会使用这个MCP服务器来执行您的指令。

适用场景

这个工具特别适合： • 广告运营人员：快速查看广告数据，无需频繁登录后台 • 营销经理：通过对话快速调整广告策略 • 中小企业主：简化广告管理流程，用自然语言操作 • 数据分析师：快速获取广告表现数据进行分析 • 代理商：同时管理多个客户账户，提高效率

主要功能

广告活动管理

完整管理广告活动：查看列表、获取详情、创建新活动、更新设置（名称、预算、投放方式）、暂停/启用、删除活动

广告组管理

管理广告组：查看所有广告组、获取详情、创建新广告组、更新出价和预算、删除广告组

关键词管理

全面管理关键词：查看关键词列表、获取详情、添加新关键词、调整出价、暂停/启用、删除关键词

广告创意管理

管理广告内容：查看广告列表、获取详情、创建新广告、更新广告文案和图片、删除广告

效果数据分析

查看详细广告表现：展示量、点击量、花费、点击率、转化率、ROAS等指标，支持按设备、时间、地区细分

关键词研究工具

获取关键词建议、搜索量数据、竞争程度分析、出价估算，帮助优化关键词策略

预算管理

查看账户余额、交易记录、费用明细，帮助控制广告支出

安全权限控制

三种权限模式：只读模式（安全）、读写模式（可创建更新）、完全模式（含删除），防止误操作

优势

自然语言操作：用对话代替复杂界面操作，降低学习成本

效率提升：快速执行批量操作，节省登录后台的时间

实时数据：随时获取最新广告表现，无需等待报表生成

权限控制：三种安全模式防止误删重要数据

全面覆盖：支持Naver广告API的47个主要功能

易于集成：简单配置即可与Claude等AI助手连接

局限性

需要API凭证：必须先申请Naver广告API权限

依赖网络：需要稳定的网络连接访问API

技术门槛：初始配置需要一定的技术知识

功能限制：某些高级广告后台功能可能未完全覆盖

语言支持：主要面向韩语广告管理，其他语言支持有限

如何使用

获取API凭证

登录Naver SearchAd后台，进入工具 > API管理，创建新的API密钥，记录API Key、Secret Key和Customer ID

安装MCP服务器

使用npm或pnpm全局安装服务器程序

配置Claude Desktop

在Claude Desktop配置文件中添加MCP服务器设置，包含API凭证和环境变量

启动并使用

重启Claude Desktop，开始用自然语言管理广告。例如询问广告表现或创建新广告活动

使用案例

日常广告监控

广告运营人员每天需要查看广告表现，调整表现不佳的广告

新产品推广

营销经理需要为新上市的产品创建广告活动并添加相关关键词

关键词优化

需要定期优化关键词，删除表现差的关键词，添加新的高潜力关键词

预算调整

根据广告表现调整预算分配，增加表现好的广告预算，减少表现差的

常见问题

我需要什么权限才能使用这个MCP服务器？

这个工具安全吗？会不会误删我的广告数据？

支持哪些AI助手？一定要用Claude吗？

数据更新是实时的吗？

如果我不会编程，能使用这个工具吗？

这个工具收费吗？

🚀 @packative/naver-searchad-mcp

这是一个适用于Naver SearchAd API的MCP（模型上下文协议）服务器。借助它，你可以直接从Claude Desktop或任何支持MCP的客户端管理广告系列、广告组、广告、关键词，并获取性能统计数据。

🚀 快速开始

要使用此项目，你需要先获取Naver SearchAd API的凭证，具体步骤如下：

登录 Naver SearchAd。
进入“工具”>“API管理”。
创建一个新的API密钥。
记录下你的API密钥、秘密密钥和客户ID。

详细的API文档可参考 Naver SearchAd官方API文档。

✨ 主要特性

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

💻 使用示例

基础用法

列出所有广告系列

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

📚 详细文档

配置

环境变量

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

变量	描述
`NAVER_API_KEY`	你的Naver SearchAd API密钥
`NAVER_SIGN_KEY`	用于签署请求的Naver SearchAd秘密密钥
`NAVER_CUSTOMER_ID`	你的Naver广告客户ID

权限模式

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

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

你可以通过CLI参数传递标志：

# 只读（默认，最安全）
naver-searchad-mcp

# 允许创建和更新
naver-searchad-mcp --rw

# 包括删除操作的完全访问权限
naver-searchad-mcp --rwd

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

Claude Desktop设置

在Claude Desktop配置文件中添加以下内容：

macOS：~/Library/Application Support/Claude/claude_desktop_config.json
Windows：%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 Code设置

在Claude Code设置中添加：

{
  "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`	读取	列出所有广告系列
`get_campaign`	读取	获取特定广告系列的详细信息
`create_campaign`	写入	创建新的广告系列
`update_campaign`	写入	更新广告系列（名称、预算、投放方式、暂停/启用）
`delete_campaign`	删除	删除广告系列

广告组工具

工具	权限	描述
`list_adgroups`	读取	列出广告组，可根据广告系列进行过滤
`get_adgroup`	读取	获取特定广告组的详细信息
`create_adgroup`	写入	在广告系列中创建新的广告组
`update_adgroup`	写入	更新广告组（出价、预算、暂停/启用）
`delete_adgroup`	删除	删除广告组

广告（创意）工具

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

关键词工具

工具	权限	描述
`list_keywords`	读取	列出广告组中的所有关键词
`get_keyword`	读取	获取特定关键词的详细信息
`create_keyword`	写入	向广告组中添加关键词
`update_keyword`	写入	更新关键词（出价金额、暂停/启用）
`delete_keyword`	删除	删除关键词

否定关键词工具

工具	权限	描述
`list_negative_keywords`	读取	列出广告组或广告系列的否定关键词
`create_negative_keywords`	写入	添加否定关键词（精确匹配或短语匹配）
`delete_negative_keywords`	删除	根据ID删除否定关键词

广告扩展工具

工具	权限	描述
`list_ad_extensions`	读取	列出广告组的广告扩展
`create_ad_extension`	写入	创建广告扩展（网站链接、号召性用语等）
`delete_ad_extension`	删除	删除广告扩展

统计工具

工具	权限	描述
`get_stats`	读取	获取性能统计数据（展示次数、点击次数、费用、转化次数等）
`get_campaign_stats`	读取	获取所有活跃广告系列的统计数据及广告系列详细信息
`create_stat_report`	写入	创建异步统计报告任务
`get_stat_report`	读取	检查异步报告任务的状态
`download_stat_report`	读取	下载已完成的统计报告

可用指标：impCnt（展示次数）、clkCnt（点击次数）、salesAmt（费用）、ctr（点击率）、cpc（每次点击费用）、ccnt（转化次数）、crto（转化率）、convAmt（转化价值）、ror（广告支出回报率）、cpConv（每次转化成本）、avgRnk（平均排名）

日期预设：today（今天）、yesterday（昨天）、last7days（过去7天）、last30days（过去30天）、lastweek（上周）、lastmonth（上月）、lastquarter（上季度）

细分维度：pcMblTp（设备）、dayw（星期几）、hh24（小时）、regnNo（地区）

关键词研究与出价估算工具

工具	权限	描述
`get_keyword_suggestions`	读取	获取带有搜索量、点击率和竞争数据的关键词建议
`get_estimate_performance`	读取	估算给定出价金额下的展示次数、点击次数和费用
`get_estimate_median_bid`	读取	获取在首页展示的中位出价

业务资金（预算）工具

工具	权限	描述
`get_bizmoney`	读取	获取当前账户余额
`get_bizmoney_histories`	读取	获取交易历史（收费、退款）
`get_bizmoney_cost`	读取	获取按日期划分的费用明细

业务渠道工具

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

标签工具

工具	权限	描述
`list_labels`	读取	列出所有标签
`create_label`	写入	创建标签（名称 + 颜色）
`delete_label`	删除	删除标签

其他工具

工具	权限	描述
`get_member_info`	读取	获取账户/会员信息
`get_quality_index`	读取	获取关键词质量得分和改进建议
`list_ip_exclusions`	读取	列出为防止点击欺诈而阻止的IP地址
`create_ip_exclusion`	写入	阻止一个IP地址
`delete_ip_exclusion`	删除	解除对一个IP地址的阻止

开发

# 安装依赖
pnpm install

# 运行测试
pnpm test

# 以监听模式运行测试
pnpm test:watch

# 运行测试并生成覆盖率报告
pnpm test:coverage

# 类型检查
pnpm typecheck

# 构建项目
pnpm build

项目结构

src/
  index.ts                  # 服务器设置、权限模式、工具注册
  types/
    common.ts               # 共享类型 (ToolDefinition, AccessLevel, PermissionMode)
    campaigns.ts            # 广告系列类型
    adgroups.ts             # 广告组类型
    keywords.ts             # 关键词类型
    ads.ts                  # 广告/创意类型
    stats.ts                # 统计与报告类型
    channels.ts             # 渠道类型
    bizmoney.ts             # 业务资金类型
    keyword-tool.ts         # 关键词建议与估算类型
    ad-extensions.ts        # 广告扩展类型
    negative-keywords.ts    # 否定关键词类型
    labels.ts               # 标签类型
    misc.ts                 # 会员、质量指数、IP排除类型
  tools/
    campaigns.ts            # 广告系列工具定义与处理程序
    adgroups.ts             # 广告组工具
    keywords.ts             # 关键词工具
    ads.ts                  # 广告/创意工具
    stats.ts                # 统计与报告工具
    channels.ts             # 渠道工具
    bizmoney.ts             # 业务资金工具
    keyword-tool.ts         # 关键词研究与出价估算工具
    ad-extensions.ts        # 广告扩展工具
    negative-keywords.ts    # 否定关键词工具
    labels.ts               # 标签工具
    misc.ts                 # 会员、质量指数、IP排除工具
  utils/
    fetchWithAuth.ts        # 经过身份验证的HTTP客户端 (HMAC-SHA256)