AllNewsAPI
Búsqueda de noticias en vivo, titulares principales y uso de API a través de AllNewsAPI, con filtrado de sentimiento y entidades mediante IA.
Servidor MCP alojado
npx add-mcp 'https://mcp.allnewsapi.com/mcp'Se instala en Claude Code, Codex, Cursor y más
Documentación
AllNewsAPI MCP
Obtén acceso a datos de noticias en tiempo real e históricos, incluidos los titulares principales de fuentes globales a través de AllNewsAPI. Admite múltiples opciones de filtrado, incluida la búsqueda por palabras clave, categoría, idioma y más. Este servidor de Model Context Protocol permite que los clientes MCP (Claude, Cursor, VS Code, Windsurf y otros) busquen artículos de noticias, obtengan titulares principales y consulten tu uso de la API.
Necesitarás una clave de API: consíguela en allnewsapi.com.
Inicio rápido
Elige una de las dos formas de conectarte.
Alojado (sin instalación)
Apunta tu cliente al servidor alojado y pasa tu clave de API en el encabezado X-API-Key:
{
"mcpServers": {
"allnewsapi": {
"type": "remote",
"url": "https://mcp.allnewsapi.com/mcp",
"headers": {
"X-API-Key": "YOUR_API_KEY_HERE"
}
}
}
}
¿Prefieres una configuración solo con URL? Usa https://mcp.allnewsapi.com/mcp?apikey=YOUR_API_KEY_HERE en lugar del encabezado.
La clave se puede proporcionar de tres formas, en este orden de precedencia: el encabezado X-API-Key, el parámetro de consulta apikey o un encabezado Authorization: Bearer YOUR_API_KEY_HERE (un respaldo para clientes que solo admiten tokens de portador).
Local (npx)
Ejecuta el servidor en tu máquina mediante npx — sin necesidad de clonar ni compilar:
{
"mcpServers": {
"allnewsapi": {
"command": "npx",
"args": ["allnewsapi-mcp@latest", "--apikey", "YOUR_API_KEY_HERE"]
}
}
}
También puedes proporcionar la clave como una variable de entorno ALLNEWSAPI_KEY en lugar de --apikey.
Configuración específica por cliente
Claude Desktop
Edita tu configuración (Settings → Developer → Edit Config) y agrega el fragmento local o alojado de arriba. Guía completa: modelcontextprotocol.io/quickstart/user.
Cursor
Cursor Settings → MCP → Add new MCP Server. Nómbralo "AllNewsAPI", elige el tipo command e ingresa:
npx allnewsapi-mcp@latest --apikey YOUR_API_KEY_HERE
VS Code
code --add-mcp '{"name":"allnewsapi","command":"npx","args":["allnewsapi-mcp@latest","--apikey","YOUR_API_KEY_HERE"]}'
El servidor estará disponible para tu agente de GitHub Copilot. Guía completa: Documentación de MCP para VS Code.
Windsurf
Agrega el fragmento local o alojado de arriba a tu configuración de MCP. Guía completa: Documentación de MCP para Windsurf.
Claude Code
Agrégalo desde la terminal — local:
claude mcp add allnewsapi -- npx allnewsapi-mcp@latest --apikey YOUR_API_KEY_HERE
O el servidor alojado:
claude mcp add --transport http allnewsapi https://mcp.allnewsapi.com/mcp --header "X-API-Key: YOUR_API_KEY_HERE"
Claude Cowork
Cowork se ejecuta dentro de Claude Desktop. Agrega el servidor alojado como un conector personalizado — Customize → Connectors → + — e ingresa la URL con tu clave:
https://mcp.allnewsapi.com/mcp?apikey=YOUR_API_KEY_HERE
Para una configuración local, usa la configuración de Claude Desktop que se muestra arriba.
OpenWork
OpenWork es una alternativa de código abierto a Cowork con soporte para MCP. Agrega AllNewsAPI usando el comando local (npx allnewsapi-mcp@latest --apikey YOUR_API_KEY_HERE) o la URL alojada de arriba, siguiendo la configuración de MCP de OpenWork.
Cualquier otro cliente MCP: apúntalo a la URL alojada (https://mcp.allnewsapi.com/mcp) o ejecuta el comando npx allnewsapi-mcp@latest con tu clave de API.
Herramientas
search-news
Busca artículos por palabra clave, fecha y filtros.
| Parámetro | Tipo | Descripción |
|---|---|---|
q | string | Palabras clave para buscar |
startDate / endDate | string | Rango de fechas (YYYY-MM-DD) |
content | boolean | Incluir el contenido completo del artículo (predeterminado: false) |
lang | string | Código(s) de idioma, p. ej. en, fr |
country | string | Código(s) de país, p. ej. us, gb |
region | string | Región(es), p. ej. americas, europe |
category | string | Categoría(s), p. ej. business |
max | number | Número de artículos, 1–100 (predeterminado: 5) |
page | number | Número de página (predeterminado: 1) |
attributes | string | Dónde coincidir las palabras clave: title, description, content |
sortby | string | publishedAt o relevance |
publisher | string | Filtrar por editor(es) |
ai_sentiment | string | positive, negative o neutral |
ai_entity_name | string | Entidad nombrada, p. ej. Apple |
ai_entity_type | string | Tipo de entidad, p. ej. person, organization, location |
headlines
Obtén titulares principales, opcionalmente filtrados.
| Parámetro | Tipo | Descripción |
|---|---|---|
country | string | Código(s) de país, p. ej. us, gb |
category | string | Categoría, p. ej. technology |
lang | string | Código de idioma, p. ej. en |
max | number | Número de artículos, 1–100 (predeterminado: 5) |
ai_sentiment | string | positive, negative o neutral |
ai_entity_name | string | Entidad nombrada, p. ej. Apple |
ai_entity_type | string | Tipo de entidad, p. ej. person, organization, location |
usage
Consulta tu plan, límites de solicitudes y cuota restante. Sin parámetros.
Nota sobre el plan: Los filtros avanzados —
country,region,category,publisher,lang,attributesysortby— requieren un plan de pago. En el plan gratuito, usasearch-newsconqymax. Consulta precios.
Filtrado con IA
search-news y headlines aceptan filtros analizados por IA:
ai_sentiment— sentimiento general del artículo (positive,negative,neutral)ai_entity_name— una entidad nombrada en el artículo (p. ej.United Nations)ai_entity_type— categoría de entidad (person,organization,location)
Los artículos devueltos también pueden incluir puntuaciones de sentimiento de IA, entidades detectadas y un breve resumen de IA cuando esté disponible.
Ejemplos de indicaciones
- "Dame las últimas noticias de tecnología de EE. UU."
- "Encuentra artículos sobre cambio climático de fuentes europeas"
- "Muéstrame los titulares principales de negocios de la semana pasada"
- "Encuentra noticias positivas sobre energía renovable"
- "Muéstrame artículos que mencionen a Apple como organización"
- "Consulta mi uso de la API y mi cuota restante"
Valores admitidos
Las listas completas de valores aceptados están en la documentación de AllNewsAPI:
Licencia
MIT © AllNewsAPI — consulta LICENSE para más detalles.