News Factory für Entwickler und KI-Agenten

Alles, was News Factory mit Artikeln, Inhaltsquellen, RSS-Feeds und Workflows macht, ist über eine REST API verfügbar: Nachrichten in Ihrer Nische finden, mit KI aus Beiträgen Artikel machen, sie auf Qualität und SEO prüfen, übersetzen und auf Ihrer Website veröffentlichen. Die Referenz ist öffentlich und so geschrieben, dass Menschen wie KI-Agenten sie selbstständig nutzen können.

Dokumentation

  • API-Referenz: Anleitungen und jeder Endpunkt, auf einer Seite.
  • Spezifikation nach OpenAPI 3.1: einen Client generieren oder sie einem Agenten als Tools geben (jede Operation hat eine operationId).
  • llms.txt und llms-full.txt: die Referenz für große Sprachmodelle, als Index und als eine einzige Markdown-Datei.
  • MCP-Server unter https://client-api.news-factory.app/mcp: Verbinden Sie einen KI-Agenten (Claude Code, Cursor, jeden MCP-Client) per API-Schlüssel, und jeder Endpunkt wird zu einem Tool.

Erste Schritte

  1. Die API ist in den Paketen Pro, Business und Enterprise enthalten. Pakete ansehen.
  2. Ein Administrator der Organisation erstellt in der App unter Organisationseinstellungen, API-Schlüssel einen Schlüssel und legt fest, was er darf.
  3. Rufen Sie mit dem Schlüssel GET /v1/me auf: Die Antwort nennt die Organisation, die Berechtigungen des Schlüssels und die Themen-Workspaces, die er nutzen kann.
curl https://client-api.news-factory.app/v1/me \
  -H "Authorization: Bearer $NEWS_FACTORY_API_KEY"

API-Schlüssel mit Berechtigungen

Eine Organisation kann mehrere Schlüssel haben, jeder nur mit dem Zugriff, den eine Integration braucht, optional auf einen Themen-Workspace beschränkt und mit Ablaufdatum. Schlüssel werden einmal angezeigt, nur als Hash gespeichert und funktionieren innerhalb einer Minute nach dem Widerruf nicht mehr.

BerechtigungErlaubt
stories:readArtikel und ihre Medien lesen, dazu den Verlauf von Qualitätsprüfung und SEO-Audit
stories:writeArtikel erstellen, aktualisieren und löschen; Medien hochladen, anhängen und entfernen; Vorschaubilder festlegen
content-sources:readInhaltsquellen lesen
content-sources:writeInhaltsquellen erstellen, aktualisieren, löschen und scrapen
feeds:readGefolgte Feeds, den Feed-Katalog, Feed-Beiträge und den Status der Zeitplanung lesen
feeds:writeFeeds folgen oder nicht mehr folgen, einen Feed sofort abrufen
workflows:readWorkflows, Workflow-Durchläufe und die Durchläufe einzelner Schritte lesen
workflows:runWorkflow-Durchläufe starten, pausieren, fortsetzen und stoppen
ai:generateKI-Tools nutzen, die KI-Credits verbrauchen, zusammen mit der Berechtigung für das, was sie lesen oder ändern

Für KI-Agenten gemacht

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

In Aktion sehen: Claude Code baut per MCP eine Live-Nachrichten-Website, aus einem einzigen Prompt, jeder Schritt in einem kurzen Video.

  • Über MCP sieht ein Schlüssel nur die Tools, die seine Berechtigungen erlauben, und jeder Aufruf durchläuft dieselben Prüfungen wie bei der REST API.
  • Jeder Fehler sagt, was schiefgelaufen ist und was als Nächstes zu tun ist, und verlinkt auf seine Erklärung: { error: { code, message, details, requestId, docs } }.
  • Ein Berechtigungsfehler nennt genau, welche Berechtigungen fehlen; ein Fehler zum Themen-Workspace nennt die gültigen.
  • Die Referenz enthält Schritt-für-Schritt-Anleitungen: aus einem Web-Beitrag einen Artikel schreiben, ihn prüfen und verbessern, übersetzen, relevante Nachrichten aus gefolgten Feeds auswählen, einen Workflow starten und abwarten.
  • Rate Limits kommen mit den Headern Retry-After und RateLimit, damit ein Agent sein Tempo selbst steuern kann.

Fragen

Schreiben Sie an support@news-factory.app und geben Sie die requestId der Antwort an, um die es geht.