MCP Naver News

Pesquise artigos de notícias usando a API do Naver News. Requer credenciais da API do Naver News.

GitHub

Documentação

English | 한국어

MCP Naver News

License PyPI Version PyPI Downloads

Servidor Model Context Protocol (MCP) para a API de Notícias do Naver. Esta integração permite interações seguras e contextuais com IA nas notícias do Naver, mantendo a privacidade e segurança dos dados.

Exemplos de uso

Você pode solicitar ao assistente de IA, por exemplo:

  • 📰 Busca de notícias - "Encontre notícias recentes sobre a Samsung Electronics"
  • 🔍 Análise de notícias - "Mostre as notícias de tecnologia mais recentes"
  • 📊 Tendências de notícias - "Quais tópicos estão em alta nas notícias de economia?"
  • ⚡ Atualizações em tempo real - "Traga as notícias mais recentes sobre desenvolvimento de IA"

Demonstração de recursos

[O vídeo de demonstração será adicionado aqui]

Compatibilidade

RecursoStatus de suporteDescrição
Busca de notícias✅ Suporte totalBusca de artigos de notícias com vários parâmetros
Ordenação de notícias✅ Suporte totalOrdenação por data ou relevância
Filtragem de notícias✅ Suporte totalFiltragem por intervalo de datas e outros critérios

Guia de início rápido

1. Configuração de autenticação

Primeiro, obtenha suas credenciais da API de Notícias do Naver:

  1. Visite o Centro de Desenvolvedores Naver
  2. Registre um aplicativo
  3. Solicite acesso à API de busca de notícias
  4. Obtenha o Client ID e o Client Secret

2. Instalação

# 저장소 클론
git clone https://github.com/ChangooLee/mcp-naver-news.git
cd mcp-naver-news

# [중요] Python 3.10 이상 사용 필수. 아래 'Python 3.10+ 설치 안내' 참고

# 가상 환경 생성
python3.10 -m venv .venv
source .venv/bin/activate

# 패키지 설치
# python 3.10 이상이 필요 
python3 -m pip install --upgrade pip
pip install -e .

Guia de instalação do Python 3.10+

Verifique a versão do Python (necessário 3.10 ou superior)

python3 --version

Se a versão do Python for inferior a 3.10, siga as instruções abaixo para instalar o Python 3.10 ou superior:

macOS

  • Baixe o instalador mais recente do Python no site oficial: https://www.python.org/downloads/macos/
  • Ou, se usar Homebrew: 
    brew install python@3.10
    Após a instalação, pode ser necessário usar o comando python3.10.

Windows

  • Baixe e execute o instalador mais recente do Python no site oficial: https://www.python.org/downloads/windows/
  • Marque a opção "Add Python to PATH" durante a instalação.
  • Após a instalação, reinicie o terminal e use o comando python ou python3.

Linux (Ubuntu/Debian)

  • Atualize a lista de pacotes e instale o Python 3.10: 
    sudo apt update
sudo apt install python3.10 python3.10-venv python3.10-distutils
  • Pode ser necessário usar o comando python3.10.

Linux (Fedora/CentOS/RHEL)

  • Instale o Python 3.10: 
    sudo dnf install python3.10

Integração com IDE

O MCP Naver News foi projetado para ser usado com assistentes de IA por meio de integração com IDE.

Configuração do Claude Desktop

  1. Menu hambúrguer (☰) > Configurações > Desenvolvedor > Clique no botão "Editar configurações"
  2. Adicione a seguinte configuração:
{
  "mcpServers": {
    "mcp-naver-news": {
      "command": "YOUR_LOCATION/.venv/bin/mcp-naver-news",
      "env": {
        "X_NAVER_CLIENT_ID": "YOUR_CLIENT_ID",
        "X_NAVER_CLIENT_SECRET": "YOUR_CLIENT_SECRET",
        "MCP_SERVER_NAME": "mcp-naver-news",
        "MCP_HOST": "0.0.0.0",
        "MCP_PORT": "8000",
        "TRANSPORT": "stdio",
        "LOG_LEVEL": "INFO"
      }
    }
  }
}

[!NOTE]

  • YOUR_LOCATION: Substitua pelo caminho real onde o ambiente virtual está instalado
  • YOUR_CLIENT_ID: Substitua pelo seu Client ID da API Naver
  • YOUR_CLIENT_SECRET: Substitua pelo seu Client Secret da API Naver

Variáveis de ambiente

  • X_NAVER_CLIENT_ID: Client ID da API Naver
  • X_NAVER_CLIENT_SECRET: Client Secret da API Naver
  • MCP_SERVER_NAME: Nome do servidor (padrão: mcp-naver-news)
  • MCP_HOST: Host do servidor (padrão: 0.0.0.0)
  • MCP_PORT: Porta do servidor (padrão: 8000)
  • LOG_LEVEL: Nível de log (INFO, DEBUG, etc.)
  • LOG_FILE: Caminho do arquivo de log (padrão: naver_news.log)

Ferramentas

Ferramentas de notícias do Naver

Estratégia de análise recomendada: Para uma análise de notícias rápida e aprofundada, use search_news para pesquisar e filtrar rapidamente os artigos candidatos. Em seguida, somente quando for necessária uma compreensão mais profunda ou análise do texto completo, use search_news_detail para extrair e analisar o conteúdo de forma robusta. Este fluxo de trabalho em duas etapas oferece tanto exploração ampla quanto insights precisos.

  • search_news: Retorna rapidamente apenas os resultados da API de Notícias do Naver (título, resumo, link, etc.). Não extrai o texto completo do artigo. Adequado para exploração rápida e resumo de palavras-chave; deve ser usado primeiro.
  • search_news_detail: Após a filtragem inicial com search_news, extrai o texto completo do artigo de forma robusta a partir da página real do artigo. Use somente quando o texto completo preciso do artigo for necessário.

Fluxo de trabalho recomendado

  1. Use search_news para verificar rapidamente a lista de resumos de artigos por palavra-chave.
  2. Para artigos de interesse, use search_news_detail para extrair o texto completo de forma robusta e fazer uma análise aprofundada.
Parâmetros das ferramentas
FerramentaParâmetroTipoDescrição
search_newsquerystringPalavra-chave de busca
displayintegerNúmero de resultados a exibir (padrão: 10)
startintegerPosição inicial dos resultados (padrão: 1)
sortstringOpção de ordenação (sim: relevância, date: data)
search_news_detailquerystringPalavra-chave de busca
displayintegerNúmero de resultados a exibir (padrão: 10)
startintegerPosição inicial dos resultados (padrão: 1)
sortstringOpção de ordenação (sim: relevância, date: data)
include_contentboolIncluir texto completo do artigo (padrão: true)

Solução de problemas e depuração

Problemas comuns

  • Falha de autenticação:

    • Verifique se o Client ID e o Secret são válidos
    • Verifique se as credenciais da API têm as permissões necessárias
    • Verifique se o limite de chamadas da API foi excedido

  • Problemas de acesso a dados:

    • Alguns dados podem exigir permissões adicionais
    • Verifique se os parâmetros de busca são válidos
    • Verifique se a consulta está formatada corretamente

  • Problemas de conexão:

    • Verifique a conexão com a internet
    • Verifique a disponibilidade do serviço da API Naver
    • Verifique se o firewall não está bloqueando a conexão

Ferramentas de depuração

# 상세 로깅 활성화
export LOG_LEVEL=DEBUG

# 로그 보기
tail -f naver_news.log

# API 연결 테스트
python -m mcp_naver_news test-connection

Segurança

  • Nunca compartilhe suas credenciais de API
  • Mantenha o arquivo .env seguro e privado
  • Use limites de taxa apropriados
  • Monitore o uso da API
  • Armazene dados sensíveis em variáveis de ambiente

Contribuição

Contribuições são bem-vindas! Para contribuir:

  1. Faça um fork do repositório
  2. Crie um branch de funcionalidade
  3. Aplique suas alterações
  4. Envie um pull request

Licença

Este projeto pode ser usado apenas para fins não comerciais e pessoais. Uso comercial, redistribuição e uso comercial de obras derivadas são estritamente proibidos.

Consulte o arquivo LICENSE para condições detalhadas.

Este não é um produto oficial da Naver. Naver é uma marca registrada da Naver Corporation.