APITube News MCP Server

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 "encuéntrame las últimas noticias de IA" se conviertan automáticamente en solicitudes a la API.

¿Qué es un Servidor MCP?

Un Servidor MCP es un puente entre los asistentes de IA (como Cursor, Claude Desktop) y la API de Noticias. En lugar de escribir manualmente solicitudes a la API, puedes hacer preguntas en lenguaje natural y la IA buscará automáticamente noticias 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:

• Sin necesidad de instalación ni configuración
• Siempre actualizado con las últimas funciones
• Disponibilidad y fiabilidad 24/7
• Sin necesidad de mantenimiento
• Solo añade tu clave de API y comienza a usar

Cómo Conectarse

Paso 1: Obtener 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

Añade 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.

Instalación con un clic

En Cursor o VS Code puedes omitir el archivo de configuración por completo: la página de Configuración de Editores de Código genera un enlace de instalación con tu clave ya incluida.

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

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

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

CONSEJO

¿Configurando VS Code, Windsurf o Claude Code en su lugar? Consulta Configuración de Editores de Código para instrucciones por editor.

Paso 3: Reiniciar tu Asistente de IA

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

Cómo Usar

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

Ejemplos Básicos

Buscar noticias:

Find me the latest news about artificial intelligence

Filtrar por idioma:

Show me news about Bitcoin in English

Obtener noticias de última hora:

What are the breaking news stories right now?

Buscar con sentimiento:

Find positive news about Tesla

Consultas Avanzadas

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

Múltiples 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

Búsqueda de entidades:

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 neutral
• 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 fuente - Filtra por fuentes verificadas o premium
• Noticias de última hora - Obtén solo 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 a la API de Noticias
4. Los resultados se devuelven al asistente de IA
5. La IA formatea y presenta las noticias

Endpoints de API

• Endpoint JSON-RPC: POST https://mcp.apitube.io/
• Versión del protocolo: última 2025-11-25; el servidor negocia hacia abajo a la versión que solicite tu cliente (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 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 volumen y sentimiento de cobertura para dos temas

Autenticación

El servidor MCP maneja automáticamente la autenticación usando 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

Comprueba si el servidor está disponible:

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:

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

Errores de autenticación específicos:

• 401 con código ER0230 — tu clave de API ha expirado. Comprueba o extiende la fecha de expiración de la clave en tu configuración de clave de API.
• 403 con código ER0603 — tu clave de API no tiene permiso para 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.
• 503 con código ER0900 — el servidor no pudo verificar la clave porque su base de datos no respondió. La clave en sí está bien: reintenta en unos segundos en lugar de emitir una nueva.
• 403 con código ER0706 — el servidor MCP no está disponible en el plan Gratuito. Mejora la suscripción para usarlo.

Problemas de Conexión

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

• Comprueba tu conexión a internet
• Verifica 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:

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:

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.

Próximos Pasos

• Consulta flujos de trabajo comunes para ejemplos de consultas
• Aprende sobre parámetros disponibles
• Explora 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