> ## Documentation Index
> Fetch the complete documentation index at: https://docs.so-me.studio/llms.txt
> Use this file to discover all available pages before exploring further.

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

> Installiere die Social-media-studio-CLI, um Beiträge zu planen, Entwürfe und Medien zu verwalten und Analysen mit deinem API-Schlüssel im Terminal oder in Skripten abzurufen.

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 |

> [!NOTE]
>
> 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

```bash npm theme={null}
npm install -g @social-media-scheduler/cli
```

```bash pnpm theme={null}
pnpm add -g @social-media-scheduler/cli
```

```bash yarn theme={null}
yarn global add @social-media-scheduler/cli
```

```bash npx (ohne Installation) theme={null}
npx @social-media-scheduler/cli posts:list
```

> [!NOTE]
>
> 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](/de/authentication.md).

**API-Schlüssel (empfohlen)**

```bash theme={null}
so-me auth:login --api-key sk_live_xxxxxxxxxxxxxxxxxxxxxxxx
```

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

**Browser-Anmeldung (Device Flow)**

```bash theme={null}
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).

**Umgebungsvariable**

```bash theme={null}
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:

```bash theme={null}
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)**

```bash theme={null}
so-me posts:list
```

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

**Tabelle**

```bash theme={null}
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 |

```bash theme={null}
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](/de/cli/auth.md)**
>
> Anmeldung (API-Schlüssel oder Device Flow), Abmeldung, Status, whoami

> **[Beiträge](/de/cli/posts.md)**
>
> Beiträge erstellen, planen, aktualisieren, wiederholen, erneut einreichen und löschen; Kalenderansicht

> **[Entwürfe](/de/cli/drafts.md)**
>
> Entwürfe erstellen, aktualisieren, löschen und in geplante Beiträge umwandeln

> **[Konten](/de/cli/accounts.md)**
>
> Social-Konten verbinden, auflisten, anzeigen und entfernen

> **[Medien](/de/cli/media.md)**
>
> Dateien hochladen, suchen, in Ordnern organisieren, umbenennen, verschieben und löschen

> **[Analysen](/de/cli/analytics.md)**
>
> Analysen auf Plattformebene und pro Beitrag

> **[Posteingang](/de/cli/inbox.md)**
>
> Konversationen, Nachrichten, Antworten, gespeicherte Antworten, Erledigen, Abonnements

> **[Freigaben](/de/cli/approvals.md)**
>
> Ausstehende Beiträge auflisten, freigeben und ablehnen

> **[Teams](/de/cli/teams.md)**
>
> Mitglieder einladen, auflisten, aktualisieren, entfernen; Einladungen verwalten

> **[Biolinks](/de/cli/biolinks.md)**
>
> Biolink-Seiten, Schaltflächen, Beiträge, Designs und Veröffentlichung erstellen und verwalten

> **[Einstellungen](/de/cli/settings.md)**
>
> Profil, Organisationen, Mandanten, API-Schlüssel, Nutzung, Abrechnung, Empfehlungscode

> **[KI](/de/cli/ai.md)**
>
> Texte, Bilder und UGC-/Avatar-Videos generieren; Verlauf, Avatare und Sounds durchsuchen

> **[Kommentare](/de/cli/comments.md)**
>
> Beitragskommentare auflisten, hinzufügen, bearbeiten, löschen und als gelesen markieren

> **[Support](/de/cli/support.md)**
>
> Tickets eröffnen und auflisten, Nachrichten lesen und senden

> **[Vorlagen](/de/cli/templates.md)**
>
> Inhaltsvorlagen (Memes, Zitatkarten, Testimonials) auflisten, anzeigen und rendern

> **[Webhooks](/de/cli/webhooks.md)**
>
> Webhooks erstellen, auflisten, aktualisieren, testen, wiederholen und Zustellungen prüfen

> **[Abrechnung](/de/cli/billing.md)**
>
> Tarife, Tarifmerkmale und Add-ons durchsuchen

> **[WhatsApp](/de/cli/whatsapp.md)**
>
> WhatsApp-Business-Vorlagen verwalten, Medien hochladen und Nachrichten senden

> **[Agent](/de/mcp/overview.md)**
>
> 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

```bash theme={null}
# 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](/de/cli/scripting.md)**
>
> Erfahre, wie du die CLI in Shell-Skripten, CI/CD-Pipelines und Automatisierungs-Workflows einsetzt.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.