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

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é

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

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

Nécessite Node.js >= 20.0.0.

Authentification

Vous avez besoin d’une clé d’API pour utiliser la CLI. Consultez Authentification pour en générer une.

Clé d'API (recommandé)
Connexion par navigateur (flux d'appareil)
Variable d'environnement

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

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

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

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 :

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)
Tableau

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 │
└──────────────┴───────────────┴──────────┴───────────┘

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é

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

Connexion (clé d’API ou flux d’appareil), déconnexion, statut, whoami

Publications

Créer, programmer, modifier, relancer, soumettre à nouveau et supprimer des publications ; vue calendrier

Brouillons

Créer, modifier, supprimer des brouillons et les convertir en publications programmées

Comptes

Connecter, lister, inspecter et supprimer des comptes sociaux

Médias

Importer, rechercher, organiser en dossiers, renommer, déplacer et supprimer des fichiers

Analyses

Analyses par plateforme et par publication

Boîte de réception

Conversations, messages, réponses, réponses enregistrées, résolution, abonnements

Approbations

Lister, approuver et rejeter les publications en attente

Équipes

Inviter, lister, modifier, retirer des membres ; gérer les invitations

Biolinks

Créer et gérer des pages biolink, boutons, publications, thèmes et la publication

Paramètres

Profil, organisations, espaces de travail, clés d’API, utilisation, facturation, code de parrainage

IA

Générer du texte, des images et des vidéos UGC/avatar ; parcourir l’historique, les avatars, les sons

Commentaires

Lister, ajouter, modifier, supprimer et marquer comme lus les commentaires de publication

Support

Ouvrir des tickets, lister les tickets, lire et envoyer des messages

Modèles

Lister, inspecter et générer des modèles de contenu (mèmes, cartes de citation, témoignages)

Webhooks

Créer, lister, modifier, tester, relancer et inspecter les livraisons de webhooks

Facturation

Parcourir les offres, leurs fonctionnalités et les modules complémentaires

Gérer les modèles WhatsApp Business, importer des médias et envoyer des messages

Agent

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

# 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

Découvrez comment utiliser la CLI dans des scripts shell, des pipelines CI/CD et des workflows d’automatisation.

Premiers pas

Publication

AI Studio

Boîte de réception et engagement

Statistiques

Biolink

Équipe et collaboration

Paramètres et facturation

Webhooks

Assistance

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

Installation

Authentification

Options globales

Formats de sortie

Variables d’environnement

Groupes de commandes

Auth

Publications

Brouillons

Comptes

Médias

Analyses

Boîte de réception

Approbations

Équipes

Biolinks

Paramètres

IA

Commentaires

Support

Modèles

Webhooks

Facturation

WhatsApp

Agent

Référence des groupes de commandes

Exemples rapides

Scripts et automatisation

​Installation

​Authentification

​Options globales

​Formats de sortie

​Pagination

​Variables d’environnement

​Groupes de commandes

Auth

Publications

Brouillons

Comptes

Médias

Analyses

Boîte de réception

Approbations

Équipes

Biolinks

Paramètres

IA

Commentaires

Support

Modèles

Webhooks

Facturation

WhatsApp

Agent

​Référence des groupes de commandes

​Exemples rapides

Scripts et automatisation

Installation

Authentification

Options globales

Formats de sortie

Pagination

Variables d’environnement

Groupes de commandes

Référence des groupes de commandes

Exemples rapides