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
- Die API ist in den Paketen Pro, Business und Enterprise enthalten. Pakete ansehen.
- Ein Administrator der Organisation erstellt in der App unter Organisationseinstellungen, API-Schlüssel einen Schlüssel und legt fest, was er darf.
- Rufen Sie mit dem Schlüssel
GET /v1/meauf: 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.
| Berechtigung | Erlaubt |
|---|---|
stories:read | Artikel und ihre Medien lesen, dazu den Verlauf von Qualitätsprüfung und SEO-Audit |
stories:write | Artikel erstellen, aktualisieren und löschen; Medien hochladen, anhängen und entfernen; Vorschaubilder festlegen |
content-sources:read | Inhaltsquellen lesen |
content-sources:write | Inhaltsquellen erstellen, aktualisieren, löschen und scrapen |
feeds:read | Gefolgte Feeds, den Feed-Katalog, Feed-Beiträge und den Status der Zeitplanung lesen |
feeds:write | Feeds folgen oder nicht mehr folgen, einen Feed sofort abrufen |
workflows:read | Workflows, Workflow-Durchläufe und die Durchläufe einzelner Schritte lesen |
workflows:run | Workflow-Durchläufe starten, pausieren, fortsetzen und stoppen |
ai:generate | KI-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-AfterundRateLimit, 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.