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

  1. La API está incluida en los planes Pro, Business y Enterprise. Ver los planes.
  2. 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.
  3. Llama a GET /v1/me con 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.

PermisoQué permite
stories:readLeer historias, sus medios y el historial de control de calidad y de auditorías SEO
stories:writeCrear, actualizar y eliminar historias; subir, adjuntar y quitar medios; definir miniaturas
content-sources:readLeer fuentes de contenido
content-sources:writeCrear, actualizar, eliminar y hacer scraping de fuentes de contenido
feeds:readLeer los feeds seguidos, el catálogo de feeds, los artículos de los feeds y el estado del programador
feeds:writeSeguir y dejar de seguir feeds, obtener un feed ahora mismo
workflows:readLeer flujos de trabajo, sus ejecuciones y las ejecuciones de cada nodo
workflows:runIniciar, pausar, reanudar y detener ejecuciones de flujos de trabajo
ai:generateUsar 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-After y RateLimit, 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.