APITube News MCP Server

Volver arriba

Servidor MCP ​

El servidor MCP (Protocolo de Contexto de Modelo) permite a los asistentes de IA acceder directamente a la API de Noticias sin escribir código. Esto permite que consultas en lenguaje natural como "encuentra las últimas noticias de IA" se conviertan automáticamente en solicitudes de API.

¿Qué es un servidor MCP? ​

Un servidor MCP es un puente entre asistentes de IA (como Cursor, Claude Desktop) y la API de Noticias. En lugar de escribir solicitudes de API manualmente, puedes hacer preguntas en lenguaje natural y la IA buscará noticias automáticamente usando la API de Noticias.

El servidor MCP está disponible en https://mcp.apitube.io/: listo para usar sin necesidad de instalación.

Casos de uso:

• Buscar artículos de noticias directamente desde tu asistente de IA
• Filtrar noticias por idioma, sentimiento, temas y más
• Obtener noticias de última hora
• Investigar temas específicos sin salir de tu IDE

Beneficios:

• No requiere instalación ni configuración
• Siempre actualizado con las últimas funciones
• Disponibilidad y confiabilidad 24/7
• No requiere mantenimiento
• Solo agrega tu clave de API y comienza a usarlo

Cómo conectarse ​

Paso 1: Obtener la clave de API ​

Primero, necesitas una clave de API de APITube:

1. Regístrate en apitube.io
2. Obtén tu clave de API personal
3. Mantenla segura

Paso 2: Configurar el cliente MCP ​

Agrega el servidor MCP a la configuración de tu asistente de IA. El servidor alojado habla HTTP JSON-RPC, así que pasa tu clave de API en el encabezado Authorization.

Para Cursor (~/.cursor/mcp.json, o .cursor/mcp.json en un proyecto):

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 en macOS). Claude Desktop lanza servidores MCP como procesos locales, así que conecta el servidor remoto con mcp-remote:

json

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

CONSEJO

¿Estás configurando VS Code, Windsurf o Claude Code? Consulta Configuración de Editores de Código para instrucciones específicas por editor.

Paso 3: Reiniciar tu asistente de IA ​

Después de agregar la configuración, reinicia Cursor o Claude Desktop para que los cambios surtan efecto.

Cómo usar ​

Una vez conectado, puedes hacer preguntas a tu asistente de IA en lenguaje natural:

Ejemplos básicos ​

Buscar noticias:

text

Find me the latest news about artificial intelligence

Filtrar por idioma:

text

Show me news about Bitcoin in English

Obtener noticias de última hora:

text

What are the breaking news stories right now?

Buscar con sentimiento:

text

Find positive news about Tesla

Consultas avanzadas ​

El asistente de IA puede manejar consultas complejas con múltiples filtros:

Múltiples filtros:

text

Find breaking news about climate change from verified sources published today

Requisitos específicos:

text

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

Búsqueda de entidades:

text

Find news mentioning Elon Musk and Tesla

Funciones disponibles ​

El servidor MCP soporta todas las funciones de la API de Noticias:

• Búsqueda por título/palabras clave - Encuentra artículos que coincidan con términos específicos
• Filtrado por idioma - Filtra por idioma (inglés, ruso, etc.)
• Análisis de sentimiento - Filtra por sentimiento positivo, negativo o neutro
• Rangos de fechas - Busca dentro de períodos de tiempo específicos
• Filtrado de medios - Encuentra artículos con imágenes o videos
• Calidad de la fuente - Filtra por fuentes verificadas o premium
• Noticias de última hora - Obtén solo historias de noticias de última hora
• Búsqueda de entidades - Encuentra noticias sobre personas, organizaciones o lugares específicos
• Filtrado por tema/categoría - Filtra por temas y categorías predefinidos

Detalles técnicos ​

Cómo funciona ​

1. Haces una pregunta en lenguaje natural
2. El asistente de IA la convierte en una llamada de herramienta MCP
3. El servidor MCP la traduce a una solicitud de la API de Noticias
4. Los resultados se devuelven al asistente de IA
5. La IA formatea y presenta las noticias para ti

Endpoints de la API ​

• Endpoint JSON-RPC: POST https://mcp.apitube.io/
• Versión del protocolo: la última 2025-11-25; el servidor negocia hacia abajo hasta la versión que tu cliente solicite (versiones anteriores como 2024-11-05 siguen siendo compatibles)
• Versión del servidor: 1.0.0

Herramientas disponibles ​

El servidor MCP proporciona las siguientes herramientas:

• search_news - Busca artículos de noticias con filtrado avanzado por idioma, categoría, sentimiento, entidades, contenido multimedia y más
• suggest - Resuelve un nombre o prefijo (por ejemplo, "Tesla") a los IDs de entidad/categoría/tema/industria de APITube, para que puedas usarlos en los filtros search_news (entity.id, category.id, topic.id, industry.id)

Prompts disponibles ​

Plantillas de consulta listas para usar (comandos de barra en clientes MCP), construidas sobre las herramientas anteriores:

• monitor_company - Rastrea noticias recientes y sentimiento sobre una empresa
• topic_sentiment - Desglosa el sentimiento de la cobertura sobre un tema
• breaking_news - Muestra las últimas noticias de última hora, opcionalmente por tema y país
• compare_coverage - Compara el volumen y el sentimiento de la cobertura para dos temas

Autenticación ​

El servidor MCP maneja automáticamente la autenticación utilizando la clave de API proporcionada en la configuración. La clave se pasa de forma segura en los encabezados de las solicitudes.

Solución de problemas ​

Probar la conexión del servidor ​

Verifica si el servidor está disponible:

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
  }'

Respuesta 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 con la clave de API ​

Si ves errores de autenticación:

1. Verifica que tu clave de API sea correcta en apitube.io
2. Revisa la sintaxis del archivo de configuración
3. Asegúrate de que tu clave de API se pase a través del encabezado Authorization: Bearer YOUR_API_KEY — en el bloque headers para Cursor, o como el argumento --header para el puente mcp-remote de Claude Desktop
4. Reinicia tu asistente de IA
5. Prueba con curl para verificar que la clave de API funcione

Errores de autenticación específicos:

• 401 con código ER0230 — tu clave de API ha caducado. Verifica o extiende la fecha de caducidad de la clave en la configuración de tu clave de API.
• 403 con código ER0603 — tu clave de API no tiene permitido llamar a las herramientas MCP (search_news, suggest). Otorga a la clave los permisos correspondientes en su configuración, o usa una clave que tenga acceso completo.

Problemas de conexión ​

Si no puedes conectarte a https://mcp.apitube.io/:

• Verifica tu conexión a internet
• Revisa la configuración del firewall
• Intenta acceder a la URL en un navegador

Probar con una consulta real ​

Prueba con una búsqueda de noticias 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: Acceso HTTP directo ​

También puedes usar el servidor MCP como una API HTTP regular sin un asistente 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
  }'

CONSEJO

El servidor en https://mcp.apitube.io/ está disponible 24/7 y no requiere configuración ni mantenimiento.

Siguientes pasos ​

• Revisa los flujos de trabajo comunes para ver ejemplos de consultas
• Aprende sobre los parámetros disponibles
• Explora las opciones de autenticación

Soporte ​

Si encuentras problemas:

1. Consulta las Preguntas Frecuentes Técnicas
2. Verifica tu clave de API en apitube.io
3. Revisa los registros del servidor para ver errores
4. Contacta al soporte a través del sitio web de APITube