skills.rest
NomaDamas
NomaDamasOFFICIAL
Explore all skills by this author →
WebsiteGitHub

naver-ad-performance

Query Naver Search Ad impressions, clicks, cost, CTR, CPC, and conversions via the signed API.

7.4k|904|Updated Mar 24, 2026
Search Tags:#advertising#performance report#ctr#CPC#Naver#search ads#Keyword Research
One-click install
npx skills add https://github.com/NomaDamas/k-skill --skill naver-ad-performance
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: naver-ad-performance
Source: https://github.com/NomaDamas/k-skill/tree/main/naver-ad-performance
Command: npx skills add https://github.com/NomaDamas/k-skill --skill naver-ad-performance

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Checking Naver Search Ad performance normally requires logging into the ad console and manually exporting reports. This Skill lets an AI agent query impressions, clicks, ad spend, CTR, CPC, average rank, and conversions directly through the official Naver Search Ad API, in read-only mode.

Core Features & Use Cases

  • Performance stats: Retrieve impressions, clicks, ad spend, CTR, CPC, average rank, and conversions for campaigns, ad groups, or keywords over a chosen date range, with optional daily breakdown.
  • Structure listing: List campaigns, ad groups, and keywords to discover the IDs needed for stats queries.
  • Keyword tool: Look up related keywords, monthly PC/mobile search volume, and competition level.
  • Diagnostics: A doctor command verifies that the three required API credentials exist and that the Naver API is reachable from the current environment.
  • Use case: Ask your agent "show me this month's Naver ad spend and CTR by campaign" and get labeled JSON results without opening the ad console.

Quick Start

Ask the agent to run the naver-ad-performance doctor command first to confirm your NAVER_AD_API_KEY, NAVER_AD_SECRET_KEY, and NAVER_AD_CUSTOMER_ID environment variables are set, then request stats for your campaign IDs over a date range.

Frequently Asked Questions about naver-ad-performance

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check Naver Search Ad performance with the API?▼

Issue signed GET requests to the Naver Search Ad API stats endpoint with campaign, ad group, or keyword IDs and a date range. This Skill wraps that flow, returning impressions, clicks, ad spend, CTR, CPC, average rank, and conversions as labeled JSON.

What credentials are required for the Naver Search Ad API?▼

You need three environment variables: NAVER_AD_API_KEY, NAVER_AD_SECRET_KEY, and NAVER_AD_CUSTOMER_ID, issued from the API usage management page in your Naver Search Ad account. The doctor command verifies all three are present and that the API is reachable.

Can this tool change bids or edit Naver ad campaigns?▼

No. The Skill is strictly read-only and only calls GET endpoints for campaigns, ad groups, keywords, stats, and the keyword tool. Bid changes, budget edits, and campaign creation or deletion are intentionally not implemented.

Why does the Naver Search Ad API return HTTP 401 errors?▼

HTTP 401 indicates a signature failure, usually caused by an incorrect API key or secret, or a system clock that is out of sync. Each request requires an HMAC-SHA256 signature built from the timestamp, HTTP method, and URI path.

Does Naver ad stats querying work in cloud sandbox environments?▼

Often not, because cloud sandboxes with allowlisted domains may block egress to api.searchad.naver.com. Run the doctor command first; if it reports unreachable, execute the Skill in a local environment such as Claude Code or Codex CLI.

How do I find related keywords and monthly search volume on Naver?▼

Use the keywordtool command with comma-separated hint keywords. It returns related keywords along with monthly PC and mobile search volumes and a competition index from the Naver Search Ad keyword tool endpoint.

Related Skills

Explore More Marketing & Sales Skills→
NomaDamasNomaDamas
7.1k

naver-blog-research

Search Naver blogs and extract structured JSON results from mobile post pages.

Official
Intermediate
ca-who-codesca-who-codes

budget-and-bid-strategy

Analyze cross-platform ad budget pacing and bid strategy decisions.

Community
Advanced
heg-wtfheg-wtf

naver-search

Search Naver local, book, blog, cafe, news, and shopping categories via naver-cli.

Official
Basic
Dataslayer-AIDataslayer-AI
18

ds-channel-report

Aggregate cross-channel marketing data into a structured weekly report.

Official
Advanced