Naver Search

Pesquise em vários serviços Naver e analise tendências de dados usando as APIs Naver Search e DataLab.

Documentação

Servidor MCP Naver Search

Servidor MCP para integração com a API de Busca Naver e a API DataLab, permitindo buscas abrangentes em diversos serviços Naver e análise de tendências de dados.

Aviso de migração da API Naver (para referência)

A Naver está migrando as APIs de Busca, Tendências de Busca e Shopping Insights do Developer Center para o NAVER API HUB na plataforma Naver Cloud. Separadamente, as 3 APIs de busca serão totalmente descontinuadas.

Data	Descrição
2026-07-31	Novos pedidos de emissão de chaves serão bloqueados no Developer Center. As APIs de busca de Shopping, Livros e Materiais Especializados serão totalmente encerradas.
2027-06-30	O suporte ao Developer Center será encerrado e as chaves existentes também não poderão mais ser usadas.

Fonte: Aviso do Naver Developer Center — Encerramento dos serviços Search API, Search Trend e Shopping Insight e aviso de migração para o NAVER API HUB

É sua primeira instalação? Obtenha suas chaves no NAVER API HUB. O Developer Center não aceitará novos pedidos a partir de 2026-07-31, portanto não é mais o ponto de partida. O processo de emissão está detalhado passo a passo na seção Método A: NAVER API HUB abaixo.

Já está usando chaves do Developer Center? Nada precisa mudar. Elas continuarão funcionando até 2027-06-30, e esta versão suporta ambas as plataformas na mesma instalação. Quando chegar a hora de migrar, basta obter as chaves do HUB e alterar apenas duas variáveis de ambiente — nada mais precisa ser ajustado.

Plano de suporte deste servidor: Até 2027-06-30, conforme definido pela Naver, ambas as plataformas serão suportadas em paralelo. O caminho do Developer Center será removido em uma versão major separada somente depois que essa data passar e as chaves não funcionarem mais para ninguém. Até lá, atualizar a versão não interromperá sua configuração atual.

Na versão 1.0.49, 3 ferramentas foram removidas: search_shop, search_book, search_academic. Como a Naver encerrará essas APIs de busca em 2026-07-31 e não há APIs substitutas em nenhuma plataforma, este servidor não tem como mantê-las. O Insights de Shopping (datalab_shopping_*) e find_category são APIs separadas e não são afetados.

Suporte ao ClawHub para OpenClaw

Este servidor MCP está distribuído como uma skill do ClawHub para OpenClaw:

openclaw skills install naver-search-mcp

A skill do ClawHub usa internamente o pacote publicado no npm e requer a configuração de um par de credenciais no ambiente OpenClaw — o par do NAVER API HUB (NCP_APIGW_API_KEY_ID / NCP_APIGW_API_KEY) ou o par do Developer Center (NAVER_CLIENT_ID / NAVER_CLIENT_SECRET). Como o campo apiKey do OpenClaw é mapeado para NAVER_CLIENT_SECRET, usuários do HUB devem definir as duas variáveis do HUB diretamente no ambiente, em vez de apiKey.

Início rápido: uso sem chave de API (encerrado)

Aviso: Devido à mudança de política da API Naver (2026.09), o serviço de uso imediato Kakao PlayMCP foi encerrado.

Detalhes das ferramentas

Ferramentas disponíveis:

🆕 Busca de categoria

find_category: Ferramenta de busca de categoria — agora não é mais necessário procurar manualmente os números de categoria por URL para buscas de tendências e shopping insights. Basta pesquisar em linguagem natural.

Ferramentas de busca

search_webkr: Busca em documentos web
search_news: Busca de notícias
search_blog: Busca em blogs
search_cafearticle: Busca em posts de café
search_image: Busca de imagens
search_kin: Busca no Knowledge iN
search_encyc: Busca em enciclopédias
search_local: Busca de lugares locais

Removidas na 1.0.49: search_shop, search_book, search_academic A Naver encerrará as APIs de busca de Shopping, Livros e Materiais Especializados em 2026-07-31, sem APIs substitutas. O Insights de Shopping (datalab_shopping_*) é uma API separada e não é afetado.

Ferramentas DataLab

datalab_search: Análise de tendências de termos de busca
datalab_shopping_category: Análise de tendências por categoria de compras
datalab_shopping_by_device: Análise de tendências de compras por dispositivo
datalab_shopping_by_gender: Análise de tendências de compras por gênero
datalab_shopping_by_age: Análise de tendências de compras por faixa etária
datalab_shopping_keywords: Análise de tendências de palavras-chave de compras
datalab_shopping_keyword_by_device: Análise de tendências de palavras-chave de compras por dispositivo
datalab_shopping_keyword_by_gender: Análise de tendências de palavras-chave de compras por gênero
datalab_shopping_keyword_by_age: Análise de tendências de palavras-chave de compras por idade

Como obter chaves de API

Este servidor utiliza chaves emitidas por uma das duas plataformas. Configure apenas um par de variáveis de ambiente — o princípio de qual plataforma será usada com base no par configurado está descrito em Configuração abaixo.

Método A: NAVER API HUB (recomendado — o caminho futuro)

Cadastre-se ou faça login no Console da plataforma Naver Cloud
Clique no botão de seleção de região e plataforma no canto superior direito da tela do console, escolha sua região e plataforma e clique em Aplicar
Clique em Menu > All Services > Application Services > NAVER API HUB
Clique no menu Application à esquerda, selecione (ou crie) um aplicativo e clique no botão Credenciais em Gerenciamento de API
Copie o Client ID e o Client Secret exibidos na janela pop-up
Na configuração abaixo, use o Client ID como NCP_APIGW_API_KEY_ID e o Client Secret como NCP_APIGW_API_KEY

Método B: Naver Developer Center (existente — apenas para quem já possui chaves)

O Naver Developer Center não aceitará novos registros de aplicativos a partir de 2026-07-31. Se você ainda não tem um Client ID/Secret desta plataforma, use o NAVER API HUB acima. As chaves existentes do Developer Center continuarão funcionando até 2027-06-30.

Visite Naver Developers e faça login com sua conta Naver
Clique no botão "Registrar aplicativo"
Preencha as informações do aplicativo:
- Nome do aplicativo: Digite um nome de sua escolha (ex.: "Naver Search MCP")
- APIs usadas: Selecione "Busca"
Nas configurações de API, marque todas as seguintes APIs:
- Busca — necessária para blogs, notícias, posts de café, documentos web, imagens, Knowledge iN, enciclopédias e busca local
- DataLab - Tendências de termos de busca — necessária para análise de tendências de termos de busca
- DataLab - Shopping Insights — necessária para análise de tendências de compras
Clique no botão "Registrar" para concluir o registro
Após o registro, verifique o Client ID e o Client Secret na página de detalhes do aplicativo
Use-os como NAVER_CLIENT_ID / NAVER_CLIENT_SECRET na configuração abaixo

Configuração

Credenciais

Suporta duas plataformas. Configure apenas um par. Como não é possível distinguir a plataforma apenas pela string da chave, a plataforma é determinada pela variável de ambiente em que a chave é inserida.

Variável de ambiente	Plataforma	Destino da chamada
`NCP_APIGW_API_KEY_ID`, `NCP_APIGW_API_KEY`	NAVER API HUB (NCP)	`naverapihub.apigw.ntruss.com`
`NAVER_CLIENT_ID`, `NAVER_CLIENT_SECRET`	Naver Developer Center (existente)	`openapi.naver.com`

Se ambos os pares forem configurados, o NAVER API HUB será usado.

Os exemplos de instalação abaixo usam o par existente NAVER_CLIENT_ID / NAVER_CLIENT_SECRET. Se você tiver chaves do NAVER API HUB, substitua pelo par do HUB indicado na tabela acima.

Aviso de migração do NAVER API HUB

A Naver está migrando estas APIs do Developer Center para o NAVER API HUB na plataforma Naver Cloud.

Data	Descrição
2026-06-25	Lançamento do NAVER API HUB
2026-07-31	Bloqueio de novos pedidos no Developer Center
2027-06-30	Fim do suporte ao Developer Center — chaves existentes também não poderão ser usadas

As chaves existentes continuarão funcionando até 2027-06-30. Para migrar, obtenha as chaves do NAVER API HUB no console da plataforma Naver Cloud e insira-as em NCP_APIGW_API_KEY_ID / NCP_APIGW_API_KEY. As chaves do Developer Center não podem ser usadas no NAVER API HUB.

Instalação

Método 1: Instalação via NPX (recomendado)

A maneira mais estável de usar este servidor MCP é a instalação direta via NPX. Consulte a página do pacote NPM para mais informações.

Configuração do Claude Desktop

Adicione o seguinte ao arquivo de configuração do Claude Desktop (Windows: %APPDATA%\Claude\claude_desktop_config.json, macOS/Linux: ~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "naver-search": {
      "command": "npx",
      "args": ["-y", "@isnow890/naver-search-mcp"],
      "env": {
        "NAVER_CLIENT_ID": "your_client_id",
        "NAVER_CLIENT_SECRET": "your_client_secret"
      }
    }
  }
}

Configuração do Claude Code

Adicione o seguinte à configuração do Claude Code:

{
  "mcpServers": {
    "naver-search": {
      "command": "npx",
      "args": ["-y", "@isnow890/naver-search-mcp"],
      "env": {
        "NAVER_CLIENT_ID": "your_client_id",
        "NAVER_CLIENT_SECRET": "your_client_secret"
      }
    }
  }
}

Método 2: Instalação via ClawHub para OpenClaw

Este servidor MCP também pode ser usado no OpenClaw por meio do wrapper de skill do ClawHub. Instale com o seguinte comando:

openclaw skills install naver-search-mcp

A skill do ClawHub usa internamente o mesmo pacote npm:

npx -y @isnow890/naver-search-mcp

Antes de usar, é necessário configurar um par de credenciais no ambiente OpenClaw — o par do NAVER API HUB (NCP_APIGW_API_KEY_ID / NCP_APIGW_API_KEY) ou o par do Developer Center (NAVER_CLIENT_ID / NAVER_CLIENT_SECRET). Como o apiKey do OpenClaw é mapeado para NAVER_CLIENT_SECRET, usuários do HUB devem definir as duas variáveis do HUB diretamente, em vez de apiKey.

Método 3: Instalação local

Para desenvolvimento local ou modificações personalizadas:

Etapa 1: Baixar e compilar o código-fonte

Clonar via Git

git clone https://github.com/isnow890/naver-search-mcp.git
cd naver-search-mcp
npm install
npm run build

Ou baixar como arquivo ZIP

Baixe a versão mais recente na página de releases do GitHub
Extraia o arquivo ZIP para o local desejado
No terminal, navegue até a pasta extraída:

cd /path/to/naver-search-mcp
npm install
npm run build

⚠️ Importante: Após a instalação, execute npm run build para gerar a pasta dist com os arquivos JavaScript compilados.

Etapa 2: Configuração do Claude Desktop

Após a compilação, você precisará das seguintes informações:

NAVER_CLIENT_ID: O Client ID emitido pelo Naver Developers
NAVER_CLIENT_SECRET: O Client Secret emitido pelo Naver Developers
Caminho de instalação: O caminho absoluto da pasta baixada

Configuração no Windows

Adicione o seguinte ao arquivo de configuração do Claude Desktop (%APPDATA%\Claude\claude_desktop_config.json):

{
  "mcpServers": {
    "naver-search": {
      "type": "stdio",
      "command": "cmd",
      "args": [
        "/c",
        "node",
        "C:\\path\\to\\naver-search-mcp\\dist\\src\\index.js"
      ],
      "cwd": "C:\\path\\to\\naver-search-mcp",
      "env": {
        "NAVER_CLIENT_ID": "your-naver-client-id",
        "NAVER_CLIENT_SECRET": "your-naver-client-secret"
      }
    }
  }
}

Configuração no macOS/Linux

Adicione o seguinte ao arquivo de configuração do Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "naver-search": {
      "type": "stdio",
      "command": "node",
      "args": ["/path/to/naver-search-mcp/dist/src/index.js"],
      "cwd": "/path/to/naver-search-mcp",
      "env": {
        "NAVER_CLIENT_ID": "your-naver-client-id",
        "NAVER_CLIENT_SECRET": "your-naver-client-secret"
      }
    }
  }
}

Atenção à configuração de caminhos

⚠️ Importante: Na configuração acima, altere os seguintes caminhos para o caminho real de instalação:

Windows: Altere C:\\path\\to\\naver-search-mcp para o caminho real da pasta baixada
macOS/Linux: Altere /path/to/naver-search-mcp para o caminho real da pasta baixada
Caminho de compilação: Verifique se o caminho aponta para dist/src/index.js (e não apenas index.js)

Para encontrar o caminho:

# 현재 위치 확인
pwd

# 절대 경로 예시
# Windows: C:\Users\홍길동\Downloads\naver-search-mcp
# macOS: /Users/홍길동/Downloads/naver-search-mcp
# Linux: /home/홍길동/Downloads/naver-search-mcp

Etapa 3: Reiniciar o Claude Desktop

Após a configuração, feche completamente o Claude Desktop e reinicie-o para que o servidor MCP Naver Search seja ativado.

Requisitos

Credenciais de uma das duas plataformas — NAVER API HUB ou Naver Developers (consulte Como obter chaves de API)
Node.js 18 ou superior
NPM 8 ou superior

Licença

Licença MIT

Histórico de versões

1.0.49 (2026-07-26)

Suporte ao NAVER API HUB: ao configurar NCP_APIGW_API_KEY_ID / NCP_APIGW_API_KEY, as chamadas passam a usar a nova plataforma. O par existente NAVER_CLIENT_ID / NAVER_CLIENT_SECRET continua funcionando, e a plataforma é determinada pelo par de variáveis configurado
Remoção de search_shop, search_book, search_academic. A Naver encerrará essas APIs de busca em 2026-07-31, sem substitutos em nenhuma plataforma
Erros de API agora são lançados como Error genéricos em vez de AxiosError brutos. Códigos que faziam ramificação com error.response?.status agora verão undefined, e as mesmas informações estarão em Error.message
Mensagens de erro agora exibem a plataforma e o status HTTP; em caso de 401, há uma orientação para verificar se a chave não foi inserida em variáveis de outra plataforma

1.0.48 (2026-05-12)

Correção para que find_category leia corretamente os dados de categoria mesmo quando o diretório de trabalho atual for diferente ao executar com npx
Os dados de categoria agora são procurados primeiro com base no local do pacote instalado, usando o caminho de desenvolvimento local apenas como fallback

1.0.47 (2025-01-03)

Adicionado suporte à palavra-chave "today" — dispensa chamadas separadas de ferramenta de tempo em todos os parâmetros de data do DataLab
Correção do problema de encerramento do servidor — o servidor MCP agora encerra corretamente quando o cliente desconecta
Adicionados manipuladores de encerramento gracioso — tratamento dos eventos SIGINT, SIGTERM e fechamento de transporte
Removida a ferramenta get_current_korean_time — redundante com o recurso da palavra-chave "today"
Removido o módulo de monitoramento de memória — corrigido o problema que impedia o encerramento do processo devido ao setInterval
Agradecimentos a @gloomyrobot — por relatar o problema de encerramento do servidor, o que permitiu sua correção

1.0.45 (2025-09-28)

Corrigidos problemas de compatibilidade com ambientes de instalação MCP hospedados
Corrigido problema de compatibilidade com Excel na busca de categorias — substituído pelo recurso JSON
Restaurada a funcionalidade de busca web em coreano (search_webkr)
Melhorada a compatibilidade de instalação com plataformas hospedadas

1.0.44 (2025-08-31)

Adicionada a ferramenta get_current_korean_time — ferramenta essencial de contexto de tempo para o fuso horário coreano
Descrições de todas as ferramentas existentes reforçadas com referências à ferramenta de tempo para consultas temporais
Melhorado o tratamento de contexto temporal para buscas com "hoje", "agora" e "atualmente"
Formatação abrangente de horário coreano em diversos formatos de saída

1.0.40 (2025-08-21)

Adicionada a ferramenta find_category Agora não é mais necessário procurar manualmente os números de categoria por URL para buscas de tendências e shopping insights. Basta pesquisar em linguagem natural.
Validação de parâmetros reforçada com esquemas Zod
Fluxo de busca de categorias melhorado
Sistema de ranqueamento de categorias por nível implementado (categorias principais primeiro)

1.0.30 (2025-08-04)

Atualização para o MCP SDK 1.17.1
Corrigidos erros de compatibilidade devido a mudanças nas especificações da plataforma MCP hospedada
Documentação detalhada dos códigos de categoria de compras do DataLab adicionada

1.0.2 (2025-04-26)

Atualização do README: melhorias nas instruções sobre a ferramenta de busca em posts de café e no histórico de versões

1.0.1 (2025-04-26)

Adicionada a funcionalidade de busca em posts de café
Adicionadas informações de categorias de compras ao zod
Refatoração do código-fonte

1.0.0 (2025-04-08)

Lançamento inicial