Installalo tramite `npm install -g @postnitro/cli` (richiede Node.js 18+), oppure eseguilo senza installarlo tramite `npx @postnitro/cli`. Puoi anche installarlo come skill per agenti di programmazione AI con `npx skills add postnitro/postnitro-agent`, o come plugin per Claude Code.

Perché integrare un motore di contenuti nel tuo terminale?

Pubblicare senza uscire dal guscio

"postnitro carousel generate --context '5 suggerimenti per il lavoro da remoto' --wait" è un carosello completo, in linea con il brand e pronto per il download. Nessuna scheda, nessun trascinamento, nessuna finestra di dialogo di esportazione.

Progettato per agenti di intelligenza artificiale

JSON pulito su stdout, errori JSON su stderr, nessun colore o prompt interattivo da analizzare. Claude Code, Cursor e qualsiasi agente in grado di eseguire shellout possono gestirlo in modo affidabile, oppure è possibile installarlo come skill e lasciare che l'agente impari da solo.

Automatizzare in CI e Cron

Pubblica gli annunci di rilascio dalla tua pipeline di distribuzione oppure esegui un'attività notturna che trasforma il calendario dei contenuti di domani in post programmati. I codici di uscita e l'output JSON semplificano l'individuazione degli errori.

Lo scrive l'IA, oppure lo scrivi tu.

Genera le slide a partire da un argomento, dall'URL di un articolo o da un post X, oppure importa il tuo JSON per un controllo completo, inclusi i layout infografici con colonne di dati. Entrambi i metodi utilizzano i tuoi modelli e il tuo kit di branding.

Immagini generate dall'IA, a una sola bandiera di distanza

Aggiungi --generate-images con una breve descrizione visiva e le immagini generate dall'IA verranno incorporate nelle tue diapositive prima del rendering: come sfondi o immagini in linea, in diapositive strategiche o in tutte.

Da idea a post programmato con un solo comando

Il comando generate-and-schedule crea il contenuto, attende il rendering e lo programma sul calendario con didascalie specifiche per ogni piattaforma; allo stesso modo, import-and-schedule fa lo stesso per le tue diapositive. Un intero flusso di lavoro per la gestione dei contenuti in un unico comando di shell.

Imposta le impostazioni predefinite una volta, poi dimenticatene.

Salva il tuo modello, il tuo marchio, il tuo preset e il formato di output con le impostazioni predefinite. Ogni comando successivo richiederà solo il contenuto e, se il tuo spazio di lavoro ha esattamente un candidato, la CLI lo sceglierà automaticamente.

Stessa chiave, stessi crediti, ogni superficie

La CLI è un semplice wrapper per l'API Embed e condivide la chiave e il saldo del credito con l'API REST e il server MCP. Inizia dal terminale e passa da un'interfaccia all'altra quando vuoi.

Installazione in pochi secondi

Richiede Node.js 18+ e un account PostNitro con un piano a pagamento.

# Install globally from npm (recommended)
npm install -g @postnitro/cli
postnitro --help

Da zero a incarico programmato in quattro comandi

1. Autenticati una sola volta

Ottieni la tua chiave API da PostNitro → Profilo → Incorpora → Genera chiave API, quindi salvala. Puoi anche utilizzare la variabile d'ambiente POSTNITRO_API_KEY o --api-key per comando (consigliato per CI).

postnitro auth set-key pn-xxxxxxxxxxxx   # save it once
postnitro auth status                    # check what's configured (key is masked)

2. Salva le impostazioni predefinite

Elenca i tuoi modelli, marchi e preset AI, quindi salva i tuoi preferiti in modo che i comandi di creazione richiedano solo il contenuto.

postnitro template list && postnitro brand list && postnitro preset list
postnitro defaults set --template-id tpl_123 --brand-id brd_456 --preset-id prs_789

3. Genera — e recupera i file

--attende i sondaggi fino al completamento del rendering e alla stampa del JSON finale: URL dei file, un designId per la pianificazione e un deep link editorUrl per continuare a modificare in PostNitro.

postnitro carousel generate --context "5 tips for remote work" --wait
# => { "designId": "dsg_abc", "editorUrl": "https://postnitro.ai/app/...", "data": [...] }

4. Pianificalo: PostNitro pubblica per te

Prendi il designId dall'output e programma il post sui tuoi account LinkedIn, Instagram, TikTok o Threads collegati, oppure salvalo come bozza. Ecco l'intero processo: idea → design → post programmato, senza uscire dal terminale.

postnitro schedule create \
  --status SCHEDULED --scheduled-at "2026-07-25T09:00:00Z" \
  --design-id dsg_abc \
  --selected-accounts '["acct_123"]' \
  --post-content '{"common":"5 tips for remote work 🚀 #remotework"}'

Nuovo

Non limitarti a creare post, programmali anche!

Progettare un post è solo metà del lavoro, quindi PostNitro ora lo completa: programma i post o salva le bozze direttamente su LinkedIn, Instagram, TikTok e Threads, con didascalie e impostazioni specifiche per ogni piattaforma. Genera o importa un design, associalo a una fascia oraria e PostNitro lo pubblicherà per te, tramite API, server MCP o CLI, senza bisogno di uno strumento di programmazione separato.

Instagram

TikTok

Threads

Leggi la documentazione dell'API Schedule.Esplora la pianificazione

Flussi di lavoro reali, pronti per essere copiati e incollati

Trasforma un post del blog in un carosello di LinkedIn

Punta -- digita l'articolo in un URL e l'IA estrae i punti chiave in diapositive scorrevoli.

postnitro carousel generate \
  --context "https://yourblog.com/post" --type article --wait

Genera e pianifica in un colpo solo

Contenuto scritto, design renderizzato, post programmato: un solo comando. Se la programmazione fallisce, riceverai l'ID del design in modo da poter riprovare senza dover consumare nuovamente i crediti.

postnitro generate-and-schedule \
  --context "How AI agents automate content" --type text \
  --status SCHEDULED --scheduled-at "2026-12-31T12:00:00Z" \
  --selected-accounts '["acct_123"]' \
  --linkedin-post-settings '{"postType":"document","postTitle":"How AI agents automate content"}' \
  --post-content '{"common":"New drop 🚀 #ai #automation"}'

Importa e pianifica in un'unica operazione

La controparte lato importazione: le tue slide esatte vengono convertite da JSON a un post prenotato con un singolo comando. Stessa rete di sicurezza: se la pianificazione fallisce dopo che l'importazione è andata a buon fine, ricevi l'ID del progetto per riprovare senza dover spendere nuovamente i crediti.

postnitro import-and-schedule \
  --slides '{"slides":[
    {"type":"starting_slide","heading":"Our 2026 Results","description":"The numbers behind the year"},
    {"type":"body_slide","heading":"+42% Revenue","description":"Year over year growth"},
    {"type":"ending_slide","heading":"Full report on our blog","cta_button":"Read it"}
  ]}' \
  --status SCHEDULED --scheduled-at "2026-12-31T12:00:00Z" \
  --selected-accounts '["acct_123"]' \
  --post-content '{"common":"Our year in numbers 📊 #growth"}'

Importa le tue diapositive

Controllo editoriale completo: passa le tue diapositive in formato JSON direttamente nel testo o da un file, e PostNitro le adatterà al tuo modello e al tuo marchio.

postnitro carousel import --slides '{"slides":[
  {"type":"starting_slide","heading":"Your Title","description":"Intro"},
  {"type":"body_slide","heading":"Key Point","description":"Details"},
  {"type":"ending_slide","heading":"Take Action!","cta_button":"Learn More"}
]}' --wait

Un singolo post con un'immagine realizzata con l'intelligenza artificiale.

I post di immagini rispecchiano i caroselli: un singolo oggetto di scorrimento anziché un array, con gli stessi flag di intelligenza artificiale per le immagini disponibili.

postnitro image generate --context "Announce our new scheduling feature" \
  --generate-images --image-context "upbeat and professional, product-focused" --wait

Pianifica un progetto che hai già

La creazione ti assegna un ID di progetto; la pianificazione lo associa al tuo calendario con didascalie specifiche per ogni piattaforma. Gestisci l'intera coda (visualizza, aggiorna, elimina) senza uscire dalla shell.

postnitro schedule create \
  --status SCHEDULED --scheduled-at "2026-12-31T13:00:00Z" \
  --design-id dsg_abc \
  --selected-accounts '["acct_123"]' \
  --post-content '{"common":"New carousel 🚀 #remotework"}'

postnitro schedule list --from "2026-12-01" --to "2026-12-31"

Iniziamo ora, ci pensiamo dopo.

Salta --attendi per generazioni lunghe o processi batch: la creazione restituisce immediatamente un embedPostId e status/output recupera il risultato quando sei pronto.

postnitro carousel generate --context "5 tips for remote work"
# => { "success": true, "data": { "embedPostId": "post_123", "status": "PENDING" } }

postnitro carousel status post_123   # PENDING → PROCESSING → COMPLETED
postnitro carousel output post_123   # file URLs + designId + editorUrl

Creato per agenti di intelligenza artificiale

La CLI è stata progettata pensando all'agente: flag prevedibili, output leggibile dalla macchina e azioni distruttive abilitate tramite l'opzione --yes. Installa la skill PostNitro e il tuo agente di programmazione apprenderà l'intero flusso di lavoro (individuazione, impostazioni predefinite, creazione, pianificazione) senza che tu debba scrivere alcun prompt.

In caso di successo, viene visualizzato un output JSON su stdout (uscita 0); in caso di errore, viene visualizzato un output JSON strutturato su stderr (uscita 1).
Nessun prompt interattivo, ruota della fortuna, colore o tabella: niente che possa mettere in difficoltà un parser
Inserimento JSON o file direttamente nel testo per payload complessi; l'inserimento direttamente nel testo è sempre la scelta migliore.
Installa tramite "npx skills add postnitro/postnitro-agent" oppure come plugin di Claude Code.

Superficie di comando completa

Tutte le funzionalità dell'API Embed, sotto forma di comandi componibili. Esegui qualsiasi comando con l'opzione --help per visualizzare i dettagli.

Group	Commands	What it's for
Impostare	`auth set-key · auth status · auth clear · defaults get · defaults set`	Salva la tua chiave API e il modello predefinito, il marchio, il preset e il formato di output.
Scoperta	`elenco modelli · elenco marchi · elenco preimpostazioni · elenco social`	Trova gli ID dei tuoi modelli, kit di branding, preset AI e account social collegati.
Caroselli	`generazione carosello · importazione carosello · stato carosello · output carosello · modello di importazione carosello`	Crea post con più diapositive utilizzando l'intelligenza artificiale o le tue diapositive e visualizza i risultati.
Post con immagini	`generazione immagine · importazione immagine · stato immagine · output immagine · modello di importazione immagine`	Le versioni equivalenti a immagine singola: stesse bandiere, un singolo oggetto slide invece di un array.
Kit di marca	`creazione del marchio · acquisizione del marchio · aggiornamento del marchio`	Gestisci il logo, il nome e lo pseudonimo stampati sui tuoi progetti.
Pianificazione	`creazione pianificazione · elenco pianificazione · recupero pianificazione · aggiornamento pianificazione · eliminazione pianificazione`	Prenota post e bozze con didascalie e impostazioni specifiche per ogni piattaforma; gestisci la coda di pubblicazione.
Racconti autoconclusivi	`genera e pianifica · importa e pianifica`	Crea, attendi e pianifica con un unico comando: per caroselli o post di immagini.
Account social	`lista sociale · ottenere social · disconnessione sociale`	Esamina gli account LinkedIn, Instagram, TikTok e Threads collegati.

Errori che i tuoi script possono effettivamente gestire

Ogni errore è un oggetto JSON strutturato su stderr con un codice di uscita diverso da zero: niente analisi del testo del log, niente congetture. La pipeline si dirama in base allo stato di uscita; l'agente legge il messaggio e corregge la propria chiamata.

{ "success": false, "error": { "message": "PostNitro API error (422): Scheduled at is in the past", "statusCode": 422 } }

Errore comune	Aggiustare
`Nessuna chiave API trovata`	Passa --api-key, imposta POSTNITRO_API_KEY o esegui auth set-key
`Mancante --brand-id ... più candidati`	Passa esplicitamente l'ID oppure salvane uno con le impostazioni predefinite: l'errore elenca i candidati
`L'evento programmato si è svolto nel passato.`	Utilizzare un orario ISO-8601 con almeno 5 minuti di anticipo, con una Z finale
`Le diapositive devono essere un array con almeno 3 elementi`	Fornire diapositive di apertura, corpo centrale e chiusura.
`Un post IMAGE accetta un singolo oggetto slide, non un array`	Utilizzare --slide (oggetto) per le immagini, --slides (array) per i caroselli
`Rifiuto di eliminare ... senza --sì`	Aggiungi --yes per confermare le azioni distruttive: nessuna azione distruttiva viene eseguita per errore.

Tre formati di output

PDF

Un singolo documento: questa è l'impostazione predefinita e il formato ideale per i post di documenti su LinkedIn.

PNG

Un'immagine per diapositiva, pronta per essere caricata direttamente ovunque.

PROGETTO

Salta completamente il rendering e restituisce il progetto modificabile: la soluzione più veloce quando devi solo programmare o continuare a modificare.

Ogni output completato include un designId (richiede la pianificazione) e un link profondo editorUrl per aprire il progetto nell'editor di PostNitro. Il tipo di risposta non modifica il costo in crediti.

Crediti e prezzi

Plan	Price	Credits/Month	Typical Usage
Mensile	10 dollari al mese	250 crediti/mese	Accesso completo alla CLI e automazione regolare
Livelli superiori	Vedi la pagina dei progetti	Altri crediti	Team, agenzie e pipeline ad alto volume

Operation	Credits per Slide
Importazione contenuti	1 credito per diapositiva
generazione di IA	2 crediti per diapositiva

La CLI condivide i crediti con l'API Embed e il server MCP. Le immagini generate dall'IA utilizzano una quota di immagini separata dell'organizzazione e non modificano il costo in crediti di un post.

Get Your API Key

CLI vs MCP vs API di integrazione vs SDK di integrazione

	CLI	Server MCP	API di incorporamento	SDK di integrazione
Ideale per	Flussi di lavoro del terminale, script di shell, CI e agenti che eseguono shell	Assistenti IA che creano post in modo conversazionale	Backend personalizzati e piattaforme di automazione senza codice	Consentire ai tuoi utenti di progettare caroselli all'interno della tua app
Interfaccia	Comandi con flag — JSON in, JSON out	Linguaggio naturale tramite client MCP	REST su HTTPS	Editor visuale integrabile
Impostare	npm install -g @postnitro/cli	Un blocco di configurazione o un comando CLI	Chiave API + qualsiasi client HTTP	Pacchetto npm + chiave API
Pianificazione	Sì, inclusa la generazione e la pianificazione una tantum.	Sì — CRUD completo tramite strumenti	Sì, tramite l'API di pianificazione.	No, solo design
Stessa chiave e stessi crediti	SÌ	SÌ	SÌ	SÌ

Sono tutti basati sullo stesso motore. Utilizza la CLI nei terminali e nelle pipeline, MCP all'interno degli assistenti IA, l'API REST dal tuo codice e l'SDK quando i tuoi utenti necessitano di un editor visuale.

Frequently Asked Questions

Cos'è la CLI di PostNitro?

Come si installa?

Ho bisogno di un piano a pagamento?

Come funziona l'autenticazione?

Gli agenti di intelligenza artificiale possono utilizzare la CLI?

Qual è la differenza tra generare e importare?

Come faccio a programmare un post che ho appena creato?

È possibile generare immagini AI per le mie diapositive tramite la CLI?

Quali formati di output supporta?

Cosa succede quando un comando fallisce?

La CLI è open source?

Quando è preferibile utilizzare la CLI rispetto al server MCP?

Related Resources

CLI Documentation MCP Server Embed API Embed SDK Pricing & Plans

PostNitro CLI — Crea e programma post sui social media dal tuo terminale

Un solo comando, un post dal design accattivante. La CLI di PostNitro crea caroselli e post con immagini singole in linea con il brand, aggiunge facoltativamente immagini generate dall'IA e li programma per LinkedIn, Instagram, TikTok e Threads, senza bisogno di un browser, di uno strumento di progettazione o di un singolo passaggio manuale. Ogni comando utilizza il formato JSON, il che lo rende comodo sia per gli agenti di IA e le pipeline di integrazione continua, sia per l'utente.

npm install -g @postnitro/cli — e il tuo terminale si trasforma in uno studio di contenuti.

Pacchetto

@postnitro/cli su npm

Interfaccia

JSON in, JSON out — script-safe

Crea

Caroselli e post di immagini, PNG/PDF

Orari per

LinkedIn, Instagram, TikTok, Threads

Read the CLI Docs Get API Key