News Factory per sviluppatori e agenti IA

Tutto ciò che News Factory fa con articoli, fonti di contenuto, feed RSS e workflow è disponibile tramite una REST API: trova notizie nella tua nicchia, trasforma le fonti in articoli con l'IA, controllane qualità e SEO, traducili e pubblicali sul tuo sito. La documentazione di riferimento è pubblica e scritta perché sia le persone sia gli agenti IA possano usarla in autonomia.

Documentazione

  • Riferimento API: guide e tutti gli endpoint, in una sola pagina.
  • Specifica OpenAPI 3.1: genera un client, o forniscila a un agente come strumenti (ogni operazione ha un operationId).
  • llms.txt e llms-full.txt: la documentazione di riferimento per i modelli linguistici di grandi dimensioni, come indice e come un unico file Markdown.
  • Server MCP su https://client-api.news-factory.app/mcp: collega un agente IA (Claude Code, Cursor, qualsiasi client MCP) con una chiave API e ogni endpoint diventa uno strumento.

Per iniziare

  1. L'API è inclusa nei piani Pro, Business ed Enterprise. Vedi i piani.
  2. Un amministratore dell'organizzazione crea una chiave API nell'app, in Impostazioni organizzazione, Chiavi API, e sceglie cosa può fare.
  3. Chiama GET /v1/me con la chiave: ti indica l'organizzazione, le autorizzazioni della chiave e i workspace tematici che può usare.
curl https://client-api.news-factory.app/v1/me \
  -H "Authorization: Bearer $NEWS_FACTORY_API_KEY"

Chiavi API con autorizzazioni

Un'organizzazione può avere più chiavi, ognuna con solo l'accesso che serve a una singola integrazione, eventualmente limitata a un solo workspace tematico e con una data di scadenza. Le chiavi vengono mostrate una sola volta, conservate solo come hash e smettono di funzionare entro un minuto dalla revoca.

AutorizzazioneConsente
stories:readLeggere gli articoli, i loro media e la cronologia dei controlli qualità e degli audit SEO
stories:writeCreare, aggiornare ed eliminare articoli; caricare, allegare e scollegare media; impostare le miniature
content-sources:readLeggere le fonti di contenuto
content-sources:writeCreare, aggiornare, eliminare e fare lo scraping delle fonti di contenuto
feeds:readLeggere i feed seguiti, il catalogo dei feed, gli articoli dei feed e lo stato della programmazione
feeds:writeSeguire e smettere di seguire i feed, recuperare subito un feed
workflows:readLeggere i workflow, le esecuzioni dei workflow e le esecuzioni dei nodi
workflows:runAvviare, mettere in pausa, riprendere e fermare le esecuzioni dei workflow
ai:generateUsare gli strumenti IA che consumano crediti IA, insieme all'autorizzazione per ciò che leggono o modificano

Progettata per gli agenti IA

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

Guardala all'opera: Claude Code crea un sito di notizie online tramite MCP, da un solo prompt, con ogni passo in un breve video.

  • Tramite MCP, una chiave vede solo gli strumenti consentiti dalle sue autorizzazioni, e ogni chiamata passa gli stessi controlli della REST API.
  • Ogni errore dice cosa è andato storto, cosa fare dopo e rimanda alla sua spiegazione: { error: { code, message, details, requestId, docs } }.
  • Un errore di autorizzazione elenca esattamente quali autorizzazioni mancano; un errore di workspace tematico elenca quelli validi.
  • La documentazione di riferimento include ricette passo passo: scrivi un articolo da una pagina web, controllalo e miglioralo, traducilo, scegli le notizie pertinenti dai feed che segui, avvia un workflow e attendi che finisca.
  • I limiti di frequenza sono accompagnati dagli header Retry-After e RateLimit, così un agente può regolare il proprio ritmo.

Domande

Scrivi a support@news-factory.app e includi il requestId della risposta su cui hai una domanda.