korean-keyword-mcp

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