Aller au contenu

La CLI nadia

nadia, c’est l’API publique en ligne de commande. Planifier une publication, poser une idée sur le tableau de contenus, lire les chiffres d’un canal, répondre à un commentaire ou à un DM, depuis votre terminal, une tâche cron ou un agent, sans écrire un seul curl.

Fenêtre de terminal
npm install -g @usenadia/cli
nadia --help

Le paquet publié n’a aucune dépendance à l’exécution : le SDK qu’il appelle est embarqué.

  • Une commande par opération de l’API, générée depuis la spec de l’API. nadia list-channels, nadia create-post, nadia move-content… 77 en tout, nommées d’après l’opération. Un endpoint ajouté à l’API devient une commande à la version suivante ; rien n’est écrit à la main.
  • Des raccourcis par-dessus, courts et simples : nadia channels, nadia post, nadia move k1 to-shoot. Chacun remplace une commande générée (ou quelques appels enchaînés) : tous les flags de la commande sous-jacente marchent aussi dessus.
Fenêtre de terminal
nadia --help # les deux listes, commandes générées groupées par domaine
nadia <command> --help # les flags et les exemples d'une commande
nadia schema <command> # ce que prend une commande, en JSON (pour les agents)
Fenêtre de terminal
# 1. Enregistrer votre clé API (Paramètres → API &amp; MCP)
nadia auth login
# 2. Vos canaux connectés, et leurs id
nadia channels
# 3. Planifier un reel : la vidéo locale est téléversée d'abord
nadia post -i "$IG" -s 2026-10-02T09:00:00+02:00 \
-c "Three places in Malta" -m ./reel.mp4 \
--settings '{"post_type":"post"}'
# 4. Ce qui arrive
nadia posts
Raccourci Fait Commande générée
nadia channels Vos canaux connectés : leurs id sont ce que prend tout le reste list-channels
nadia post Planifie, publie tout de suite ou met en brouillon une publication ; les médias locaux sont téléversés d’abord upload-file + create-post
nadia posts Vos publications, d’une semaine en arrière à quatre semaines en avant, sauf --from/--to list-posts
nadia upload <file|url> Met un fichier ou une URL dans la bibliothèque de médias upload-file / upload-from-url
nadia stats <channel> Les métriques d’un canal sur les derniers jours (--days, 7 par défaut) get-channel-analytics
nadia cards Les cartes du tableau de contenus, éventuellement d’une seule colonne (--stage) list-contents
nadia card <id> Une carte get-content
nadia idea <title> Pose une idée sur le tableau (une carte en IDEA) create-content
nadia move <id> <stage> Déplace une carte vers une autre colonne move-content
nadia link <id> <post-group> Relie une carte à sa publication planifiée link-content-post
nadia reply <comment-id> <message> Répond publiquement à un commentaire reply-to-comment
nadia dm <channel> <recipient> <text> Envoie un message direct send-direct-message
nadia inbox <channel> Les conversations DM d’un canal list-conversations
nadia auth login|status|logout Enregistre, vérifie ou retire votre clé —

Comment une opération de la spec devient une commande :

Dans l’API En ligne de commande
opération moveContent nadia move-content
paramètres de chemin (/contents/{id}/move) arguments positionnels, dans l’ordre du chemin : nadia move-content <id>
paramètres de requête flags : --start-date 2026-10-01
champs de premier niveau du corps JSON des flags aussi : integrationIds → --integration-ids
le corps entier --body '{…}', --body @file.json ou --body @- (stdin) ; les flags s’appliquent par-dessus

Les valeurs sont vérifiées par rapport à la spec avant tout envoi :

  • enum : insensible à la casse, to-shoot → TO_SHOOT ;
  • tableau : séparé par des virgules et/ou flag répété, --keywords LIEN,GUIDE ;
  • booléen : --fuzzy, --no-fuzzy, --fuzzy false ;
  • nombre : analysé, entiers vérifiés ;
  • nullable : le littéral null vide le champ, --hook null ;
  • chaîne : @path lit le fichier s’il existe, --script @script.md ;
  • fichier : un chemin local, téléversé, nadia upload-file --file ./reel.mp4.

Les domaines par lesquels nadia --help les groupe sont le premier segment du chemin de chaque endpoint : posts, integrations, analytics, contents (le tableau), automation-flows et automation-flow-poses (les automatisations commentaire → DM), inbox (les commentaires et les messages directs), webhooks, hooks, music, et other pour les endpoints isolés (les téléversements, find-slot, list-groups, list-notifications, la génération de vidéo, get-channel-settings, run-channel-tool et l’historique d’analyses collecté).

Quelques groupes inattendus, puisque rien dans les menus de l’app ne les annonce : webhooks (create-webhook, list-webhook-events…), list-notifications (la cloche de l’app) et, sous inbox, la modération des commentaires (hide-comment, delete-comment).

  • stdout ne contient que du JSON : envoyez-le dans jq. Les messages vont sur stderr.
  • Codes de sortie : 0 fait, 1 l’API a refusé (ou n’a jamais répondu), 2 mauvais usage : rien n’a été envoyé.
  • Les réponses 429 et 5xx sont retentées deux fois avant abandon.
  • --dry-run, après le nom de la commande, affiche la requête au lieu de l’envoyer, et n’a besoin d’aucune clé :
Fenêtre de terminal
nadia move --dry-run k1 to-shoot