Skip to main content

MCP server for collecting Korean news and trends from RSS feeds and Naver API

Project description

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)

uvx korean-news-mcp

Using pip

pip install korean-news-mcp

From source

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:

{
  "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
  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

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

# Run tests
pytest

# Run server locally
python -m korean_news_mcp.server

License

MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

korean_news_mcp-0.1.0.tar.gz (8.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

korean_news_mcp-0.1.0-py3-none-any.whl (7.2 kB view details)

Uploaded Python 3

File details

Details for the file korean_news_mcp-0.1.0.tar.gz.

File metadata

  • Download URL: korean_news_mcp-0.1.0.tar.gz
  • Upload date:
  • Size: 8.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.1

File hashes

Hashes for korean_news_mcp-0.1.0.tar.gz
Algorithm Hash digest
SHA256 4691c1ac62558776ab6c1e1c2652260fa5d488d31083f91a06479635d0fece63
MD5 b791aa9858fa4b44d7191bb5c3dab2e2
BLAKE2b-256 994186c8d55f694e532eda0a79c6659548791aba3be69c519a0c01e0b6e4e798

See more details on using hashes here.

File details

Details for the file korean_news_mcp-0.1.0-py3-none-any.whl.

File metadata

File hashes

Hashes for korean_news_mcp-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 3dc3c847855ce54c3caa1327e63ebe51cf48352e92218fdf47ef1f0d8a056ac6
MD5 551ea202e80ff916c30de2ed54eefe1e
BLAKE2b-256 cc33fda44f8c7b2005ef52c1e32c79b149a3fb636734f357d5b5053e1735f9b8

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page