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
- L'API è inclusa nei piani Pro, Business ed Enterprise. Vedi i piani.
- Un amministratore dell'organizzazione crea una chiave API nell'app, in Impostazioni organizzazione, Chiavi API, e sceglie cosa può fare.
- Chiama
GET /v1/mecon 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.
| Autorizzazione | Consente |
|---|---|
stories:read | Leggere gli articoli, i loro media e la cronologia dei controlli qualità e degli audit SEO |
stories:write | Creare, aggiornare ed eliminare articoli; caricare, allegare e scollegare media; impostare le miniature |
content-sources:read | Leggere le fonti di contenuto |
content-sources:write | Creare, aggiornare, eliminare e fare lo scraping delle fonti di contenuto |
feeds:read | Leggere i feed seguiti, il catalogo dei feed, gli articoli dei feed e lo stato della programmazione |
feeds:write | Seguire e smettere di seguire i feed, recuperare subito un feed |
workflows:read | Leggere i workflow, le esecuzioni dei workflow e le esecuzioni dei nodi |
workflows:run | Avviare, mettere in pausa, riprendere e fermare le esecuzioni dei workflow |
ai:generate | Usare 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-AftereRateLimit, 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.