News Factory para desarrolladores y agentes de IA
Todo lo que News Factory hace con historias, fuentes de contenido, feeds RSS y flujos de trabajo está disponible a través de una REST API: encuentra noticias de tu nicho, convierte artículos en historias con IA, revisa su calidad y su SEO, tradúcelas y publícalas en tu sitio. La referencia es pública y está escrita para que tanto personas como agentes de IA puedan usarla por su cuenta.
Documentación
- Referencia de la API: guías y todos los endpoints, en una sola página.
- Especificación OpenAPI 3.1: genera un cliente o dásela a un agente como herramientas (cada operación tiene un
operationId). - llms.txt y llms-full.txt: la referencia para modelos de lenguaje grandes, como índice y como un único archivo Markdown.
- Servidor MCP en
https://client-api.news-factory.app/mcp: conecta un agente de IA (Claude Code, Cursor, cualquier cliente MCP) con una clave API y cada endpoint se convierte en una herramienta.
Primeros pasos
- La API está incluida en los planes Pro, Business y Enterprise. Ver los planes.
- Un administrador de la organización crea una clave API en la app, en Configuración de la organización, Claves API, y elige lo que puede hacer.
- Llama a
GET /v1/mecon la clave: te dice la organización, los permisos de la clave y los espacios de trabajo temáticos que puede usar.
curl https://client-api.news-factory.app/v1/me \
-H "Authorization: Bearer $NEWS_FACTORY_API_KEY"Claves API con permisos
Una organización puede tener varias claves, cada una con solo el acceso que necesita una integración, opcionalmente limitada a un espacio de trabajo temático y con fecha de caducidad. Las claves se muestran una sola vez, solo se guardan como hash y dejan de funcionar en menos de un minuto después de revocarlas.
| Permiso | Qué permite |
|---|---|
stories:read | Leer historias, sus medios y el historial de control de calidad y de auditorías SEO |
stories:write | Crear, actualizar y eliminar historias; subir, adjuntar y quitar medios; definir miniaturas |
content-sources:read | Leer fuentes de contenido |
content-sources:write | Crear, actualizar, eliminar y hacer scraping de fuentes de contenido |
feeds:read | Leer los feeds seguidos, el catálogo de feeds, los artículos de los feeds y el estado del programador |
feeds:write | Seguir y dejar de seguir feeds, obtener un feed ahora mismo |
workflows:read | Leer flujos de trabajo, sus ejecuciones y las ejecuciones de cada nodo |
workflows:run | Iniciar, pausar, reanudar y detener ejecuciones de flujos de trabajo |
ai:generate | Usar herramientas de IA que consumen créditos de IA, junto con el permiso de lo que leen o modifican |
Hecho para agentes de IA
claude mcp add --transport http news-factory https://client-api.news-factory.app/mcp \
--header "Authorization: Bearer $NEWS_FACTORY_API_KEY"Míralo en acción: Claude Code crea un sitio de noticias en línea por MCP, con un solo prompt y cada paso en un vídeo corto.
- Por MCP, una clave solo ve las herramientas que sus permisos autorizan, y cada llamada pasa por las mismas verificaciones que la REST API.
- Cada error dice qué salió mal, qué hacer a continuación y enlaza a su explicación:
{ error: { code, message, details, requestId, docs } }. - Un error de permisos indica exactamente qué permisos faltan; un error de espacio de trabajo temático indica los válidos.
- La referencia incluye recetas paso a paso: redactar una historia a partir de un artículo web, revisarla y mejorarla, traducirla, elegir noticias relevantes de los feeds que sigues, ejecutar un flujo de trabajo y esperar a que termine.
- Los límites de solicitudes vienen con los encabezados
Retry-AfteryRateLimit, para que un agente pueda regular su ritmo.
Preguntas
Escribe a support@news-factory.app e incluye el requestId de la respuesta sobre la que preguntas.