Metadata-Version: 2.4
Name: korean-news-mcp
Version: 0.1.0
Summary: MCP server for collecting Korean news and trends from RSS feeds and Naver API
Project-URL: Homepage, https://github.com/LogiStic1207/korean-news-mcp
Project-URL: Repository, https://github.com/LogiStic1207/korean-news-mcp
Author: jespe
License-Expression: MIT
Keywords: korean,mcp,naver,news,trends
Classifier: Development Status :: 4 - Beta
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.10
Requires-Dist: feedparser>=6.0.0
Requires-Dist: httpx>=0.27.0
Requires-Dist: mcp>=1.0.0
Provides-Extra: dev
Requires-Dist: pytest-asyncio>=0.24.0; extra == 'dev'
Requires-Dist: pytest>=8.0.0; extra == 'dev'
Requires-Dist: respx>=0.22.0; extra == 'dev'
Description-Content-Type: text/markdown

# korean-news-mcp

MCP server for collecting Korean news and trending topics. Designed for global users who need real-time Korean market intelligence via Claude.

## Features

- **search_korean_news** — Search Korean news by keyword or browse latest headlines
- **get_trending_topics** — Get currently trending topics in Korea
- **get_news_by_category** — Filter news by category (politics, economy, tech, society, culture, sports, world)

## Data Sources

| Source | Type | Limit |
|--------|------|-------|
| Google News Korea RSS | Headlines, latest news | Unlimited, free |
| Naver Search API | Real-time search, trends | 25,000/day free |

## Installation

### Using uvx (recommended)

```bash
uvx korean-news-mcp
```

### Using pip

```bash
pip install korean-news-mcp
```

### From source

```bash
git clone https://github.com/YOUR_USERNAME/korean-news-mcp.git
cd korean-news-mcp
pip install -e .
```

## Configuration

### Claude Desktop

Add to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "korean-news": {
      "command": "uvx",
      "args": ["korean-news-mcp"],
      "env": {
        "NAVER_CLIENT_ID": "your_client_id",
        "NAVER_CLIENT_SECRET": "your_client_secret"
      }
    }
  }
}
```

### Naver API (optional but recommended)

1. Go to [Naver Developers](https://developers.naver.com/apps/)
2. Create a new application
3. Enable "Search" API
4. Copy your Client ID and Client Secret
5. Set them as environment variables or in the Claude Desktop config above

Without Naver API credentials, the server still works using RSS feeds only.

## Usage Examples

Once connected to Claude, you can ask:

- "Search Korean news about Samsung"
- "What's trending in Korea right now?"
- "Show me the latest Korean tech news"
- "한국 경제 뉴스 보여줘"

## Categories

| Category | Description |
|----------|-------------|
| `politics` | Korean politics |
| `economy` | Economy & finance |
| `tech` | Technology & IT |
| `society` | Society & social issues |
| `culture` | Culture & entertainment |
| `sports` | Sports |
| `world` | International news |

## Development

```bash
# Install dev dependencies
pip install -e ".[dev]"

# Run tests
pytest

# Run server locally
python -m korean_news_mcp.server
```

## License

MIT
