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.
Installation
Section intitulée « Installation »npm install -g @usenadia/clinadia --helpLe paquet publié n’a aucune dépendance à l’exécution : le SDK qu’il appelle est embarqué.
Deux couches
Section intitulée « Deux couches »- 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.
nadia --help # les deux listes, commandes générées groupées par domainenadia <command> --help # les flags et les exemples d'une commandenadia schema <command> # ce que prend une commande, en JSON (pour les agents)Démarrage rapide
Section intitulée « Démarrage rapide »# 1. Enregistrer votre clé API (Paramètres → API & MCP)nadia auth login
# 2. Vos canaux connectés, et leurs idnadia channels
# 3. Planifier un reel : la vidéo locale est téléversée d'abordnadia 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 arrivenadia postsRaccourcis
Section intitulée « Raccourcis »| 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é | — |
Commandes générées
Section intitulée « Commandes générées »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
nullvide le champ,--hook null; - chaîne :
@pathlit 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).
Hooks et musique
Section intitulée « Hooks et musique »Contrat pour les scripts
Section intitulée « Contrat pour les scripts »- stdout ne contient que du JSON : envoyez-le dans
jq. Les messages vont sur stderr. - Codes de sortie :
0fait,1l’API a refusé (ou n’a jamais répondu),2mauvais 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é :
nadia move --dry-run k1 to-shoot