Skip to main content
Glama
PlatAid

Naver Search Ad MCP

by PlatAid
OverviewSchemaRelated ServersScoreDiscussions
Python
Hybrid

Naver Search Ad MCP

An MCP server for the Naver Search Ad (네이버 검색광고) API — read/analytics focused. Query campaigns, ad groups, keywords, stats, keyword research, and bid estimates through any MCP client.

  • Read-only by default (safe): all tools are annotated readOnlyHint.

  • Multi-account: one credential per user auto-discovers every advertiser account it can access (agency-delegated + own) via /ad-accounts + child-ad-accounts, addressed by account_id (= Naver customerId).

  • Two transports: local stdio for a single account, or hosted streamable-http (Google Workspace OAuth) for a team — see DEPLOY.md.

Quick start (local, stdio)

Get your credentials at searchad.naver.com → 관리 → 도구 → API 사용 관리 (CUSTOMER_ID, access license, secret key).

uv venv --python 3.13
uv pip install -e .

export NAVER_API_KEY=...        # access license
export NAVER_SECRET_KEY=...     # secret key
export NAVER_CUSTOMER_ID=...    # customer id (integer)
naver-searchad-mcp             # stdio MCP server

Register with an MCP client (e.g. Claude Desktop):

{
  "mcpServers": {
    "naver-searchad": {
      "command": "/path/to/.venv/bin/naver-searchad-mcp",
      "env": {
        "NAVER_API_KEY": "...",
        "NAVER_SECRET_KEY": "...",
        "NAVER_CUSTOMER_ID": "..."
      }
    }
  }
}

Related MCP server: Naver Search MCP Server

Tools

Accounts

Tool

Description

list_accounts()

All accessible ad accounts (/ad-accounts ∪ child-ad-accounts, deduped). Each account_id = customerId

get_accounts_overview(...)

Per-account campaign count + period performance summary

whoami()

Diagnostic: authenticated caller + linked credential (hosted mode)

Entities

Tool

Description

list_campaigns(account_id, campaign_type?)

Campaigns

get_campaign(account_id, campaign_id)

Campaign detail

list_adgroups(account_id, campaign_id)

Ad groups

get_adgroup(account_id, adgroup_id)

Ad group detail

list_keywords(account_id, adgroup_id)

Keywords

list_ads(account_id, adgroup_id)

Ads (creatives)

list_business_channels(account_id)

Business channels

Performance & analytics

Tool

Description

get_stats(account_id, ids[], fields[], since/until|date_preset, ...)

Low-level /stats (≤92-day window, single entity level)

get_campaign_performance(account_id, dates, fields?)

All campaigns + names

get_keyword_performance(account_id, adgroup_id, dates)

Keyword performance + text

get_related_keywords(account_id, hint_keywords[])

Related keywords, search volume, competition (/keywordstool)

get_performance_report(account_id, level, since, until, daily?, ...)

Named report; auto-chunks >92 days; aggregate (ratios recomputed) or daily

create_stat_report(account_id, report_tp, stat_dt)

Async bulk StatReport job (1 job = 1 day)

download_stat_report(account_id, download_url, max_rows?)

Download StatReport TSV (raw, columns not interpreted)

Bid estimates

Tool

Description

estimate_keyword_bid(account_id, keywords[], estimate_type, device, position)

Target-position / min-exposure bid

estimate_keyword_performance(account_id, keyword, bids[], device)

Predicted impressions/clicks/cost per bid

Metric field names are terse and sometimes misleading (salesAmt = cost, ror = ROAS %); the server attaches clear aliases (cost, roas_pct, …) and exposes a naver://metric-glossary resource.

Hosted deployment (team, Google OAuth)

See DEPLOY.md — Cloud Run + Secret Manager + Google Workspace OAuth, per-email credential model, and a self-service admin console at /admin.

Development

uv pip install -e ".[dev]"
pytest

Notes

  • This server covers Search Ad only. Naver GFA (성과형 디스플레이광고) is a separate API (partner-only OAuth) and is out of scope.

  • Signing rule: base64(HMAC_SHA256(secret, "{timestamp}.{METHOD}.{path}")) — path only, query excluded, timestamp in ms.

License

MIT — see LICENSE.

Install Server
A
license - permissive license
A
quality
C
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Related MCP Servers

  • Naver MCP Server

    pfldy2850
    A
    license
    -
    quality
    C
    maintenance
    An MCP server that provides access to Naver OpenAPI services, enabling users to search blogs, news, books, images, and other content through standardized Model Context Protocol interfaces.
    Last updated
    114
    MIT

  • naver-mcp

    leedw80
    F
    license
    -
    quality
    C
    maintenance
    Naver Search API + Datalab API MCP server with 19 tools for Korean web search and trend analysis.
    Last updated
    30

  • 네이버 API MCP 서버

    dataartai
    F
    license
    -
    quality
    D
    maintenance
    이 MCP 서버는 네이버 쇼핑인사이트 API와 검색 API를 통합하여 카테고리 및 키워드 트렌드를 조회하고 블로그, 쇼핑, 지식iN, 백과사전 검색을 수행할 수 있게 해줍니다.
    Last updated

View all related MCP servers

Related MCP Connectors

  • agentcentral

    Hosted Amazon Seller Central and Amazon Ads MCP server for Claude, ChatGPT, Cursor, and agents.

  • Appcircle MCP

    MCP server for Appcircle mobile CI/CD platform.

  • GTM API: LinkedIn MCP Server

    Managed LinkedIn MCP server for AI agents: search, connect, message and enrich on accounts you own.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/PlatAid/naver-searchad-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server