内容
# 🇰🇷 韩语数据 MCP
> 为 AI 助手提供实时的韩语网络数据 — 由 [Apify](https://apify.com) 驱动。
[](https://pypi.org/project/korean-data-mcp/)
[](LICENSE)
[](https://modelcontextprotocol.io)
一个 [模型上下文协议（MCP）](https://modelcontextprotocol.io) 服务器，为 Claude、Cursor 和其他 AI 工具提供直接访问实时韩语网络数据的能力 — 包括 Naver 评论、Melon 音乐排行榜、Daangn/Bunjang 市场列表、韩语新闻和 Musinsa 时尚排行榜。
---
## 🛠 可用工具
| 工具 | 描述 |
|------|-------------|
| `get_naver_place_reviews` | 获取任意 Naver 地点（餐厅、咖啡馆、商店等）的评论 |
| `get_melon_chart` | 实时 / 每日 / 每周韩语音乐排行榜（实时排行榜） |
| `search_daangn` | 搜索 Daangn 市场（当根市场）C2C 列表 |
| `search_bunjang` | 搜索 Bunjang（번개장터）市场 |
| `search_naver_news` | 按关键词搜索 Naver 新闻文章 |
| `search_naver_places` | 按关键词和位置搜索 Naver 地图地点 |
| `get_musinsa_ranking` | Musinsa 时尚分类排名 |
---
## 🚀 快速开始
### 1. 获取 Apify API 令牌
在 [apify.com](https://apify.com) 注册（免费套餐：每月 5 美元信用额度）。
从 [console.apify.com/account/integrations](https://console.apify.com/account/integrations) 复制您的令牌。
### 2. 安装
```bash
pip install korean-data-mcp
```
或使用 `uv`（推荐）：
```bash
uv add korean-data-mcp
```
### 3. 设置环境变量
```bash
export APIFY_TOKEN="your_apify_token_here"
```
### 4. 运行 MCP 服务器
```bash
korean-data-mcp
```
---
## ⚙️ Claude 桌面配置
添加到 `~/Library/Application Support/Claude/claude_desktop_config.json`：
```json
{
"mcpServers": {
"korean-data": {
"command": "korean-data-mcp",
"env": {
"APIFY_TOKEN": "your_apify_token_here"
}
}
}
}
```
或使用 `uvx`（无需安装）：
```json
{
"mcpServers": {
"korean-data": {
"command": "uvx",
"args": ["korean-data-mcp"],
"env": {
"APIFY_TOKEN": "your_apify_token_here"
}
}
}
}
```
---
## 💬 使用示例
连接到 Claude 桌面或其他 MCP 客户端后：
```
"Melon 排行榜当前的前 10 首歌曲是什么？"
"在 Naver 地图上查找弘大附近的咖啡馆并显示它们的评论。"
"在首尔搜索 Daangn 的 iPhone 15 Pro 列表。"
"Naver 今日关于人工智能的热点新闻是什么？"
"给我看 Musinsa 的前 50 件外衣。"
```
---
## 🔧 Cursor / VS Code 配置
添加到 `.cursor/mcp.json` 或 `.vscode/mcp.json`：
```json
{
"servers": {
"korean-data": {
"type": "stdio",
"command": "korean-data-mcp",
"env": {
"APIFY_TOKEN": "your_apify_token_here"
}
}
}
}
```
---
## 📊 数据源
所有数据均通过 [Apify](https://apify.com/oxygenated_quagmire) 代理实时获取：
| 代理 | Apify 商店 |
|-------|-------------|
| Naver 地点评论 | [oxygenated_quagmire/naver-place-reviews](https://apify.com/oxygenated_quagmire/naver-place-reviews) |
| Melon 排行榜 | [oxygenated_quagmire/melon-chart-scraper](https://apify.com/oxygenated_quagmire/melon-chart-scraper) |
| Daangn 市场 | [oxygenated_quagmire/daangn-market-scraper](https://apify.com/oxygenated_quagmire/daangn-market-scraper) |
| Bunjang 市场 | [oxygenated_quagmire/bunjang-market-scraper](https://apify.com/oxygenated_quagmire/bunjang-market-scraper) |
| Naver 新闻 | [oxygenated_quagmire/naver-news-scraper](https://apify.com/oxygenated_quagmire/naver-news-scraper) |
| Naver 地点搜索 | [oxygenated_quagmire/naver-place-search](https://apify.com/oxygenated_quagmire/naver-place-search) |
| Musinsa 排名 | [oxygenated_quagmire/musinsa-ranking-scraper](https://apify.com/oxygenated_quagmire/musinsa-ranking-scraper) |
---
## 💰 定价
- **Apify 免费套餐**：每月 5 美元信用额度 — 足以满足约 1,000–5,000 次工具调用
- 代理运行按返回 1,000 个项目计费（0.50 美元/1K 个项目）
- 此 MCP 服务器本身无需额外费用
---
## 🏗 开发
```bash
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
```
---
## 📄 许可证
MIT 许可证 — 见 [LICENSE](LICENSE)
---
## 🤝 贡献
在 [github.com/leadbrain/korean-data-mcp](https://github.com/leadbrain/korean-data-mcp) 上欢迎问题和 PR
---
*基于 [FastMCP](https://github.com/PrefectHQ/fastmcp) · 数据来自 [Apify](https://apify.com)*
<!-- mcp-name: io.github.leadbrain/korean-data -->
