APITube News MCP Server

Servidor MCP hospedado para a APITube News API: pesquise artigos em mais de 500.000 fontes em mais de 60 idiomas, filtrados por sentimento, entidades, tópicos e qualidade da fonte.

Ver em apitube.ioExperimente este MCPPatrocinado

Documentação

O servidor MCP (Model Context Protocol) permite que assistentes de IA acessem diretamente a News API sem escrever código. Isso possibilita que consultas em linguagem natural, como "encontre as últimas notícias de IA", sejam convertidas automaticamente em requisições de API.

O que é o MCP Server?

O MCP Server é uma ponte entre assistentes de IA (como Cursor, Claude Desktop) e a News API. Em vez de escrever requisições de API manualmente, você pode fazer perguntas em linguagem natural, e a IA buscará notícias automaticamente usando a News API.

O servidor MCP está disponível em https://mcp.apitube.io/ - pronto para uso, sem necessidade de instalação.

Casos de uso:

Buscar artigos de notícias diretamente do seu assistente de IA
Filtrar notícias por idioma, sentimento, tópicos e muito mais
Obter notícias de última hora
Pesquisar tópicos específicos sem sair do seu IDE

Benefícios:

Sem necessidade de instalação ou configuração
Sempre atualizado com os recursos mais recentes
Disponibilidade e confiabilidade 24/7
Sem necessidade de manutenção
Basta adicionar sua chave de API e começar a usar

Como Conectar

Passo 1: Obter Chave de API

Primeiro, você precisa de uma chave de API do APITube:

Cadastre-se em apitube.io
Obtenha sua chave de API pessoal
Mantenha-a segura

Passo 2: Configurar o Cliente MCP

Adicione o servidor MCP à configuração do seu assistente de IA. O servidor hospedado fala HTTP JSON-RPC, então passe sua chave de API no cabeçalho Authorization.

Instalação com um clique

No Cursor ou VS Code, você pode pular o arquivo de configuração completamente — a página Configuração de Editores de Código gera um link de instalação com sua chave já incluída.

Para Cursor (~/.cursor/mcp.json, ou .cursor/mcp.json em um projeto):

{
    "mcpServers": {
        "apitube-news": {
            "url": "https://mcp.apitube.io/",
            "headers": {
                "Authorization": "Bearer YOUR_API_KEY"
            }
        }
    }
}

Para Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json no macOS). O Claude Desktop inicia servidores MCP como processos locais, então faça a ponte com o servidor remoto usando mcp-remote:

{
    "mcpServers": {
        "apitube-news": {
            "command": "npx",
            "args": [
                "-y",
                "mcp-remote",
                "https://mcp.apitube.io/",
                "--header",
                "Authorization: Bearer YOUR_API_KEY"
            ]
        }
    }
}

DICA

Configurando VS Code, Windsurf ou Claude Code? Veja Configuração de Editores de Código para instruções por editor.

Passo 3: Reinicie Seu Assistente de IA

Após adicionar a configuração, reinicie o Cursor ou Claude Desktop para que as alterações tenham efeito.

Como Usar

Uma vez conectado, você pode fazer perguntas em linguagem natural ao seu assistente de IA:

Exemplos Básicos

Buscar notícias:

Find me the latest news about artificial intelligence

Filtrar por idioma:

Show me news about Bitcoin in English

Obter notícias de última hora:

What are the breaking news stories right now?

Buscar com sentimento:

Find positive news about Tesla

Consultas Avançadas

O assistente de IA pode lidar com consultas complexas com múltiplos filtros:

Múltiplos filtros:

Find breaking news about climate change from verified sources published today

Requisitos específicos:

Show me long-form articles about SpaceX with images, published in the last week

Busca por entidades:

Find news mentioning Elon Musk and Tesla

Recursos Disponíveis

O servidor MCP suporta todos os recursos da News API:

Busca por título/palavras-chave - Encontre artigos que correspondam a termos específicos
Filtro por idioma - Filtre por idioma (inglês, russo, etc.)
Análise de sentimento - Filtre por sentimento positivo, negativo ou neutro
Intervalos de datas - Busque dentro de períodos específicos
Filtro de mídia - Encontre artigos com imagens ou vídeos
Qualidade da fonte - Filtre por fontes verificadas ou premium
Notícias de última hora - Obtenha apenas notícias de última hora
Busca por entidades - Encontre notícias sobre pessoas, organizações ou locais específicos
Filtro por tópico/categoria - Filtre por tópicos e categorias predefinidos

Detalhes Técnicos

Como Funciona

Você faz uma pergunta em linguagem natural
O assistente de IA converte em uma chamada de ferramenta MCP
O servidor MCP traduz para uma requisição da News API
Os resultados são retornados ao assistente de IA
A IA formata e apresenta as notícias para você

Endpoints da API

Endpoint JSON-RPC: POST https://mcp.apitube.io/
Versão do protocolo: 2025-11-25 mais recente; o servidor negocia para baixo até a versão que seu cliente solicitar (versões mais antigas, como 2024-11-05, permanecem suportadas)
Versão do servidor: 1.0.0

Ferramentas Disponíveis

O servidor MCP fornece as seguintes ferramentas:

search_news - Busque artigos de notícias com filtros avançados por idioma, categoria, sentimento, entidades, conteúdo de mídia e muito mais
suggest - Resolva um nome ou prefixo (ex.: "Tesla") para IDs de entidade/categoria/tópico/indústria da APITube, para que você possa usá-los nos filtros search_news (entity.id, category.id, topic.id, industry.id)

Prompts Disponíveis

Modelos de consulta prontos (comandos de barra em clientes MCP), construídos sobre as ferramentas acima:

monitor_company - Acompanhe notícias recentes e sentimento sobre uma empresa
topic_sentiment - Detalhe o sentimento da cobertura sobre um tópico
breaking_news - Apresente as últimas notícias de última hora, opcionalmente por assunto e país
compare_coverage - Compare volume e sentimento da cobertura para dois assuntos

Autenticação

O servidor MCP lida automaticamente com a autenticação usando a chave de API fornecida na configuração. A chave é passada com segurança nos cabeçalhos das requisições.

Solução de Problemas

Testando a Conexão com o Servidor

Verifique se o servidor está disponível:

curl -X POST https://mcp.apitube.io/ \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "initialize",
    "params": {
      "protocolVersion": "2024-11-05",
      "capabilities": {},
      "clientInfo": {"name": "test", "version": "1.0.0"}
    },
    "id": 1
  }'

Resposta esperada:

{
  "jsonrpc": "2.0",
  "result": {
    "protocolVersion": "2024-11-05",
    "serverInfo": {
      "name": "APITube News MCP-Server",
      "version": "1.0.0"
    },
    "capabilities": {
      "tools": {"listChanged": true},
      "prompts": {"listChanged": true}
    }
  }
}

Problemas com a Chave de API

Se você vir erros de autenticação:

Verifique se sua chave de API está correta em apitube.io
Verifique a sintaxe do arquivo de configuração
Garanta que sua chave de API seja passada via cabeçalho Authorization: Bearer YOUR_API_KEY — no bloco headers para Cursor, ou como argumento --header para a ponte mcp-remote do Claude Desktop
Reinicie seu assistente de IA
Tente testar com curl para verificar se a chave de API funciona

Erros de autenticação específicos:

401 com código ER0230 — sua chave de API expirou. Verifique ou estenda a data de expiração da chave nas suas configurações de chave de API.
403 com código ER0603 — sua chave de API não tem permissão para chamar as ferramentas MCP (search_news, suggest). Conceda à chave as permissões correspondentes nas configurações, ou use uma chave com acesso total.
503 com código ER0900 — o servidor não pôde verificar a chave porque o banco de dados não respondeu. A chave em si está correta: tente novamente em alguns segundos em vez de emitir uma nova.
403 com código ER0706 — o servidor MCP não está disponível no plano Free. Faça upgrade da assinatura para usá-lo.

Problemas de Conexão

Se você não conseguir conectar a https://mcp.apitube.io/:

Verifique sua conexão com a internet
Verifique as configurações do firewall
Tente acessar a URL em um navegador

Testando com uma Consulta Real

Teste com busca de notícias real:

curl -X POST https://mcp.apitube.io/ \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "params": {
      "name": "search_news",
      "arguments": {
        "title": "Bitcoin",
        "per_page": 5
      }
    },
    "id": 1
  }'

Alternativa: Acesso HTTP Direto

Você também pode usar o servidor MCP como uma API HTTP regular, sem um assistente de IA:

curl -X POST https://mcp.apitube.io/ \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "params": {
      "name": "search_news",
      "arguments": {
        "title": "AI technology",
        "language": {"code": "en"},
        "is_breaking": 1
      }
    },
    "id": 1
  }'

DICA

O servidor em https://mcp.apitube.io/ está disponível 24/7 e não requer configuração ou manutenção.

Próximos Passos

Confira fluxos de trabalho comuns para exemplos de consultas
Aprenda sobre parâmetros disponíveis
Explore opções de autenticação

Suporte

Se você encontrar problemas:

Verifique o FAQ Técnico
Verifique sua chave de API em apitube.io
Verifique os logs do servidor para erros
Entre em contato com o suporte pelo site da APITube