Korean Data

Real-time Korean web data for AI assistants — powered by Apify actors.

PyPI License: MIT MCP

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
get_naver_place_reviews	Fetch reviews for any Naver Place (restaurant, cafe, shop, etc.)
get_melon_chart	Real-time / daily / weekly Korean music chart (실시간 차트)
search_daangn	Search Daangn Market (당근마켓) C2C listings
search_bunjang	Search Bunjang (번개장터) marketplace
search_naver_news	Search Naver News articles by keyword
search_naver_places	Search Naver Map places by keyword + location
get_musinsa_ranking	Musinsa fashion ranking by category

---

🚀 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-mcp

Or with uv (recommended):

uv add korean-data-mcp

3. 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	oxygenated_quagmire/naver-place-reviews
Melon Chart	oxygenated_quagmire/melon-chart-scraper
Daangn Market	oxygenated_quagmire/daangn-market-scraper
Bunjang Market	oxygenated_quagmire/bunjang-market-scraper
Naver News	oxygenated_quagmire/naver-news-scraper
Naver Place Search	oxygenated_quagmire/naver-place-search
Musinsa Ranking	oxygenated_quagmire/musinsa-ranking-scraper

---

💰 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

---

Built on FastMCP · Data from Apify