Social-Media-CLI: Beiträge im Terminal planen

Mit der Social-media-studio-CLI verwaltest du Beiträge, Entwürfe, Konten, Medien, den Social-Posteingang, Analysen, KI-Generierung und vieles mehr — direkt im Terminal. Sie gibt standardmäßig JSON aus, das sich leicht an jq weiterleiten oder in Skripten und CI/CD-Pipelines verwenden lässt. Das Paket liefert zwei Binaries mit:

Binary	Standard-API-URL	Einsatzzweck
`so-me`	`https://api.so-me.studio`	Produktion (Standard)
`so-me-dev`	`http://localhost:8000`	Lokale Entwicklung gegen ein selbst gehostetes Backend

Diese Seite dokumentiert die CLI Version 2.2.0 (@social-media-scheduler/cli). Alle Befehle verwenden die Doppelpunkt-Syntax — zum Beispiel posts:list, media:upload, ai:generate. Mit so-me --help siehst du die vollständige Befehlsliste, mit so-me <command> --help die Flags eines einzelnen Befehls.

Installation

npm install -g @social-media-scheduler/cli

pnpm add -g @social-media-scheduler/cli

yarn global add @social-media-scheduler/cli

npx @social-media-scheduler/cli posts:list

Erfordert Node.js >= 20.0.0.

Authentifizierung

Du benötigst einen API-Schlüssel, um die CLI zu nutzen. Wie du einen erzeugst, steht unter Authentifizierung.

API-Schlüssel (empfohlen)
Browser-Anmeldung (Device Flow)
Umgebungsvariable

so-me auth:login --api-key sk_live_xxxxxxxxxxxxxxxxxxxxxxxx

Der Schlüssel wird lokal gespeichert. Alle künftigen Befehle verwenden ihn automatisch.

so-me auth:login

Startet einen OAuth2-Device-Authorization-Flow: Die CLI gibt eine Verifizierungs-URL und einen Einmalcode aus, öffnet deinen Browser und fragt so lange ab, bis du bestätigst. Ein API-Schlüssel wird automatisch erzeugt und gespeichert, wenn dein Tarif API-Zugriff unterstützt (Standard, Advanced oder Lifetime).

export SOME_API_KEY=sk_live_xxxxxxxxxxxxxxxxxxxxxxxx
so-me posts:list

Praktisch für CI/CD-Pipelines und Skripte. Die Umgebungsvariable wird verwendet, wenn weder per --api-key noch über gespeicherte Zugangsdaten ein Schlüssel angegeben ist.

Prüfe deine Authentifizierung:

so-me auth:status        # show stored key + API URL
so-me auth:whoami        # verify the key against the API; print user + organization

Globale Optionen

Jeder Befehl akzeptiert diese Flags. Lange und kurze Form sind beide angegeben, wenn es einen Kurzalias gibt.

Option	Beschreibung
`--api-key <key>`	Überschreibt den gespeicherten API-Schlüssel für diesen Befehl
`--api-url <url>`	Überschreibt die API-Basis-URL (Standard: `https://api.so-me.studio`, bzw. `http://localhost:8000` für `so-me-dev`)
`--json`	Ausgabe als JSON (Standard)
`--table`	Ausgabe als formatierte Tabelle
`--verbose`	Detaillierte Fehlerinformationen anzeigen
`-V, --version`	Gibt die CLI-Version aus (`2.2.0`)
`-h, --help`	Zeigt die Hilfe für die CLI oder einen Befehl an

Ausgabeformate

Die Ausgabe ist standardmäßig JSON. Übergib --table für eine lesbare Tabelle bei Befehlen, die dies unterstützen.

JSON (Standard)
Tabelle

so-me posts:list

[
  {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "text": "Hello world!",
    "socialMedia": "TWITTER",
    "postStatus": "SCHEDULED",
    "scheduledAt": "2026-04-12T09:00:00.000Z"
  }
]

so-me posts:list --table

┌──────────────┬───────────────┬──────────┬───────────┐
│ ID           │ Text          │ Platform │ Status    │
├──────────────┼───────────────┼──────────┼───────────┤
│ 550e8400...  │ Hello world!  │ TWITTER  │ SCHEDULED │
└──────────────┴───────────────┴──────────┴───────────┘

Paginierung

Die meisten Listenbefehle akzeptieren Paginierungs-Flags:

Flag	Beschreibung	Standard
`--page <n>`	Abzurufende Seitennummer	`1`
`--limit <n>`	Einträge pro Seite	befehlsspezifisch
`--all`	Alle Seiten abrufen (sofern unterstützt)	aus

so-me posts:list --page 2 --limit 50
so-me media:list --all --table

Umgebungsvariablen

Variable	Beschreibung	Standard
`SOME_API_KEY`	API-Schlüssel (Alternative zum Flag `--api-key` oder zu `auth:login`)	—
`SOME_API_URL`	API-Basis-URL	`https://api.so-me.studio` (`so-me`) / `http://localhost:8000` (`so-me-dev`)

Befehlsgruppen

Die CLI registriert die folgenden Befehlsgruppen. Jede verlinkt auf ihre ausführliche Referenz.

Auth

Anmeldung (API-Schlüssel oder Device Flow), Abmeldung, Status, whoami

Beiträge

Beiträge erstellen, planen, aktualisieren, wiederholen, erneut einreichen und löschen; Kalenderansicht

Entwürfe

Entwürfe erstellen, aktualisieren, löschen und in geplante Beiträge umwandeln

Konten

Social-Konten verbinden, auflisten, anzeigen und entfernen

Medien

Dateien hochladen, suchen, in Ordnern organisieren, umbenennen, verschieben und löschen

Analysen

Analysen auf Plattformebene und pro Beitrag

Posteingang

Konversationen, Nachrichten, Antworten, gespeicherte Antworten, Erledigen, Abonnements

Freigaben

Ausstehende Beiträge auflisten, freigeben und ablehnen

Teams

Mitglieder einladen, auflisten, aktualisieren, entfernen; Einladungen verwalten

Biolinks

Biolink-Seiten, Schaltflächen, Beiträge, Designs und Veröffentlichung erstellen und verwalten

Einstellungen

Profil, Organisationen, Mandanten, API-Schlüssel, Nutzung, Abrechnung, Empfehlungscode

KI

Texte, Bilder und UGC-/Avatar-Videos generieren; Verlauf, Avatare und Sounds durchsuchen

Kommentare

Beitragskommentare auflisten, hinzufügen, bearbeiten, löschen und als gelesen markieren

Support

Tickets eröffnen und auflisten, Nachrichten lesen und senden

Vorlagen

Inhaltsvorlagen (Memes, Zitatkarten, Testimonials) auflisten, anzeigen und rendern

Webhooks

Webhooks erstellen, auflisten, aktualisieren, testen, wiederholen und Zustellungen prüfen

Abrechnung

Tarife, Tarifmerkmale und Add-ons durchsuchen

WhatsApp-Business-Vorlagen verwalten, Medien hochladen und Nachrichten senden

Agent

Den kanonischen Tool-Katalog für OpenClaw, Hermes, OpenAI, Anthropic und MCP exportieren

Referenz der Befehlsgruppen

Gruppe	Präfix	Funktion
Auth	`auth:`	Authentifizieren (`auth:login`), Status prüfen (`auth:status`), Identität verifizieren (`auth:whoami`) und abmelden (`auth:logout`)
Beiträge	`posts:`	Vollständiger Beitragslebenszyklus: `posts:create`, `posts:list`, `posts:get`, `posts:update`, `posts:schedule`, `posts:unschedule`, `posts:retry`, `posts:resubmit`, `posts:delete`, `posts:bulk-delete`, `posts:calendar`
Entwürfe	`drafts:`	`drafts:create`, `drafts:list`, `drafts:get`, `drafts:update`, `drafts:delete`, `drafts:convert`
Konten	`accounts:`	`accounts:connect`, `accounts:list`, `accounts:get`, `accounts:get-details`, `accounts:remove`, `accounts:remove-by-id`
Medien	`media:`	`media:upload`, `media:list`, `media:get`, `media:search`, `media:rename`, `media:move`, `media:delete`, `media:bulk-delete`, dazu Ordneroperationen (`media:folders`, `media:create-folder`, `media:rename-folder`, `media:move-folder`)
Analysen	`analytics:`	`analytics:platform`, `analytics:post`
Posteingang	`inbox:`	`inbox:list`, `inbox:messages`, `inbox:reply`, `inbox:read`, `inbox:resolve`, `inbox:delete`, gespeicherte Antworten (`inbox:saved-replies`, `inbox:create-reply`, `inbox:edit-reply`, `inbox:delete-reply`) und Abonnements des erweiterten Posteingangs (`inbox:subscribe`, `inbox:unsubscribe`, `inbox:enable`, `inbox:disable`)
Freigaben	`approvals:`	`approvals:list`, `approvals:approve`, `approvals:reject`
Teams	`teams:`	`teams:list`, `teams:invite`, `teams:invitations`, `teams:cancel-invite`, `teams:update`, `teams:remove`
Biolinks	`biolink:`	Seiten (`biolink:create`, `biolink:list`, `biolink:get`, `biolink:update`, `biolink:delete`, `biolink:publish`, `biolink:public`, `biolink:theme`, `biolink:analytics`), Schaltflächen (`biolink:buttons`, `biolink:add-button`, `biolink:update-button`, `biolink:delete-button`, `biolink:reorder-buttons`) und Beiträge (`biolink:posts`, `biolink:add-post`, `biolink:update-post`, `biolink:delete-post`, `biolink:reorder-posts`)
Einstellungen	`settings:`	Profil (`settings:profile`, `settings:update-profile`), Organisationen (`settings:org`, `settings:create-org`, `settings:update-org`, `settings:delete-org`, `settings:leave-org`, `settings:tenants`), API-Schlüssel (`settings:api-keys`, `settings:create-api-key`, `settings:revoke-api-key`), `settings:usage`, `settings:billing`, `settings:referral-code`
KI	`ai:`	Text (`ai:generate`, `ai:generate-and-schedule`, `ai:history`), Bild (`ai:image`, `ai:image:list`, `ai:image:get`, `ai:image:delete`), Video/UGC (`ai:video:generate`, `ai:video:list`, `ai:video:get`, `ai:video:delete`, `ai:video:avatars`, `ai:video:sounds`, `ai:video:hooks`)
Kommentare	`comments:`	`comments:list`, `comments:add`, `comments:update`, `comments:delete`, `comments:mark-read`
Support	`support:`	`support:create-ticket`, `support:list-tickets`, `support:get-ticket`, `support:list-messages`, `support:send-message`
Vorlagen	`templates:`	`templates:list`, `templates:get`, `templates:render`
Webhooks	`webhooks:`	`webhooks:create`, `webhooks:list`, `webhooks:get`, `webhooks:update`, `webhooks:delete`, `webhooks:test`, `webhooks:retry`, `webhooks:deliveries`, `webhooks:events`
Abrechnung	`billing:`	`billing:plans`, `billing:plan-features`, `billing:addons`
WhatsApp	`whatsapp:`	`whatsapp:templates`, `whatsapp:create-template`, `whatsapp:delete-template`, `whatsapp:upload-media`, `whatsapp:send`
Agent	`agent`	`agent export-tools` — den MCP-Tool-Katalog abrufen und für ein Ziel-Agentenformat ausgeben

Kurze Beispiele

# Create and schedule a tweet
so-me posts:create -c "Launching today!" --platform TWITTER -s 2026-04-12T09:00:00Z

# Generate an AI caption for a platform
so-me ai:generate --prompt "Product launch announcement" --platform LINKEDIN

# Generate a caption and schedule it in one step
so-me ai:generate-and-schedule --prompt "Product launch announcement" --platform LINKEDIN

# Upload an image and list your media
so-me media:upload ./banner.png
so-me media:list --table

# Check platform analytics for the last 30 days
so-me analytics:platform acc-123 --days 30

# Show comments on a post
so-me comments:list <post-id>

# Check pending approvals
so-me approvals:list

# Export the agent tool catalog in every supported format
so-me agent export-tools --all --out ./agent-tools

# Pipe JSON output to jq
so-me posts:list | jq '.[].text'

Skripting und Automatisierung

Erfahre, wie du die CLI in Shell-Skripten, CI/CD-Pipelines und Automatisierungs-Workflows einsetzt.

Erste Schritte

Veröffentlichen

AI Studio

Posteingang und Interaktion

Analysen

Biolink

Team und Zusammenarbeit

Einstellungen und Abrechnung

Webhooks

Support

Social-Media-CLI: Beiträge im Terminal planen

Installation

Authentifizierung

Globale Optionen

Ausgabeformate

Paginierung

Umgebungsvariablen

Befehlsgruppen

Auth

Beiträge

Entwürfe

Konten

Medien

Analysen

Posteingang

Freigaben

Teams

Biolinks

Einstellungen

KI

Kommentare

Support

Vorlagen

Webhooks

Abrechnung

WhatsApp

Agent

Referenz der Befehlsgruppen

Kurze Beispiele

Skripting und Automatisierung

​Installation

​Authentifizierung

​Globale Optionen

​Ausgabeformate

​Paginierung

​Umgebungsvariablen

​Befehlsgruppen

Auth

Beiträge

Entwürfe

Konten

Medien

Analysen

Posteingang

Freigaben

Teams

Biolinks

Einstellungen

KI

Kommentare

Support

Vorlagen

Webhooks

Abrechnung

WhatsApp

Agent

​Referenz der Befehlsgruppen

​Kurze Beispiele

Skripting und Automatisierung

Installation

Authentifizierung

Globale Optionen

Ausgabeformate

Paginierung

Umgebungsvariablen

Befehlsgruppen

Referenz der Befehlsgruppen

Kurze Beispiele