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.io

Documentação

Voltar ao topo

Servidor MCP ​

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

O que é o Servidor MCP? ​

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

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

Casos de uso:

  • Pesquisar 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 instalação ou configuração necessária
  • Sempre atualizado com os recursos mais recentes
  • Disponibilidade e confiabilidade 24/7
  • Sem manutenção necessária
  • Basta adicionar sua chave de API e começar a usar

Como Conectar ​

Etapa 1: Obter a Chave de API ​

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

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

Etapa 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.

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

json

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

json

{
    "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 específicas por editor.

Etapa 3: Reinicie seu Assistente de IA ​

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

Como Usar ​

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

Exemplos Básicos ​

Pesquisar notícias:

texto

Find me the latest news about artificial intelligence

Filtrar por idioma:

texto

Show me news about Bitcoin in English

Obter notícias de última hora:

texto

What are the breaking news stories right now?

Pesquisar com sentimento:

texto

Find positive news about Tesla

Consultas Avançadas ​

O assistente de IA pode lidar com consultas complexas com vários filtros:

Múltiplos filtros:

texto

Find breaking news about climate change from verified sources published today

Requisitos específicos:

texto

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

Pesquisa por entidade:

texto

Find news mentioning Elon Musk and Tesla

Recursos Disponíveis ​

O servidor MCP suporta todos os recursos da API de Notícias:

  • Pesquisa 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 - Pesquise 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
  • Pesquisa por entidade - 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 ​

  1. Você faz uma pergunta em linguagem natural
  2. O assistente de IA converte em uma chamada de ferramenta MCP
  3. O servidor MCP traduz para uma solicitação da API de Notícias
  4. Os resultados são retornados ao assistente de IA
  5. 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: o mais recente 2025-11-25; o servidor negocia para 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 - Pesquise 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 (por exemplo, "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 - Analise o sentimento da cobertura sobre um tópico
  • breaking_news - Mostre as últimas notícias de última hora, opcionalmente por assunto e país
  • compare_coverage - Compare volume e sentimento da cobertura de 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 solicitações.

Solução de Problemas ​

Testando a Conexão do Servidor ​

Verifique se o servidor está disponível:

bash

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:

json

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

  1. Verifique se sua chave de API está correta em apitube.io
  2. Verifique a sintaxe do arquivo de configuração
  3. Garanta que sua chave de API seja passada pelo cabeçalho Authorization: Bearer YOUR_API_KEY — no bloco headers para Cursor, ou como o argumento --header para a ponte mcp-remote do Claude Desktop
  4. Reinicie seu assistente de IA
  5. 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 configurações da sua 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 as permissões correspondentes na configuração da chave, ou use uma chave com acesso total.

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 uma pesquisa de notícias real:

bash

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 comum, sem um assistente de IA:

bash

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 os fluxos de trabalho comuns para exemplos de consultas
  • Aprenda sobre os parâmetros disponíveis
  • Explore as opções de autenticação

Suporte ​

Se você encontrar problemas:

  1. Consulte as Perguntas Frequentes Técnicas
  2. Verifique sua chave de API em apitube.io
  3. Verifique os logs do servidor para erros
  4. Entre em contato com o suporte pelo site da APITube