Korean Keyword

MCP server for Korean keyword niche analysis. The only MCP server that exposes Naver SearchAd API data (CPC competition, click rates) for keyword research.

Why This Exists

Feature	korean-keyword-mcp	Other Naver MCP servers
SearchAd API (CPC, competition index)	YES	NO
Niche scoring (0-100, A-F grade)	YES	NO
Blog competition deep analysis	YES	Basic search only
Keyword expansion + scoring	YES	NO
Batch comparison analysis	YES	NO
Trending keyword discovery	YES	NO

Tools (7)

Tool	Description
keyword_expand	Expand seed keyword → 50+ related keywords with Quick Score + top N Full Score
niche_score	Single keyword full niche analysis (0-100 score + A-F grade)
search_volume	Naver SearchAd monthly search volume (PC/mobile split, competition index)
trend	Naver DataLab 12-month search trend (monthly relative values 0-100)
blog_competition	Blog competition analysis (total results + top 10 posts)
batch_analyze	Batch niche analysis for up to 10 keywords with sorted comparison
trending_discover	Discover rising-trend keywords from seed keyword's related keywords

Scoring Algorithm

Full Niche Score (100 points)

Component	Weight	Source
Volume	20	SearchAd API — sweet spot: 1K-30K searches
Competition	30	Blog total results + blogger diversity
Freshness	15	Average post age (older = less competition)
Trend	20	12-month linear regression slope
Efficiency	15	Search volume / blog post ratio

Grades: A (75+), B (60+), C (45+), D (30+), F (<30)

Setup

1. Get Naver API Keys

You need two sets of API credentials:

Naver SearchAd API (for search volume, CPC, competition):

1. Go to Naver SearchAd
2. Create an account → Tools → API License
3. Note your Customer ID, API Key, and Secret Key

Naver Developer API (for DataLab trends, blog search):

1. Go to Naver Developers
2. Register application → Select "Search" and "DataLab" APIs
3. Note your Client ID and Client Secret

2. Configure Claude Desktop

Add to your Claude Desktop config (claude_desktop_config.json):

{
  "mcpServers": {
    "korean-keyword": {
      "command": "npx",
      "args": ["-y", "korean-keyword-mcp"],
      "env": {
        "NAVER_SEARCHAD_CUSTOMER_ID": "your-customer-id",
        "NAVER_SEARCHAD_API_KEY": "your-api-key",
        "NAVER_SEARCHAD_SECRET_KEY": "your-secret-key",
        "NAVER_CLIENT_ID": "your-client-id",
        "NAVER_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

3. Verify

Restart Claude Desktop. You should see "korean-keyword" in the MCP servers list with 7 tools available.

Example Usage

Once connected, you can ask Claude:

• "Analyze the niche potential of '캠핑의자'" → uses niche_score
• "Find niche keywords related to '다이어트'" → uses keyword_expand
• "Compare these keywords: 캠핑의자, 캠핑테이블, 캠핑조명" → uses batch_analyze
• "What keywords related to '캠핑' are trending up?" → uses trending_discover
• "How much search volume does '에어프라이어' get?" → uses search_volume

Environment Variables

Variable	Required	Description
NAVER_SEARCHAD_CUSTOMER_ID	Yes	SearchAd API customer ID
NAVER_SEARCHAD_API_KEY	Yes	SearchAd API key
NAVER_SEARCHAD_SECRET_KEY	Yes	SearchAd API secret
NAVER_CLIENT_ID	Yes	Naver Developer client ID
NAVER_CLIENT_SECRET	Yes	Naver Developer client secret

License

MIT