CLIAPI

Im Terminal planen und veröffentlichen

fopost ist die offizielle FoPost CLI: eine einzige statische Binärdatei, sonst muss nichts installiert werden. Erstelle einen Post, hänge Medien an, plane ihn für alle verbundenen Accounts und prüfe jede Zustellung, aus deiner Shell, einem Skript oder einem CI-Job.

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"

Eine Binärdatei

macOS, Linux und Windows auf amd64 und arm64. Installation per Homebrew, go install oder Release-Archiv.

Gebaut für Skripte

Jeder Befehl nimmt --json, Fehler gehen an stderr und jeder Fehlschlag hat einen eigenen Exit-Code.

Nichts wird überraschend gepostet

Ein Post bleibt ein Entwurf, bis du --publish übergibst, posts publish ausführst oder einen Zeitplan setzt.

Posts

Erstellen, planen und veröffentlichen mit einem Befehl

posts create nimmt die Accounts, den Text, lokale Mediendateien und eine Uhrzeit. Dateien werden in deine Mediathek hochgeladen und für dich angehängt. Langer Text kommt aus einer Datei oder einer Pipe, und preflight prüft einen Post gegen jedes Zielnetzwerk, bevor etwas gesendet wird.

Posts-Befehle lesen
Posts
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

Planen oder veröffentlichen

Gib eine Uhrzeit zum Planen an, --publish zum sofortigen Senden oder nichts, um einen Entwurf zu behalten.

Preflight

Sieh vor dem Veröffentlichen, welche Accounts bereit oder blockiert sind und warum.

Zustellstatus

Status pro Account, Versuche und der Live-Link, sobald ein Netzwerk einen hat.

Skripting

JSON raus, Exit-Codes zurück

Hänge --json an jeden Befehl und leite das Ergebnis an jq weiter. Ein 401, ein 404, ein Ratenlimit und eine ungültige Anfrage enden jeweils mit einem anderen Code, sodass ein Skript sie ohne Textanalyse unterscheiden kann. Wiederholungen und Backoff laufen bei jeder Anfrage im Hintergrund.

Skripting-Leitfaden lesen
Accounts, die Aufmerksamkeit brauchen
fopost accounts health --json \
  | jq -r '.accounts[] | select(.healthStatus != "healthy") | .id' \
  | xargs -I{} fopost accounts validate {} --quiet

Überall --json

Die Ressource selbst, eingerückt, auf stdout. Tabellen sind für Menschen.

Eindeutige Exit-Codes

Ungültige Eingabe, Authentifizierung, Berechtigung, nicht gefunden, Ratenlimit und Serverfehler haben jeweils einen.

Wiederholungen eingebaut

Ratenlimits, Serverfehler und Netzwerkausfälle werden mit Backoff wiederholt.

CI

Aus deiner Pipeline posten

Lege deinen API-Schlüssel als Secret fest, übergib den Workspace, und die CLI braucht keine gespeicherte Konfiguration. Kündige ein Release an, teile ein Changelog oder blockiere einen Merge, wenn preflight fehlschlägt. Für GitHub gibt es zudem eine offizielle Action, die denselben Ablauf umhüllt.

Loslegen
Release Notes bei jedem Tag
FOPOST_API_KEY=$FOPOST_API_KEY fopost posts create \
  --workspace "$WORKSPACE_ID" \
  --account "$ACCOUNT_ID" \
  --text-file release-notes.md \
  --publish --json --quiet

Schlüssel aus der Umgebung

FOPOST_API_KEY wird automatisch gelesen. Kein Login-Schritt in CI.

Jedes CI-System

GitHub Actions, GitLab CI oder alles andere, das eine Shell ausführt.

Automatisierungen und Webhooks

Löse Automatisierungen aus und verwalte Webhook-Abonnements im selben Tool.

Fragen zu CLI, beantwortet

Wie installiere ich die CLI?

Führe brew install fopost/tap/fopost aus, oder go install github.com/fopost/fopost-cli@latest, oder lade das Archiv für deine Plattform von der GitHub-Releases-Seite und lege fopost in deinen PATH.

Braucht man einen Account?

Ja. Die CLI spricht mit der gehosteten FoPost API und braucht daher einen API-Schlüssel, den du im Dashboard unter Einstellungen, API-Schlüssel erstellst. fopost auth login speichert ihn, oder setze stattdessen FOPOST_API_KEY.

Wo wird mein API-Schlüssel gespeichert?

In deinem Benutzer-Konfigurationsordner, nur für dich lesbar. Die CLI gibt ihn nie wieder aus: auth status zeigt ein maskiertes Präfix, und die ausführliche Ausgabe lässt ihn weg.

Was kann sie?

Posts, Accounts und ihr Zustand, Workspaces, Medien-Uploads, Labels, Analytics, Automatisierungen und Webhooks. Führe fopost --help aus oder lies die CLI-Dokumentation für jeden Befehl.

Ist sie Open Source?

Ja. Die CLI steht unter MIT-Lizenz, der Quellcode liegt auf GitHub unter fopost/fopost-cli.

Baue noch heute auf CLI

Der Start ist kostenlos und die vollständige API inklusive. Erstelle einen Schlüssel und mach in wenigen Minuten deinen ersten Aufruf.

API-Schlüssel holen