naver-ads-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| NAVER_ADS_API_KEY | Yes | 액세스라이선스 (Access license key) | |
| NAVER_ADS_BASE_URL | No | API 베이스 URL (API base URL) | https://api.searchad.naver.com |
| NAVER_ADS_SECRET_KEY | Yes | 비밀키 (Secret key) | |
| NAVER_ADS_TIMEOUT_MS | No | 요청 타임아웃 (Request timeout in milliseconds) | 15000 |
| NAVER_ADS_CUSTOMER_ID | Yes | 광고계정 ID (숫자) (Ad account ID, numeric) | |
| NAVER_ADS_MAX_RETRIES | No | 429·5xx·네트워크 오류 재시도 횟수 (Number of retries for 429, 5xx, network errors) | 2 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_campaignsA | 광고계정의 캠페인 목록을 조회합니다. 캠페인은 파워링크·쇼핑검색·파워컨텐츠 등 광고 유형과 예산을 관리하는 최상위 단위입니다. 반환되는 nccCampaignId는 list_adgroups의 입력값이 됩니다. |
| get_campaignB | nccCampaignId로 캠페인 하나의 상세 정보를 조회합니다. |
| list_adgroupsA | 캠페인에 속한 광고그룹 목록을 조회합니다. 광고그룹은 입찰가·소재·키워드를 묶는 단위입니다. campaignId를 생략하면 광고계정 전체 광고그룹을 조회합니다. |
| get_adgroupC | nccAdgroupId로 광고그룹 하나의 상세 정보를 조회합니다. |
| get_adgroup_targetsB | 광고그룹에 설정된 타게팅(요일·시간, 지역, 매체, PC/모바일 등)을 조회합니다. |
| list_keywordsA | 광고그룹에 등록된 키워드 목록과 입찰가·상태를 조회합니다. 노출·클릭·비용 같은 성과 지표는 포함되지 않으므로 get_stats를 함께 쓰세요. |
| get_keywordB | nccKeywordId로 키워드 하나의 상세 정보를 조회합니다. |
| get_related_keywordsA | 키워드도구 API로 힌트 키워드의 연관 키워드와 월간 검색수·클릭수·경쟁정도를 조회합니다. 광고 등록 여부와 무관하게 조회할 수 있어 키워드 발굴에 씁니다. 힌트는 최대 5개입니다. |
| list_adsB | 광고그룹에 등록된 광고 소재(제목·설명·연결 URL)와 검수 상태를 조회합니다. |
| get_adB | nccAdId로 광고 소재 하나의 상세 정보를 조회합니다. |
| list_ad_extensionsB | 캠페인 또는 광고그룹에 붙은 확장 소재(전화번호, 위치정보, 홍보문구 등)를 조회합니다. |
| get_statsA | 캠페인·광고그룹·키워드·소재의 성과 지표를 조회합니다. ids는 종류를 가리지 않고 nccCampaignId / nccAdgroupId / nccKeywordId / nccAdId를 모두 받습니다. since+until과 datePreset 중 하나만 지정하세요. 둘 다 생략하면 네이버 기본 기간이 적용됩니다. |
| list_business_channelsA | 광고계정에 등록된 비즈채널(웹사이트, 전화번호, 네이버 톡톡, 쇼핑몰 등)을 조회합니다. 광고그룹이 연결하는 대상입니다. |
| list_customer_linksB | 대행사·광고주 간 연결된 광고계정 목록을 조회합니다. 여기서 얻은 customerId를 다른 툴의 customerId 인자로 넘겨 여러 계정을 오갈 수 있습니다. |
| naver_ads_getA | 전용 툴이 없는 네이버 검색광고 API 엔드포인트를 직접 GET 호출합니다. 전용 툴(list_campaigns, get_stats 등)이 있으면 그쪽을 쓰세요. 이 툴은 /ncc/labels 처럼 아직 감싸지 않은 경로용입니다. 엔드포인트 명세는 https://naver.github.io/searchad-apidoc 을 참고하세요. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 15 tools
Tools target distinct resources with clear list/get separation; only minor potential confusion between list_ads and list_ad_extensions, or the generic naver_ads_get fallback, but descriptions clarify intended use.
Predominantly list_/get_ + noun in snake_case; the generic naver_ads_get breaks the pattern and get_adgroup_targets uses get_ for what is a list operation, but overall readable and predictable.
15 tools is within the recommended range and each maps to a clear resource or operation; the generic fallback prevents over-proliferation for uncovered endpoints.
Surface is entirely read-only: no create, update, or delete operations for campaigns, adgroups, keywords, ads, or extensions; agents cannot perform ad management lifecycle tasks, a major gap for an ads platform.