> ## 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.

# CLI de réseaux sociaux : programmer des publications depuis le terminal

> Installez la CLI Social media studio pour programmer des publications, gérer brouillons et médias, et consulter les analyses depuis votre terminal ou vos scripts avec votre clé d'API.

La CLI Social media studio vous permet de gérer les publications, les brouillons, les comptes, les médias, la boîte de réception sociale, les analyses, la génération par IA et bien plus — directement depuis le terminal. Elle produit du JSON par défaut, ce qui facilite l'utilisation avec `jq` ou dans des scripts et pipelines CI/CD.

Le package fournit deux binaires :

| Binaire | URL d'API par défaut | Cas d'usage |
| - | - | - |
| `so-me` | `https://api.so-me.studio` | Production (par défaut) |
| `so-me-dev` | `http://localhost:8000` | Développement local avec un backend auto-hébergé |

> [!NOTE]
>
> Cette page documente la **version 2.2.0** de la CLI (`@social-media-scheduler/cli`). Toutes les commandes utilisent la syntaxe à deux-points — par exemple `posts:list`, `media:upload`, `ai:generate`. Exécutez `so-me --help` pour voir la liste complète des commandes, ou `so-me <command> --help` pour les options d'une commande.

## 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 (sans installation) theme={null}
npx @social-media-scheduler/cli posts:list
```

> [!NOTE]
>
> Nécessite **Node.js >= 20.0.0**.

## Authentification

Vous avez besoin d'une clé d'API pour utiliser la CLI. Consultez [Authentification](/fr/authentication.md) pour en générer une.

**Clé d'API (recommandé)**

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

La clé est stockée localement. Toutes les commandes suivantes l'utilisent automatiquement.

**Connexion par navigateur (flux d'appareil)**

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

Lance un flux d'autorisation d'appareil OAuth2 : la CLI affiche une URL de vérification et un code à usage unique, ouvre votre navigateur, puis interroge le serveur jusqu'à ce que vous approuviez. Une clé d'API est générée et enregistrée automatiquement si votre offre inclut l'accès à l'API (offre Standard, Advanced ou Lifetime).

**Variable d'environnement**

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

Utile pour les pipelines CI/CD et les scripts. La variable d'environnement est utilisée lorsqu'aucune clé n'est fournie via `--api-key` ou dans les identifiants stockés.

Vérifiez votre authentification :

```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
```

## Options globales

Chaque commande accepte ces options. Les formes longue et courte sont indiquées lorsqu'un alias court existe.

| Option | Description |
| - | - |
| `--api-key <key>` | Remplace la clé d'API stockée pour cette commande |
| `--api-url <url>` | Remplace l'URL de base de l'API (par défaut : `https://api.so-me.studio`, ou `http://localhost:8000` pour `so-me-dev`) |
| `--json` | Sortie au format JSON (**par défaut**) |
| `--table` | Sortie sous forme de tableau formaté |
| `--verbose` | Affiche des informations d'erreur détaillées |
| `-V, --version` | Affiche la version de la CLI (`2.2.0`) |
| `-h, --help` | Affiche l'aide de la CLI ou d'une commande |

## Formats de sortie

La sortie est en JSON par défaut. Ajoutez `--table` pour obtenir un tableau lisible sur les commandes qui le prennent en charge.

**JSON (par défaut)**

```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"
  }
]
```

**Tableau**

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

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

### Pagination

La plupart des commandes de liste acceptent des options de pagination :

| Option | Description | Par défaut |
| - | - | - |
| `--page <n>` | Numéro de la page à récupérer | `1` |
| `--limit <n>` | Éléments par page | selon la commande |
| `--all` | Récupère toutes les pages (lorsque c'est pris en charge) | désactivé |

```bash theme={null}
so-me posts:list --page 2 --limit 50
so-me media:list --all --table
```

## Variables d'environnement

| Variable | Description | Par défaut |
| - | - | - |
| `SOME_API_KEY` | Clé d'API (alternative à l'option `--api-key` ou à `auth:login`) | — |
| `SOME_API_URL` | URL de base de l'API | `https://api.so-me.studio` (`so-me`) / `http://localhost:8000` (`so-me-dev`) |

## Groupes de commandes

La CLI enregistre les groupes de commandes suivants. Chacun renvoie vers sa référence détaillée.

> **[Auth](/fr/cli/auth.md)**
>
> Connexion (clé d'API ou flux d'appareil), déconnexion, statut, whoami

> **[Publications](/fr/cli/posts.md)**
>
> Créer, programmer, modifier, relancer, soumettre à nouveau et supprimer des publications ; vue calendrier

> **[Brouillons](/fr/cli/drafts.md)**
>
> Créer, modifier, supprimer des brouillons et les convertir en publications programmées

> **[Comptes](/fr/cli/accounts.md)**
>
> Connecter, lister, inspecter et supprimer des comptes sociaux

> **[Médias](/fr/cli/media.md)**
>
> Importer, rechercher, organiser en dossiers, renommer, déplacer et supprimer des fichiers

> **[Analyses](/fr/cli/analytics.md)**
>
> Analyses par plateforme et par publication

> **[Boîte de réception](/fr/cli/inbox.md)**
>
> Conversations, messages, réponses, réponses enregistrées, résolution, abonnements

> **[Approbations](/fr/cli/approvals.md)**
>
> Lister, approuver et rejeter les publications en attente

> **[Équipes](/fr/cli/teams.md)**
>
> Inviter, lister, modifier, retirer des membres ; gérer les invitations

> **[Biolinks](/fr/cli/biolinks.md)**
>
> Créer et gérer des pages biolink, boutons, publications, thèmes et la publication

> **[Paramètres](/fr/cli/settings.md)**
>
> Profil, organisations, espaces de travail, clés d'API, utilisation, facturation, code de parrainage

> **[IA](/fr/cli/ai.md)**
>
> Générer du texte, des images et des vidéos UGC/avatar ; parcourir l'historique, les avatars, les sons

> **[Commentaires](/fr/cli/comments.md)**
>
> Lister, ajouter, modifier, supprimer et marquer comme lus les commentaires de publication

> **[Support](/fr/cli/support.md)**
>
> Ouvrir des tickets, lister les tickets, lire et envoyer des messages

> **[Modèles](/fr/cli/templates.md)**
>
> Lister, inspecter et générer des modèles de contenu (mèmes, cartes de citation, témoignages)

> **[Webhooks](/fr/cli/webhooks.md)**
>
> Créer, lister, modifier, tester, relancer et inspecter les livraisons de webhooks

> **[Facturation](/fr/cli/billing.md)**
>
> Parcourir les offres, leurs fonctionnalités et les modules complémentaires

> **[WhatsApp](/fr/cli/whatsapp.md)**
>
> Gérer les modèles WhatsApp Business, importer des médias et envoyer des messages

> **[Agent](/fr/mcp/overview.md)**
>
> Exporter le catalogue canonique d'outils pour OpenClaw, Hermes, OpenAI, Anthropic et MCP

### Référence des groupes de commandes

| Groupe | Préfixe | Fonction |
| - | - | - |
| Auth | `auth:` | S'authentifier (`auth:login`), vérifier le statut (`auth:status`), vérifier l'identité (`auth:whoami`) et se déconnecter (`auth:logout`) |
| Publications | `posts:` | Cycle de vie complet d'une publication : `posts:create`, `posts:list`, `posts:get`, `posts:update`, `posts:schedule`, `posts:unschedule`, `posts:retry`, `posts:resubmit`, `posts:delete`, `posts:bulk-delete`, `posts:calendar` |
| Brouillons | `drafts:` | `drafts:create`, `drafts:list`, `drafts:get`, `drafts:update`, `drafts:delete`, `drafts:convert` |
| Comptes | `accounts:` | `accounts:connect`, `accounts:list`, `accounts:get`, `accounts:get-details`, `accounts:remove`, `accounts:remove-by-id` |
| Médias | `media:` | `media:upload`, `media:list`, `media:get`, `media:search`, `media:rename`, `media:move`, `media:delete`, `media:bulk-delete`, ainsi que les opérations sur les dossiers (`media:folders`, `media:create-folder`, `media:rename-folder`, `media:move-folder`) |
| Analyses | `analytics:` | `analytics:platform`, `analytics:post` |
| Boîte de réception | `inbox:` | `inbox:list`, `inbox:messages`, `inbox:reply`, `inbox:read`, `inbox:resolve`, `inbox:delete`, réponses enregistrées (`inbox:saved-replies`, `inbox:create-reply`, `inbox:edit-reply`, `inbox:delete-reply`) et abonnements à la boîte de réception étendue (`inbox:subscribe`, `inbox:unsubscribe`, `inbox:enable`, `inbox:disable`) |
| Approbations | `approvals:` | `approvals:list`, `approvals:approve`, `approvals:reject` |
| Équipes | `teams:` | `teams:list`, `teams:invite`, `teams:invitations`, `teams:cancel-invite`, `teams:update`, `teams:remove` |
| Biolinks | `biolink:` | Pages (`biolink:create`, `biolink:list`, `biolink:get`, `biolink:update`, `biolink:delete`, `biolink:publish`, `biolink:public`, `biolink:theme`, `biolink:analytics`), boutons (`biolink:buttons`, `biolink:add-button`, `biolink:update-button`, `biolink:delete-button`, `biolink:reorder-buttons`) et publications (`biolink:posts`, `biolink:add-post`, `biolink:update-post`, `biolink:delete-post`, `biolink:reorder-posts`) |
| Paramètres | `settings:` | Profil (`settings:profile`, `settings:update-profile`), organisations (`settings:org`, `settings:create-org`, `settings:update-org`, `settings:delete-org`, `settings:leave-org`, `settings:tenants`), clés d'API (`settings:api-keys`, `settings:create-api-key`, `settings:revoke-api-key`), `settings:usage`, `settings:billing`, `settings:referral-code` |
| IA | `ai:` | Texte (`ai:generate`, `ai:generate-and-schedule`, `ai:history`), image (`ai:image`, `ai:image:list`, `ai:image:get`, `ai:image:delete`), vidéo/UGC (`ai:video:generate`, `ai:video:list`, `ai:video:get`, `ai:video:delete`, `ai:video:avatars`, `ai:video:sounds`, `ai:video:hooks`) |
| Commentaires | `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` |
| Modèles | `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` |
| Facturation | `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` — récupère le catalogue d'outils MCP et l'exporte dans le format d'un agent cible |

## Exemples rapides

```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'
```

> **[Scripts et automatisation](/fr/cli/scripting.md)**
>
> Découvrez comment utiliser la CLI dans des scripts shell, des pipelines CI/CD et des workflows d'automatisation.


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