Hermoso est un serveur MCP de marketing : plus de 922 outils sur un point d'accès OAuth unique, qui permettent à un agent de rechercher les publicités déjà diffusées sur un marché, de générer des publicités finies en image et en vidéo, de les publier et de construire les campagnes payantes qui les accompagnent. Claude Code accède à l'ensemble via une seule connexion. Cette page couvre une partie : ce que Claude Code peut réellement faire sur Facebook, et ce que Facebook ne lui permettra pas de faire.
Connecter Hermoso à Claude Code
- Une seule commande, et aucune clé.
Déjà dans une session ? Tapezclaude plugin marketplace add hermoso-ai/hermoso && claude plugin install hermoso@hermoso/plugin marketplace add hermoso-ai/hermoso, puis/plugin install hermoso@hermoso. Il installe cinq compétences Hermoso (research, ad-from-brand, generate, product-photoshoot et marketing) qui exécutent la commandehermosovianpx, si bien qu’aucune liste d’outils n’est chargée dans vos sessions et que rien ne coûte de contexte tant qu’il ne tourne pas. - Connectez-vous une fois.
Cela ouvre une connexion dans le navigateur, sur loopback, comme le faitnpx -y hermoso auth logingh, et stocke un identifiant accessible au seul propriétaire dans~/.hermoso/config.json. Claude Code le lance pour vous la première fois qu’il a besoin d’Hermoso. Pas de navigateur sur cette machine, par exemple en CI, sur un serveur distant ou dans un conteneur ? Créez une clé sous MCP & CLI → Clés Terminal et API et lanceznpx -y hermoso auth login --token hmk_…. Une clé donne un vrai pouvoir de dépense : traitez-la comme un mot de passe. - Facultatif : le serveur MCP aussi. Si vous voulez aussi les outils Hermoso dans la liste d’outils propre à Claude Code, lancez
claude mcp add hermoso -- npx -y hermoso mcpaprès vous être connecté. Il lit le même identifiant enregistré, si bien qu’aucune clé n’est écrite dans.claude.json. Les compétences atteignent tous les outils sans lui. - Demandez quelque chose à Claude Code. « Récupère les publicités les plus anciennes de mes trois principaux concurrents et réutilise la meilleure accroche dans une vidéo 9:16 », ou « publie ce rendu sur la chaîne ». L'agent choisit les outils ; vous approuvez les dépenses.
Le plug-in et le serveur MCP facultatif accèdent aux mêmes outils et au même compte. La différence tient au contexte : une liste d’outils est chargée dans chaque session avant que vous ne tapiez quoi que ce soit, alors que les compétences ne coûtent rien tant qu’une commande ne tourne pas.
Connectez ensuite Facebook lui-même, une fois, sous Paramètres → Connecteurs dans Hermoso. C'est un écran de consentement OAuth, donc la seule étape qui nécessite un navigateur. Tout le reste est un appel d'outil.
Les outils Facebook dont dispose Claude Code
post_to_meta: publie un texte, une image, une vidéo ou un post multi-photos sur la Page, et prendpageIdpour ne jamais deviner quelle Page utiliser.schedule_post: met en file le même post à l'heure de votre choix, sur un calendrier commun à tous les autres canaux.list_meta_pages: liste les Pages connectées au compte, avec leurs identifiants.manage_meta_post: modifie le texte d'un post publié, ou le supprime.list_meta_comments / reply_to_meta_comment / moderate_meta_comment: lit les commentaires sous un post, répond au nom de la Page, et masque ou supprime ceux qui ne devraient pas y figurer.meta_page_insights / meta_post_insights: portée, impressions et engagement au niveau de la Page et par post.upload_meta_asset: place un rendu fini dans la bibliothèque d'actifs du compte publicitaire.
Facebook est aussi le seul canal avec une planification native à distance. post_to_meta accepte un scheduleAt entre dix minutes et trente jours, et confie le calendrier à Meta lui-même. Instagram et Threads n'ont pas cette option dans l'API de Meta, et la transmettre pour eux est refusée plutôt que de publier immédiatement en silence.
Limites de Facebook à connaître avant d'automatiser quoi que ce soit
| Texte | Un post Facebook peut aller jusqu'à 63 206 caractères, ce qui revient à ne pas avoir de limite. Elle est appliquée à la création ou à la mise en file, si bien qu'un post trop long est refusé pendant que vous êtes encore là pour le corriger, au lieu d'être tronqué en silence au moment de la publication. |
|---|---|
| Visibilité | Public ou brouillon. Un brouillon est un post de Page réellement non publié, ce qui est l'option utile pour une relecture : il existe dans Meta Business Suite et personne à l'extérieur ne peut le voir. Il n'existe pas d'option non répertoriée ni privée : « un post de Page Facebook est soit publié, soit conservé en brouillon non publié ». |
| Carrousel | 2 diapositives et plus, photos uniquement. Meta ne publie aucun maximum pour attached_media que nous puissions vérifier, donc Hermoso n'en invente pas et ne l'attribue pas à Facebook. Seule notre limite s'applique, fixée à 30 diapositives, et le refus indique à qui elle appartient : « Facebook ne publie aucun maximum documenté pour attached_media, donc cette limite est la nôtre, et non la sienne. » Une vidéo ne peut pas figurer dans un carrousel de photos Facebook ; c'est une autre particularité de l'API de Meta, et Hermoso refuse plutôt que de retirer le clip en silence. |
| Quel compte | pageId. Cela compte dès qu'une marque connecte plus d'une Page : le chemin de publication refuse en nommant la Page au lieu d'en choisir une à votre place, et une planification incapable de transmettre cette réponse transformerait ce refus en échec quelques heures plus tard, sans personne pour le voir. |
Essayez-le dans Claude Code
Demandez-le en langage courant. Ce sont des phrases simples, pas un langage de commande :
« Prends le mp4 dans ./renders, rédige une légende selon la voix de la marque, publie-le sur la Page en brouillon non publié, et écris l’identifiant de publication dans ./out/posts.json. »
Cela enchaîne find_competitors → search_meta_ads → plan_ad → render_ad → list_meta_pages → post_to_meta. Claude Code demande avant de lancer un outil, et la transcription s’affiche dans le terminal : une étape de publication est une ligne que vous pouvez lire avant d’appuyer sur y.
Claude Code sur Facebook : le point délicat
C’est là qu’un agent de terminal est vraiment meilleur qu’un chat : l’identifiant de publication revient sous forme de résultat structuré que vous pouvez écrire dans un fichier et vérifier plus tard. Facebook est aussi le seul canal à offrir une planification à distance native (post_to_meta accepte un scheduleAt entre dix minutes et trente jours), si bien qu’un script peut confier la date à Meta elle-même au lieu de tenir une file.
Le plug-in ne porte aucun manifeste d’outils, ce qui compte surtout pour une longue exécution sans surveillance : l’agent appelle la commande hermoso à chaque étape, et --json sur n’importe quelle commande lui donne une sortie machine à vérifier.
Rechercher sur Facebook avant de publier
La bibliothèque publicitaire de Meta est l'archive publique de créations la plus riche qui soit, et search_meta_ads la consulte par mot-clé ou par Page, en couvrant les emplacements Facebook et Instagram. pull_competitor_ads et competitor_teardown s'appuient dessus, et find_competitors détermine les concurrents à cibler.
La partie payante
Facebook est la surface payante la plus complète d'Hermoso. create_meta_campaign, create_meta_adset et create_meta_ad construisent toute l'arborescence avec un ciblage réel : géographie jusqu'à un rayon autour d'une ville, centres d'intérêt, comportements, audiences personnalisées et audiences similaires, emplacements, programmation horaire, plafonds d'enchère et de coût. Tout est créé en PAUSE, sans possibilité de contournement par l'appelant, et le résumé que votre agent rapporte est construit à partir d'une relecture de ce que Meta a réellement enregistré, jamais de ce qui a été demandé. Avant d'engager un budget, preview_meta_ad rend la publicité réelle par emplacement sous forme de lien que vous pouvez consulter, et estimate_meta_reach indique le nombre de personnes que le ciblage atteint réellement. Un avertissement qui fait économiser de l'argent : un ensemble de publicités créé sans zone géographique se limite par défaut aux États-Unis, et la relecture le signale clairement.
Ce que Claude Code ne peut pas faire seul
Un agent doté d'un budget n'est utile que si son rayon d'action est borné, donc le garde-fou se trouve dans le serveur et non dans une consigne. Chaque campagne, chaque ensemble d'annonces, chaque groupe d'annonces et chaque annonce publicitaire est créé en pause, et les changements de statut qui activent de l'argent réel refusent de s'exécuter sans un indicateur de confirmation explicite. Chaque rendu est d'abord chiffré (hermoso_capabilities publie le coût exact en crédits de chaque modèle avant toute dépense). Les crédits sont réservés avant le premier appel au fournisseur, puis imputés au coût exact après coup : un envoi qui échoue est remboursé plutôt que de vous facturer pour rien. Les suppressions sont aussi soumises à confirmation, et chaque arborescence de campagne est relue depuis la plateforme publicitaire avant que votre agent ne vous dise ce qu'il a construit.
Une étape n'est volontairement pas automatisée : relier un compte passe par un écran de consentement OAuth, donc vous connectez le canal une fois dans un navigateur. Tout le reste est un appel d'outil.
Le reste de la matrice
Publier depuis Claude Code : Instagram · Threads · TikTok · YouTube · X · LinkedIn · Pinterest · Bluesky · Telegram. Ou voir tout ce que Claude Code peut publier.
Publier sur Facebook depuis : Claude · ChatGPT · Cursor · Codex · Cline · OpenClaw · Grok Bot · Hermes · Gemini CLI · Perplexity · Le Chat · Claude Cowork · Perplexity Computer · Paperclip · Marketing avec Claude Code
Questions fréquentes
Claude Code peut-il publier sur Facebook ?
Oui, avec le plug-in Claude Code d’Hermoso. Une commande : claude plugin marketplace add hermoso-ai/hermoso && claude plugin install hermoso@hermoso, ou, dans une session, /plugin marketplace add hermoso-ai/hermoso puis /plugin install hermoso@hermoso. Il installe cinq compétences Hermoso qui pilotent la commande hermoso, si bien qu’aucune liste d’outils n’est chargée dans vos sessions. Connectez-vous une fois avec npx -y hermoso auth login, qui ouvre un navigateur et stocke l’identifiant lui-même : il n’y a donc aucune clé à créer ni à coller. Claude Code dispose alors de plus de 922 outils, y compris ceux qui publient sur Facebook, ainsi que ceux qui recherchent les publicités déjà diffusées sur votre marché et créent d’abord le visuel.
Comment connecter Facebook à Claude Code ?
Deux étapes, à faire une fois chacune. Une commande : claude plugin marketplace add hermoso-ai/hermoso && claude plugin install hermoso@hermoso, ou, dans une session, /plugin marketplace add hermoso-ai/hermoso puis /plugin install hermoso@hermoso. Il installe cinq compétences Hermoso qui pilotent la commande hermoso, si bien qu’aucune liste d’outils n’est chargée dans vos sessions. Connectez-vous une fois avec npx -y hermoso auth login, qui ouvre un navigateur et stocke l’identifiant lui-même : il n’y a donc aucune clé à créer ni à coller. Connectez ensuite Facebook dans Hermoso sous Paramètres → Connecteurs, qui est un écran de consentement OAuth dans le navigateur. Ensuite, Claude Code publie sur Facebook comme un appel d’outil ordinaire.
Claude Code peut-il publier en privé ou en brouillon sur Facebook ?
Oui. Facebook est le seul canal disposant d'un vrai brouillon : un post de Page non publié qui existe dans Meta Business Suite et qu'aucune personne extérieure ne peut voir. Hermoso refuse une visibilité que Facebook ne peut pas honorer au moment où vous la demandez, plutôt que de publier discrètement quelque chose de moins protégé.
Combien coûte la publication sur Facebook depuis Claude Code ?
Publier sur Facebook ne coûte aucun crédit, car Meta ne facture rien par appel d'API. Les crédits sont dépensés pour la création : le rendu de l'image ou de la vidéo que porte le post. Les plans coûtent $29, $69 et $149 par mois pour 1 200, 3 000 et 7 000 crédits, et toutes les fonctionnalités sont incluses dans tous les plans, y compris le plan Gratuit. La seule exception concerne le SSO entreprise.
Quelle est la limite de légende Facebook lorsqu'on publie depuis Claude Code ?
Un post Facebook peut aller jusqu'à 63 206 caractères, ce qui revient à ne pas avoir de limite. Hermoso l'applique au moment où le post est créé ou mis en file, afin que Claude Code soit prévenu immédiatement plutôt que d'échouer plus tard, quand personne ne surveille.
Claude Code peut-il planifier un post Facebook pour plus tard ?
Oui. schedule_post la met en file sur un calendrier commun à tous les autres canaux, avec une légende adaptée au canal si le texte doit différer, et list_scheduled et cancel_scheduled permettent de la lire et de la retirer. Facebook fait partie des onze canaux qui se mettent en file.
Commencez gratuitement avec 30 crédits à l'inscription et 250+ à gagner. Toutes les fonctionnalités sont incluses dans tous les plans.
Commencer gratuitement → Voir les tarifs