CLIAPI

Pianifica e pubblica dal terminale

fopost è la CLI ufficiale di FoPost: un unico binario statico, senza nient'altro da installare. Crea un post, allega i media, pianificalo su tutti gli account collegati e controlla ogni consegna, dalla shell, da uno script o da un job CI.

brew install fopost/tap/fopost
fopost auth login

fopost posts create \
  --account acc_9f2c4a7b \
  --account acc_1ee3d5a0 \
  --text "We shipped dark mode. Every surface, every chart." \
  --media ./screenshots/dark-mode.png \
  --schedule-at "2026-09-01 09:00"

Un solo binario

macOS, Linux e Windows su amd64 e arm64. Installa con Homebrew, go install o un archivio di rilascio.

Pensata per gli script

Ogni comando accetta --json, gli errori vanno su stderr e ogni errore ha il proprio codice di uscita.

Niente pubblicazioni a sorpresa

Un post resta una bozza finché non passi --publish, esegui posts publish o imposti una pianificazione.

Post

Crea, pianifica e pubblica con un solo comando

posts create accetta gli account, il testo, i file multimediali locali e un orario. I file vengono caricati nella tua libreria media e allegati per te. I testi lunghi arrivano da un file o da una pipe, e il preflight controlla un post su ogni rete di destinazione prima che venga inviato qualcosa.

Leggi i comandi dei post
Post
git log -1 --pretty=%s | \
  fopost posts create --account acc_9f2c4a7b --text-file - --draft

fopost posts preflight post_7d2a
fopost posts publish post_7d2a
fopost posts deliveries post_7d2a

Pianifica o pubblica

Passa un orario per pianificare, --publish per inviare subito, oppure niente per tenere una bozza.

Preflight

Scopri quali account sono pronti o bloccati, e perché, prima di pubblicare.

Stato di consegna

Stato per account, tentativi e link live non appena una rete ne ha uno.

Scripting

JSON in uscita, codici di uscita in risposta

Aggiungi --json a qualsiasi comando e invia il risultato a jq. Un 401, un 404, un limite di richieste e una richiesta errata escono ciascuno con un codice diverso, così uno script li distingue senza analizzare il testo. Tentativi e backoff avvengono in automatico a ogni richiesta.

Leggi la guida allo scripting
Account che richiedono attenzione
fopost accounts health --json \
  | jq -r '.accounts[] | select(.healthStatus != "healthy") | .id' \
  | xargs -I{} fopost accounts validate {} --quiet

--json ovunque

La risorsa stessa, indentata, su stdout. Le tabelle sono per le persone.

Codici di uscita distinti

Input errato, autenticazione, permessi, risorsa non trovata, limite di richieste ed errori del server ne hanno uno ciascuno.

Nuovi tentativi integrati

Limiti di richieste, errori del server e problemi di rete vengono ritentati con backoff.

CI

Pubblica dalla tua pipeline

Imposta la chiave API come secret, passa il workspace e la CLI non ha bisogno di configurazione salvata. Annuncia una release, condividi un changelog o blocca un merge quando il preflight fallisce. Per GitHub c'è anche un'Action ufficiale che racchiude lo stesso flusso.

Inizia a costruire
Note di rilascio a ogni tag
FOPOST_API_KEY=$FOPOST_API_KEY fopost posts create \
  --workspace "$WORKSPACE_ID" \
  --account "$ACCOUNT_ID" \
  --text-file release-notes.md \
  --publish --json --quiet

Chiave dall'ambiente

FOPOST_API_KEY viene letta automaticamente. Nessun login in CI.

Qualsiasi sistema CI

GitHub Actions, GitLab CI o qualsiasi cosa esegua una shell.

Automazioni e webhook

Avvia automazioni e gestisci le sottoscrizioni webhook con lo stesso strumento.

CLI: le risposte alle tue domande

Come installo la CLI?

Esegui brew install fopost/tap/fopost, oppure go install github.com/fopost/fopost-cli@latest, oppure scarica l'archivio per la tua piattaforma dalla pagina delle release su GitHub e metti fopost nel tuo PATH.

Serve un account?

Sì. La CLI comunica con l'API ospitata di FoPost, quindi serve una chiave API, che crei nella dashboard in Impostazioni, Chiavi API. fopost auth login la salva, oppure imposta FOPOST_API_KEY.

Dove viene salvata la mia chiave API?

Nella cartella di configurazione dell'utente, leggibile solo da te. La CLI non la mostra mai: auth status mostra un prefisso mascherato e l'output dettagliato la omette.

Cosa può fare?

Post, account e il loro stato di salute, workspace, caricamenti media, etichette, analitiche, automazioni e webhook. Esegui fopost --help o leggi la documentazione della CLI per ogni comando.

È open source?

Sì. La CLI è con licenza MIT e il codice sorgente è su GitHub in fopost/fopost-cli.

Sviluppa oggi con CLI

Iniziare è gratis e l'API completa è inclusa. Crea una chiave e fai la tua prima chiamata in pochi minuti.

Ottieni la tua chiave API