Lancer des pubs depuis la ligne de commande : la CLI Hermoso

Les outils publicitaires sont presque entièrement faits de tableaux de bord, ce qui les rend presque impossibles à automatiser. On ne peut pas programmer un tableau de bord avec cron, on ne peut pas l'envoyer dans jq, et on ne peut pas demander à un agent de terminal de cliquer dessus. La CLI Hermoso existe pour que la boucle publicitaire cesse d'être un endroit que vous visitez et devienne quelque chose que vous pouvez scripter.

Installer et se connecter :

npm install -g hermoso
hermoso auth login

auth login lance un écouteur en boucle locale et ouvre le navigateur, comme le font gh et firebase, donc il n'y a rien à coller. La clé générée est écrite dans ~/.hermoso/config.json avec des droits réservés à votre utilisateur (dossier 0700, fichier 0600), car elle donne un vrai pouvoir de dépense. Pour la CI, hermoso auth login --token <key> en enregistre une sans interaction, et HERMOSO_TOKEN / HERMOSO_API_BASE remplacent la configuration depuis l'environnement.

Les commandes

Chaque commande accepte --json, et c'est là l'essentiel : la ligne lisible par un humain est une commodité, le JSON est le contrat.

Commande	Ce qu'elle fait
`hermoso capabilities`	Identifiants de modèles valides et leurs coûts exacts en crédits. À lancer en premier. C'est gratuit et en lecture seule, et cela évite de deviner les noms de modèles.
`hermoso credits`	Solde, consommation de la session et appels facturés récents.
`hermoso brand --domain example.com`	Lit un site pour en tirer un profil de marque (produits, palette, logo, ton) sur lequel les rendus ultérieurs s'appuient.
`hermoso competitors --domain example.com`	Trouve les concurrents directs et les marques similaires dont il vaut la peine d'apprendre.
`hermoso ads --company "Brand"`	Récupère les vraies pubs diffusées par cet annonceur dans les bibliothèques Meta, Google et LinkedIn, dédoublonnées et triées.
`hermoso research "longest-running protein bar ads"`	Recherche de pubs en langage naturel dans les bibliothèques, plus TikTok en contenu organique, qui renvoie les pubs trouvées.
`hermoso create --brand … --product … --format video`	Transforme un brief en concept de pub fini : variantes de texte plus une idée d'image ou un storyboard vidéo, avec les identifiants de modèles pour la rendre.
`hermoso generate image --prompt "…" --ref ./bottle.png`	Produit un rendu et renvoie une URL servie. `--ref` intègre votre vrai produit pour que l'étiquette à l'écran soit votre vrai SKU.
`hermoso jobs` / `hermoso fetch <url>`	Inspecte les rendus en cours ; transforme n'importe quel élément en lien cliquable et en URL de téléchargement direct.
`hermoso mcp`	Sert la surface MCP complète de plus de 922 outils via stdio, les mêmes outils que ceux du serveur hébergé.

Deux surfaces, un seul paquet, et pourquoi c'est important

Les agents de terminal paient les outils deux fois : une fois dans le manifeste qu'ils portent dans leur contexte, et une fois dans les jetons que coûte chaque appel. Un manifeste de plus de 922 outils n'est pas gratuit. Le même paquet fournit donc les deux surfaces et laisse l'agent choisir :

MCP (hermoso mcp, ou l'hébergé https://app.hermoso.ai/mcp) quand vous voulez la surface complète et des arguments typés riches.
Commandes en sous-processus quand vous voulez le chemin économe en jetons : l'agent lance une commande, lit le JSON, et ne charge jamais de manifeste. C'est le schéma qu'utilisent les compétences Claude fournies.

Les deux appellent la même API, facturent les mêmes crédits et écrivent dans la même bibliothèque, donc rien ne reste bloqué d'un côté.

Ce qui vaut la peine d'être scripté

Une veille concurrentielle hebdomadaire. hermoso competitors dans hermoso ads, comparaison avec la semaine précédente, et vous obtenez un rapport permanent sur ce que votre marché a commencé et arrêté de diffuser.
Créations en lot pour un catalogue. Bouclez sur les SKU, rendez une pub ancrée sur chaque produit, et récupérez les URL renvoyées. C'est le genre de tâche vraiment fastidieuse dans une interface.
Un garde-fou de crédits en CI. hermoso credits --json | jq .balance, et faire échouer le pipeline avant qu'un long lot ne démarre sur un solde vide.
Choix du modèle selon le coût. hermoso capabilities --json expose les coûts exacts par modèle, donc un script peut choisir le modèle le moins cher qui satisfait le brief au lieu d'en coder un en dur.

Publication et campagnes

Les sous-commandes de la CLI couvrent la recherche et la création. La publication, la programmation et la gestion de campagnes sur Meta, Google Ads, Microsoft Advertising, Reddit Ads, LinkedIn, Pinterest, X Ads, TikTok Ads, Snapchat Ads, ChatGPT Ads, Apple Search Ads et AppLovin Ads se trouvent dans la surface MCP, accessible depuis le même paquet avec hermoso mcp, depuis le point de terminaison hébergé, ou depuis le studio web. Les destinations de publication sont Facebook, Instagram, Threads, TikTok, YouTube, X, LinkedIn, Pinterest, Bluesky, Telegram et Google Business Profile.

Ce qu'il ne fera pas sans demander

Un agent doté d'un budget n'est utile que si l'impact d'une erreur est limité, donc le pouvoir de dépense est encadré dans le serveur plutôt que dans une consigne. Les campagnes, ensembles de publicités et annonces Meta sont créés en PAUSED, sans aucune possibilité de les modifier. Les bascules de statut qui peuvent activer une dépense publicitaire réelle (une sur chaque plateforme : set_meta_campaign_status, set_google_ads_status, set_microsoft_ads_status, set_reddit_ads_status, set_linkedin_ads_status, set_pinterest_ads_status, set_x_ads_status et set_openai_ads_status, entre autres) refusent de s'exécuter sans indicateur de confirmation explicite, et la même barrière s'applique à la création d'un groupe d'annonces, d'une annonce ou d'un mot-clé Google Ads activé sous un parent déjà activé, car cela se diffuse dès la prochaine enchère. Les suppressions sont aussi soumises à confirmation. Côté génération, hermoso_capabilities publie le coût exact en crédits de chaque modèle avant toute exécution, et chaque rendu réserve une estimation puis règle le coût réel, donc un envoi échoué est remboursé au lieu d'être facturé en silence.

Vous travaillez dans un agent plutôt que dans un shell ? Voir marketing automatisé avec Claude Code et la référence complète MCP & CLI.

Questions fréquentes

Existe-t-il un outil en ligne de commande pour lancer des pubs ?

Oui. npm install -g hermoso installe la CLI Hermoso, qui étudie les pubs concurrentes dans les bibliothèques Meta, Google et LinkedIn, rédige un profil de marque à partir d'un site, planifie et produit des pubs image et vidéo finies, et affiche les crédits et les tâches, avec une sortie --json sur chaque commande pour les scripts. Le même paquet sert aussi le serveur MCP complet de plus de 922 outils via stdio.

Comment m'authentifier avec la CLI Hermoso ?

Lancez hermoso auth login. Cela ouvre une connexion par navigateur en boucle locale (le même schéma que gh et firebase) et enregistre la clé générée dans ~/.hermoso/config.json avec des droits réservés à votre utilisateur (dossier 0700, fichier 0600). Pour la CI, hermoso auth login --token <key> en enregistre une sans interaction, et HERMOSO_TOKEN et HERMOSO_API_BASE remplacent la configuration depuis l'environnement.

Puis-je envoyer la sortie dans jq ?

Oui. Chaque commande accepte --json et affiche un objet structuré. C'est le contrat voulu ; la ligne lisible n'est qu'une commodité. hermoso credits --json | jq .balance est un garde-fou utile en CI avant un long lot de rendus.

Pourquoi utiliser la CLI plutôt que le serveur MCP ?

Le coût en jetons. Un client MCP charge le manifeste d'outils dans le contexte, et plus de 922 outils ne sont pas gratuits. Un agent de terminal qui lance des commandes en sous-processus et lit le JSON ne porte aucun manifeste. Les deux surfaces appellent la même API, facturent les mêmes crédits et écrivent dans la même bibliothèque, donc vous pouvez les combiner.

La CLI peut-elle publier sur Facebook ou gérer les pubs Meta ?

La publication, la programmation et la gestion de campagnes sur Meta, Google Ads, Microsoft Advertising, Reddit Ads, LinkedIn, Pinterest, X Ads, TikTok Ads, Snapchat Ads, ChatGPT Ads, Apple Search Ads et AppLovin Ads se trouvent dans la surface MCP et non dans les sous-commandes de la CLI. On y accède depuis le même paquet en lançant hermoso mcp, depuis le point de terminaison hébergé à l'adresse https://app.hermoso.ai/mcp, ou depuis le studio web. Les destinations de publication sont Facebook, Instagram, Threads, TikTok, YouTube, X, LinkedIn, Pinterest, Bluesky, Telegram et Google Business Profile.

Fonctionne-t-il avec un serveur local ?

Oui. Réglez HERMOSO_API_BASE sur votre propre origine (par exemple http://localhost:3000) et la CLI comme le serveur MCP s'y connecteront. Une base en localhost n'a pas besoin de jeton d'authentification.

Lancer des pubs depuis la ligne de commande