korean-data-mcp
Provides access to Naver web data, allowing users to search for news articles and retrieve detailed information and reviews for locations via Naver Places and Naver Maps.
π°π· Korean Data MCP
Real-time Korean web data for AI assistants β powered by Apify actors.
A Model Context Protocol (MCP) server that gives Claude, Cursor, and other AI tools direct access to live Korean web data β including Naver reviews, Melon music charts, Daangn/Bunjang marketplace listings, Korean news, and Musinsa fashion rankings.
π Available Tools
Tool | Description |
| Fetch reviews for any Naver Place (restaurant, cafe, shop, etc.) |
| Real-time / daily / weekly Korean music chart (μ€μκ° μ°¨νΈ) |
| Search Daangn Market (λΉκ·Όλ§μΌ) C2C listings |
| Search Bunjang (λ²κ°μ₯ν°) marketplace |
| Search Naver News articles by keyword |
| Search Naver Map places by keyword + location |
| Musinsa fashion ranking by category |
Related MCP server: Web Intelligence MCP Server
π Quick Start
1. Get an Apify API Token
Sign up at apify.com (free tier: $5/month credit included).
Copy your token from console.apify.com/account/integrations.
2. Install
pip install korean-data-mcpOr with uv (recommended):
uv add korean-data-mcp3. Set Environment Variable
export APIFY_TOKEN="your_apify_token_here"4. Run the MCP Server
korean-data-mcpβοΈ Claude Desktop Configuration
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"korean-data": {
"command": "korean-data-mcp",
"env": {
"APIFY_TOKEN": "your_apify_token_here"
}
}
}
}Or with uvx (no install needed):
{
"mcpServers": {
"korean-data": {
"command": "uvx",
"args": ["korean-data-mcp"],
"env": {
"APIFY_TOKEN": "your_apify_token_here"
}
}
}
}π¬ Usage Examples
Once connected to Claude Desktop or another MCP client:
"What are the top 10 songs on Melon chart right now?"
"Find cafes near Hongdae on Naver Map and show their reviews."
"Search Daangn for iPhone 15 Pro listings in Seoul."
"What are the trending news stories on Naver today about μΈκ³΅μ§λ₯?"
"Show me the Musinsa top 50 outer clothing items."π§ Cursor / VS Code Configuration
Add to .cursor/mcp.json or .vscode/mcp.json:
{
"servers": {
"korean-data": {
"type": "stdio",
"command": "korean-data-mcp",
"env": {
"APIFY_TOKEN": "your_apify_token_here"
}
}
}
}π Data Sources
All data is fetched live via Apify actors:
Actor | Apify Store |
Naver Place Reviews | |
Melon Chart | |
Daangn Market | |
Bunjang Market | |
Naver News | |
Naver Place Search | |
Musinsa Ranking |
π° Pricing
Apify Free Tier: $5/month credit β enough for ~1,000β5,000 tool calls
Actor runs are billed per 1,000 items returned ($0.50/1K items)
No additional cost for this MCP server itself
π Development
git clone https://github.com/leadbrain/korean-data-mcp
cd korean-data-mcp
pip install -e ".[dev]"
export APIFY_TOKEN="your_token"
python -m korean_data_mcp.serverπ License
MIT License β see LICENSE
π€ Contributing
Issues and PRs welcome at github.com/leadbrain/korean-data-mcp
Available Tools
7 toolsget_melon_chartB
Fetch the Melon music chart (λ©λ‘ μ°¨νΈ).
| Name | Required | Description | Default |
|---|---|---|---|
| chart_type | No | Chart to fetch β 'realtime' (μ€μκ°), 'hot100', 'daily', or 'weekly' | realtime |
| limit | No | Number of songs to return (default 100, max 100) |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description must carry the full burden. It merely states 'Fetch' without disclosing behavioral traits such as rate limits, authentication requirements, or pagination behavior. The output schema exists but does not compensate for lack of operational context.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single sentence with no wasted words. It is concise and front-loaded with the essential verb and resource, though it could be slightly more informative without losing conciseness.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool's simplicity (2 optional parameters, output schema exists), the description is minimally adequate but could be improved by mentioning the output format or typical use cases. It does not cover edge cases or error conditions.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the schema already explains both parameters. The description does not add additional meaning beyond what the schema provides, resulting in a baseline score of 3.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description uses a clear verb 'Fetch' and specifies the resource 'Melon music chart', which distinguishes it from sibling tools focused on shopping, reviews, and news. However, it does not explicitly differentiate from potential similar chart tools on other servers.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No explicit guidance on when to use this tool versus alternatives. Since sibling tools are from different domains, usage context is implied but not stated. No exclusion criteria or prerequisites are mentioned.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
get_musinsa_rankingA
Fetch Musinsa (무μ μ¬) fashion ranking β Korea's leading fashion platform.
| Name | Required | Description | Default |
|---|---|---|---|
| category | No | Category slug, e.g. 'all', 'outer', 'top', 'bottom', 'shoes', 'bag' | all |
| max_items | No | Maximum number of items to return (default 50, max 100) |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description must disclose behaviors like rate limits, data freshness, or authentication needs. It only states 'fetch ranking' without any such details, leaving the agent unaware of potential constraints.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, efficient sentence with no wasted words. It front-loads the key purpose and provides enough context for a simple fetch tool.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the output schema exists and the tool is straightforward, the description is largely complete. However, briefly mentioning the category or max_items parameters could enhance completeness.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The input schema has 100% coverage with clear parameter descriptions. The description adds no extra meaning beyond the schema, so a baseline score of 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the verb 'Fetch' and the resource 'Musinsa fashion ranking', immediately conveying the tool's function. It differentiates well from sibling tools which target other platforms like Melon or Naver.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies usage for fetching Musinsa ranking but provides no explicit guidance on when to use it versus alternatives, nor any context about prerequisites or typical use cases.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
search_bunjangB
Search Bunjang (λ²κ°μ₯ν°) β Korea's largest C2C marketplace.
| Name | Required | Description | Default |
|---|---|---|---|
| keyword | Yes | Search keyword in Korean or English | |
| max_items | No | Maximum number of listings to return (default 30, max 100) | |
| sort | No | Sort order β 'recent' (μ΅μ μ) or 'popular' (μΈκΈ°μ) | recent |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations provided; the description only states the tool searches a marketplace. No disclosure of side effects, authentication needs, or rate limits. The read-only nature is implied but not explicit.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
A single sentence that is efficient and direct. No wasted words, though it could benefit from more structure or detail.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Despite having a complete input schema and output schema, the description lacks usage guidance and behavioral context. For a tool with siblings, it is insufficiently complete.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, so all parameters have descriptions. The tool description adds no additional semantic value beyond what the schema already provides, resulting in a baseline score.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool searches Bunjang, Korea's largest C2C marketplace, with a specific verb and resource. Among siblings like search_daangn, it is distinguished by naming the exact platform.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance on when to use this tool versus sibling search tools (search_daangn, search_naver_news, etc.). No explicit context for choosing this tool.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
search_daangnB
Search Daangn Market (λΉκ·Όλ§μΌ) listings.
| Name | Required | Description | Default |
|---|---|---|---|
| keyword | Yes | Search keyword in Korean or English | |
| region | No | Optional region filter (e.g. 'μμΈ', 'κ°λ¨κ΅¬') | |
| max_items | No | Maximum number of listings to return (default 30, max 100) |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description bears full responsibility for behavioral disclosure. It only states 'Search listings' with no mention of pagination, rate limits, or any side effects.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
A single sentence that is direct and contains no superfluous information. Efficient communication.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Despite having an output schema, the description fails to provide context about the tool's scope, behavior, or what constitutes a listing. It is too minimal for a complex search tool.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The schema description covers 100% of parameters, so the description adds no extra value. According to guidelines, baseline 3 is appropriate when schema coverage is high.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly identifies the action ('Search') and the specific resource ('Daangn Market listings'), distinguishing it from sibling tools like search_bunjang which targets a different marketplace.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance on when to use this tool versus alternatives such as search_bunjang or search_naver_places. The description lacks context for selection.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.
7 tool updates
- Changed
get_melon_chart2 fields changed- added
Input schema / properties / chart_type / descriptionAdded value: +"Chart to fetch β 'realtime' (μ€μκ°), 'hot100', 'daily', or 'weekly'" - added
Input schema / properties / limit / descriptionAdded value: +"Number of songs to return (default 100, max 100)"
- Changed
get_musinsa_ranking2 fields changed- added
Input schema / properties / category / descriptionAdded value: +"Category slug, e.g. 'all', 'outer', 'top', 'bottom', 'shoes', 'bag'" - added
Input schema / properties / max_items / descriptionAdded value: +"Maximum number of items to return (default 50, max 100)"
- Changed
get_naver_place_reviews2 fields changed- added
Input schema / properties / max_reviews / descriptionAdded value: +"Maximum number of reviews to return (default 20, max 100)" - added
Input schema / properties / place_url / descriptionAdded value: +"Naver Place URL, e.g. https://map.naver.com/v5/entry/place/1234567890"
- Changed
search_bunjang3 fields changed- added
Input schema / properties / keyword / descriptionAdded value: +"Search keyword in Korean or English" - added
Input schema / properties / max_items / descriptionAdded value: +"Maximum number of listings to return (default 30, max 100)" - added
Input schema / properties / sort / descriptionAdded value: +"Sort order β 'recent' (μ΅μ μ) or 'popular' (μΈκΈ°μ)"
- Changed
search_daangn3 fields changed- added
Input schema / properties / keyword / descriptionAdded value: +"Search keyword in Korean or English" - added
Input schema / properties / max_items / descriptionAdded value: +"Maximum number of listings to return (default 30, max 100)" - added
Input schema / properties / region / descriptionAdded value: +"Optional region filter (e.g. 'μμΈ', 'κ°λ¨κ΅¬')"
- Changed
search_naver_news3 fields changed- added
Input schema / properties / max_articles / descriptionAdded value: +"Maximum number of articles to return (default 20, max 100)" - added
Input schema / properties / query / descriptionAdded value: +"Search query in Korean or English" - added
Input schema / properties / sort / descriptionAdded value: +"Sort order β 'date' (μ΅μ μ) or 'sim' (κ΄λ ¨λμ)"
- Changed
search_naver_places3 fields changed- added
Input schema / properties / keyword / descriptionAdded value: +"Place type or name, e.g. 'μΉ΄ν', 'λ§μ§', 'cafe'" - added
Input schema / properties / location / descriptionAdded value: +"Location context, e.g. 'νλ', 'κ°λ¨μ', 'Itaewon'" - added
Input schema / properties / max_places / descriptionAdded value: +"Maximum number of places to return (default 20, max 100)"
7 tool updates
v0.1.0- First observed
get_melon_chart - First observed
get_musinsa_ranking - First observed
get_naver_place_reviews - First observed
search_bunjang - First observed
search_daangn - First observed
search_naver_news - First observed
search_naver_places
TDQS
Each tool targets a distinct Korean data source (music chart, fashion ranking, marketplace, news, etc.) with no overlap in purpose, ensuring clear differentiation.
All tools follow a consistent verb_noun pattern: 'get_' for fetching entities and 'search_' for search operations, naming clearly reflects function.
7 tools is well-scoped for a server focused on Korean dataβcovers multiple domains without being overwhelming or too sparse.
The set covers major Korean data categories (music, fashion, marketplace, news, places) but could be complemented with additional services like shopping or social media.
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Connectors
Extract data from any website with thousands of scrapers, crawlers, and automations on Apify Store β‘
Hiring, SEC, research papers, GitHub & Hacker News as JSON for AI agents. Pay-per-result on Apify.
Korean market data for AI agents: K-beauty/K-food products, Naver trends, stocks, real estate.
Korean fact-verification tools for AI agents: business registration, address, DART, apt prices, laws
Related MCP Servers
AlicenseAqualityAmaintenanceUse 3,000+ pre-built cloud tools from Apify, known as Actors, to extract data from websites, e-commerce, social media, search engines, maps, and more1037,9096,070MIT- FlicenseNot gradedqualityDmaintenanceProvides AI agents with real-time web capabilities including live search results, markdown web scraping, business lead generation, and detailed company information. It enables agents to bypass knowledge cutoffs by accessing current web data through a monetized Apify Actor.-
- AlicenseNot gradedqualityBmaintenanceThe web data platform for AI agents. Fetch, search, crawl, extract, monitor, and screenshot any URL. 55+ domain extractors, 65-98% token savings. 7 MCP tools included.33212AGPL 3.0
- AlicenseNot gradedqualityDmaintenance14 web scrapers as MCP tools for AI agents: Reddit, Amazon, Google Maps, Yelp, YouTube, Indeed & more.612MIT
Appeared in Searches
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
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/leadbrain/korean-data-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server