🇰🇷 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 |
|---|---|
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
Metadata
Release files for korean-data-mcp 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| korean_data_mcp-0.1.0.tar.gz | 8.3 kB | Without provenance | Details for korean_data_mcp-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| korean_data_mcp-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for korean_data_mcp-0.1.0-py3-none-any.whl |
Total release size: 15.8 kB
Release files / korean_data_mcp-0.1.0.tar.gz
| Download URL | korean_data_mcp-0.1.0.tar.gz |
|---|---|
| Size | 8.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
3738dbfbce3dbe64f2c9ab678985552c1fef77450b6c491850ae0c685984189d
|
|
BLAKE2b-256 checksum How to use checksums |
4651cc322110885f0af7421525410081a6d401bf35c5789c227360609de9af2a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.2
|
Release files / korean_data_mcp-0.1.0-py3-none-any.whl
| Download URL | korean_data_mcp-0.1.0-py3-none-any.whl |
|---|---|
| Size | 7.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
8b8c78cb2908890dc39021311d3aeb8ec28677aba19b01800cffb8080b21e725
|
|
BLAKE2b-256 checksum How to use checksums |
36e068833cbfa03ae8ddbd614774b136183169feedbecb7c3870bace96f1ca0d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.2
|
Security for korean-data-mcp 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.