News Factory pour les développeurs et les agents IA

Tout ce que News Factory fait avec les articles, les sources de contenu, les flux RSS et les workflows est accessible via une API REST : trouvez l'actualité de votre niche, transformez vos sources en articles avec l'IA, vérifiez leur qualité et leur SEO, traduisez-les et publiez-les sur votre site. La référence est publique et rédigée pour que les humains comme les agents IA puissent l'utiliser en autonomie.

Documentation

  • Référence de l'API : les guides et tous les endpoints, sur une seule page.
  • Spécification OpenAPI 3.1 : générez un client, ou donnez-la à un agent sous forme d'outils (chaque opération a un operationId).
  • llms.txt et llms-full.txt : la référence pour les grands modèles de langage, sous forme d'index et d'un seul fichier Markdown.
  • Serveur MCP sur https://client-api.news-factory.app/mcp : connectez un agent IA (Claude Code, Cursor, tout client MCP) avec une clé API, et chaque endpoint devient un outil.

Pour commencer

  1. L'API est incluse dans les offres Pro, Business et Enterprise. Voir les offres.
  2. Un administrateur de l'organisation crée une clé API dans l'application, sous Paramètres de l'organisation, puis Clés API, et choisit ce qu'elle peut faire.
  3. Appelez GET /v1/me avec la clé : il vous indique l'organisation, les autorisations de la clé et les espaces de travail thématiques qu'elle peut utiliser.
curl https://client-api.news-factory.app/v1/me \
  -H "Authorization: Bearer $NEWS_FACTORY_API_KEY"

Clés API avec autorisations

Une organisation peut avoir plusieurs clés, chacune avec uniquement l'accès dont une intégration a besoin, éventuellement limitée à un seul espace de travail thématique et dotée d'une date d'expiration. Les clés ne s'affichent qu'une fois, ne sont stockées que sous forme de hachage et cessent de fonctionner moins d'une minute après leur révocation.

AutorisationPermet de
stories:readLire les articles, leurs médias, l'historique des contrôles qualité et des audits SEO
stories:writeCréer, modifier et supprimer des articles ; importer, joindre et détacher des médias ; définir les miniatures
content-sources:readLire les sources de contenu
content-sources:writeCréer, modifier, supprimer et scraper des sources de contenu
feeds:readLire les flux suivis, le catalogue de flux, les articles des flux et l'état du planificateur
feeds:writeSuivre et ne plus suivre des flux, récupérer un flux immédiatement
workflows:readLire les workflows, les exécutions de workflow et les exécutions de nœuds
workflows:runLancer, mettre en pause, reprendre et arrêter des exécutions de workflow
ai:generateUtiliser les outils IA qui consomment des crédits IA, avec l'autorisation correspondant à ce qu'ils lisent ou modifient

Conçue pour les agents IA

claude mcp add --transport http news-factory https://client-api.news-factory.app/mcp \
  --header "Authorization: Bearer $NEWS_FACTORY_API_KEY"

À voir en action : Claude Code crée un site d'actualité en ligne via MCP, à partir d'un seul prompt, avec chaque étape dans une courte vidéo.

  • Via MCP, une clé ne voit que les outils que ses autorisations permettent, et chaque appel passe par les mêmes contrôles que l'API REST.
  • Chaque erreur indique ce qui s'est mal passé, quoi faire ensuite, et renvoie vers son explication : { error: { code, message, details, requestId, docs } }.
  • Une erreur d'autorisation liste exactement les autorisations manquantes ; une erreur d'espace de travail thématique liste ceux qui sont valides.
  • La référence inclut des recettes pas à pas : rédiger un article à partir d'un article en ligne, le vérifier et l'améliorer, le traduire, sélectionner l'actualité pertinente dans les flux suivis, lancer un workflow et attendre qu'il se termine.
  • Les limites de débit s'accompagnent des en-têtes Retry-After et RateLimit, pour qu'un agent puisse régler son rythme.

Questions

Écrivez à support@news-factory.app, en indiquant le requestId de la réponse qui vous concerne.