newsmcp
Noticias mundiales en tiempo real para agentes de IA: eventos agrupados de cientos de fuentes, clasificados por 12 temas y más de 30 regiones, ordenados por importancia. Gratuito, sin clave API.
Documentación
NewsMCP — Noticias mundiales para agentes de IA
newsmcp.io • integraciones • API REST
Eventos de noticias en tiempo real, agrupados por IA desde cientos de fuentes, clasificados por tema y geografía, ordenados por importancia.
Gratis. Sin clave de API. Un comando para instalar.
Cobertura
12 temas — politics economy technology science health environment sports culture crime military education society
30 regiones — 6 continentes y 24 países. Filtra por europe, asia, united-states, germany, japan, ukraine, y más.
Cientos de fuentes — Artículos agrupados en eventos en tiempo real, ordenados por número de fuentes y puntuación de impacto.
Integraciones
| Plataforma | Paquete | Instalación |
|---|---|---|
| Claude Desktop | @newsmcp/server | Configuración MCP |
| Plugin de Claude Code | newsmcp | /plugin install |
| Claude Code MCP | @newsmcp/server | claude mcp add |
| Cursor | @newsmcp/server | Configuración MCP |
| Windsurf | @newsmcp/server | Configuración MCP |
| OpenAI Codex | @newsmcp/server | codex mcp add |
| Gemini CLI | @newsmcp/server | settings.json |
| OpenCode | @newsmcp/server | opencode mcp add |
| Smithery | @newsmcp/server | npx @smithery/cli |
| Plugin de OpenClaw | @newsmcp/openclaw | openclaw plugins install |
| Habilidad de OpenClaw | newsmcp-skill | clawhub install |
| API REST | — | curl https://newsmcp.io/v1/news/ |
Claude Desktop
Añade a claude_desktop_config.json:
{
"mcpServers": {
"newsmcp": {
"command": "npx",
"args": ["-y", "@newsmcp/server"]
}
}
}
Plugin de Claude Code
/plugin marketplace add pranciskus/newsmcp
/plugin install newsmcp
Claude Code MCP
claude mcp add newsmcp -- npx -y @newsmcp/server
Cursor
Añade a .cursor/mcp.json:
{
"mcpServers": {
"newsmcp": {
"command": "npx",
"args": ["-y", "@newsmcp/server"]
}
}
}
Windsurf
Añade a la configuración MCP:
{
"mcpServers": {
"newsmcp": {
"command": "npx",
"args": ["-y", "@newsmcp/server"]
}
}
}
OpenAI Codex
codex mcp add newsmcp -- npx -y @newsmcp/server
O añade a ~/.codex/config.toml:
[mcp_servers.newsmcp]
command = "npx"
args = ["-y", "@newsmcp/server"]
Gemini CLI
Añade a ~/.gemini/settings.json (o .gemini/settings.json local del proyecto):
{
"mcpServers": {
"newsmcp": {
"command": "npx",
"args": ["-y", "@newsmcp/server"]
}
}
}
OpenCode
opencode mcp add
O añade a ~/.config/opencode/opencode.json (o .opencode/opencode.json local del proyecto):
{
"mcp": {
"newsmcp": {
"type": "local",
"enabled": true,
"command": ["npx", "-y", "@newsmcp/server"]
}
}
}
Smithery
npx -y @smithery/cli install @newsmcp/server --client claude
Plugin de OpenClaw
openclaw plugins install @newsmcp/openclaw
No se necesita configuración: funciona directamente. Consulta @newsmcp/openclaw para ver las opciones.
Habilidad de OpenClaw
clawhub install newsmcp-skill
Alternativa ligera: un único SKILL.md que enseña al agente a llamar a la API REST mediante curl. Sin dependencias. Consulta newsmcp-skill en ClawHub.
Herramientas MCP
Cuatro herramientas. Esa es la interfaz.
get_news
Principales eventos que ocurren ahora mismo. Filtra por tema, región y ventana de tiempo.
| Parámetro | Tipo | Predeterminado | Descripción |
|---|---|---|---|
topics | string | — | Slugs de temas separados por comas: politics,technology |
geo | string | — | Slugs de regiones separados por comas: europe,lithuania |
hours | number | 24 | Ventana de tiempo en horas (1–168) |
page | number | 1 | Número de página |
per_page | number | 20 | Resultados por página (máx. 50) |
order_by | string | -sources_count | Campo de ordenación (ver más abajo) |
Opciones de ordenación: -sources_count, -impact_score, -last_seen_at, -entries_count (prefijo - para descendente)
get_news_detail
Detalles completos de un único evento: todos los artículos fuente, contexto generado por IA, análisis de impacto, etiquetas de entidades.
| Parámetro | Tipo | Descripción |
|---|---|---|
event_id | string | UUID del evento de los resultados de get_news |
get_topics
Enumera todas las categorías de temas disponibles para filtrar. Sin parámetros.
crime culture economy education environment health military politics science society sports technology
get_regions
Enumera todas las regiones geográficas (6 continentes y 24 países) disponibles para filtrar. Sin parámetros.
Cómo lo usan los agentes
| Prompt | Qué ocurre |
|---|---|
| "¿Qué está pasando en el mundo?" | get_news con valores predeterminados: los 20 principales eventos por cobertura de fuentes |
| "¿Hay noticias de tecnología de Europa hoy?" | get_news con topics=technology, geo=europe, hours=24 |
| "Cuéntame más sobre ese terremoto" | get_news_detail con el UUID del evento |
| "¿Por qué temas puedo filtrar?" | get_topics: devuelve la lista completa |
| "Muéstrame noticias de Asia esta semana" | get_news con geo=asia, hours=168 |
API REST
¿No necesitas MCP? Accede directamente a los endpoints. Los mismos datos, los mismos filtros.
URL base: https://newsmcp.io/v1
| Método | Endpoint | Descripción |
|---|---|---|
GET | /news/ | Lista eventos de noticias con filtrado opcional |
GET | /news/{id}/ | Evento único con lista completa de artículos |
GET | /news/topics/ | Todas las categorías de temas |
GET | /news/regions/ | Todas las regiones geográficas |
Parámetros de consulta
Todos los parámetros son opcionales. Combínalos libremente.
# Latest events
curl -s https://newsmcp.io/v1/news/ | jq
# Filter by topic
curl -s "https://newsmcp.io/v1/news/?topics=technology" | jq
# Filter by region
curl -s "https://newsmcp.io/v1/news/?geo=europe" | jq
# Last 12 hours, sorted by impact
curl -s "https://newsmcp.io/v1/news/?hours=12&order_by=-impact_score" | jq
# Combine everything
curl -s "https://newsmcp.io/v1/news/?topics=politics&geo=united+states&hours=48&per_page=5" | jq
Formato de respuesta
{
"events": [
{
"id": "cc3428ab-2ada-41bb-86ab-833fd39ffd8d",
"summary": "Event description with AI-generated context...",
"topics": ["technology", "politics"],
"geo": ["united states"],
"entries_count": 86,
"sources_count": 45,
"first_seen_at": "2026-02-15T04:06:41.728Z",
"last_seen_at": "2026-03-03T05:00:30Z",
"impact_score": 8,
"entries": [
{
"title": "Article headline",
"url": "https://source.com/article",
"domain": "source.com",
"published_at": "2026-03-03T05:00:30Z"
}
]
}
],
"total": 142,
"page": 1,
"per_page": 20
}
Cómo funciona
- Recopilar — Se extraen continuamente cientos de fuentes de noticias
- Agrupar — Los artículos sobre el mismo evento se agrupan mediante incrustaciones vectoriales
- Clasificar — Cada evento se etiqueta con temas y entidades geográficas
- Ordenar — Los eventos se puntúan por número de fuentes, impacto y actualidad
- Servir — JSON limpio mediante API REST y servidor MCP
Los eventos se actualizan en tiempo real a medida que aparecen nuevos artículos. La IA de agrupación fusiona automáticamente la cobertura duplicada.
Configuración
Apunta a un backend de API diferente:
{
"mcpServers": {
"newsmcp": {
"command": "npx",
"args": ["-y", "@newsmcp/server"],
"env": {
"NEWS_API_BASE_URL": "https://your-api.example.com/v1"
}
}
}
}
Lanzamientos (GitHub Actions + OIDC)
La publicación se controla mediante etiquetas a través de .github/workflows/release.yml:
- Disparador: etiqueta de push
v*.*.* - Publica
@newsmcp/servery@newsmcp/openclawen npm mediante Trusted Publishing (OIDC) - Publica metadatos MCP con
mcp-publisher login github-oidc - Crea un lanzamiento de GitHub con notas generadas
Configuración inicial
- Ajustes del paquete npm:
Para
@newsmcp/servery@newsmcp/openclaw, añade un Trusted Publisher que apunte a:- Propietario:
pranciskus - Repositorio:
newsmcp - Archivo de workflow:
.github/workflows/release.yml - Entorno: déjalo vacío (a menos que uses uno intencionadamente)
- Propietario:
- Registro MCP: Asegúrate de que el repositorio/paquete esté autorizado para la publicación OIDC de GitHub en el Registro MCP.
Flujo de lanzamiento
- Actualiza las versiones en:
packages/mcp-server/package.jsonpackages/openclaw-plugin/package.jsonpackages/mcp-server/server.jsonpackage-lock.json
- Haz commit y push a
main - Crea y haz push de la etiqueta:
git tag -a vX.Y.Z -m "vX.Y.Z"
git push origin vX.Y.Z
El workflow realiza la publicación y el lanzamiento de GitHub automáticamente.
Estructura del repositorio
newsmcp/
├── .github/workflows/ # CI/CD workflows (release automation)
├── .claude-plugin/ # Marketplace manifest
├── packages/
│ ├── mcp-server/ # @newsmcp/server — MCP server (npm)
│ ├── claude-code-plugin/ # newsmcp — Claude Code plugin
│ ├── openclaw-plugin/ # @newsmcp/openclaw — OpenClaw plugin (npm)
│ └── skill/ # newsmcp-skill — OpenClaw skill (ClawHub)
├── publish.sh # Build, test, publish workflow
├── README.md
└── LICENSE
Licencia
MIT