API y MCP
Las portadas, todas las noticias publicadas, los boletines de audio y «Pregúntale al Autómata», para tus programas y para asistentes como Claude o ChatGPT.
Todo se lee sin clave, con límites por IP. Una clave de API sube los límites y da acceso a los webhooks. Lo que devuelve es lo que publica El Autómata: nuestras noticias, con sus fuentes enlazadas. El texto de los periódicos que leemos no se sirve.
MCP
Servidor MCP (Streamable HTTP): https://elautomata.es/mcp. En Claude Code:
claude mcp add --transport http el-automata https://elautomata.es/mcp
En claude.ai o ChatGPT, añádelo como conector personalizado con esa URL. Herramientas: headlines, search_news, read_story, whats_new, coverage, bulletin y ask. Con clave, envía la cabecera Authorization: Bearer hk_….
API REST
Base https://elautomata.es/v1 · especificación OpenAPI. Ediciones: nacional (Nacional), vega-baja (Vega Baja), benidorm (Benidorm), espana (Nacional · España), internacional (Nacional · Internacional), economia (Nacional · Economía), sociedad (Nacional · Sociedad), tecnologia (Nacional · Tecnología), cultura (Nacional · Cultura), deportes (Nacional · Deportes), bicimonte (Nacional · Bicimonte).
GET /v1/editions
GET /v1/editions/{ed}/front ?at=2026-10-19T11:00 ?format=markdown
GET /v1/editions/{ed}/history
GET /v1/editions/{ed}/podcast
GET /v1/editions/{ed}/stories/{id} ?format=json|markdown|html
GET /v1/editions/{ed}/stories/{id}/versions
GET /v1/stories ?q= &edition= §ion= &outlet= &since= &from= &to= &order= &limit= &offset=
POST /v1/ask {question, edition?, story?, conversation_id?, stream?}
GET|POST /v1/webhooks · DELETE /v1/webhooks/{id}curl https://elautomata.es/v1/editions/vega-baja/front curl "https://elautomata.es/v1/stories?q=dana&edition=vega-baja,benidorm" curl "https://elautomata.es/v1/stories?since=2026-10-19T08:00:00Z&order=recent"
Pregúntale al Autómata
Responde preguntas sobre la actualidad buscando en el archivo, en los artículos originales de los periódicos y en lo que se ha dicho en la radio. La respuesta, en Markdown, enlaza cada dato a su fuente; citations las lista. Para preguntar sobre una noticia concreta, pasa story; para seguir la conversación, conversation_id.
curl -X POST https://elautomata.es/v1/ask -H 'content-type: application/json' \
-d '{"question": "¿Cómo cuentan los periódicos de izquierda y de derecha la noticia del día?"}'Con "stream": true la respuesta llega como un stream SSE del AI SDK (compatible con useChat).
Webhooks
Con clave: POST /v1/webhooks {"url", "events", "editions"}. Eventos edition.published (cada edición, con sus noticias) y story.breaking (última hora). Cada envío lleva x-heraldo-signature: sha256=…, el HMAC-SHA256 del cuerpo con el secreto que recibes al crearlo.
import { createHmac, timingSafeEqual } from 'node:crypto';
const ok = (body, header, secret) =>
timingSafeEqual(Buffer.from(header), Buffer.from('sha256=' + createHmac('sha256', secret).update(body).digest('hex')));Límites
| Lecturas por minuto | Lecturas al día | Preguntas al día | |
|---|---|---|---|
| Sin clave (por IP) | 60 | 2000 | 40 |
| Con clave | 120 | 10.000 | 200 |
Las respuestas llevan x-ratelimit-remaining-day. Las claves se conceden a mano por ahora.
Condiciones de uso
- Si reproduces una noticia, enlaza sus fuentes (vienen en cada respuesta) y la noticia en El Autómata.
- Indica que está redactada automáticamente: cada respuesta trae
aiGeneratedyattribution. - Las noticias pueden contener errores; para decisiones importantes, consulta la fuente original.