Publier sur Instagram depuis Claude Code

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 Instagram, et ce que Instagram ne lui permettra pas de faire.

Connecter Hermoso à Claude Code

1. Une seule commande, et aucune clé.

   claude plugin marketplace add hermoso-ai/hermoso && claude plugin install hermoso@hermoso

   Déjà dans une session ? Tapez /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 commande hermoso via npx, 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.
2. Connectez-vous une fois.

   npx -y hermoso auth login

   Cela ouvre une connexion dans le navigateur, sur loopback, comme le fait gh, 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 lancez npx -y hermoso auth login --token hmk_…. Une clé donne un vrai pouvoir de dépense : traitez-la comme un mot de passe.
3. 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 mcp aprè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.
4. 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 Instagram 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 Instagram dont dispose Claude Code

• post_to_meta : publie sur Instagram avec target: "instagram". Instagram est un canal visuel, et l'API le confirme : un post exige une image ou une vidéo.
• schedule_post : le met en file sur le calendrier commun, avec une légende adaptée au canal si le texte doit différer de votre version Facebook ou LinkedIn.
• list_meta_comments / reply_to_meta_comment / moderate_meta_comment : lire, répondre et modérer sous un post.
• meta_page_insights / meta_post_insights : portée, impressions, enregistrements et engagement, par compte et par post.
• search_instagram : recherche par mot-clé parmi les Reels Instagram publics, pour la recherche plutôt que pour la publication.

Deux points à connaître sur Instagram avant d'automatiser quoi que ce soit. Il n'existe aucune planification native sur Instagram dans l'API de Meta : une planification est donc la file d'Hermoso et non celle d'Instagram, et transmettre le scheduleAt de Facebook pour Instagram est refusé plutôt que de publier en silence immédiatement. Et une légende Instagram ne peut plus être modifiée une fois le post en ligne : la seule chose que Meta autorise à changer sur un post publié est l'activation ou la désactivation des commentaires. La suppression, en revanche, est possible : manage_meta_post supprime les posts ordinaires, les Stories, les Reels et des carrousels entiers, mais jamais une seule carte d'un album.

Limites de Instagram à connaître avant d'automatiser quoi que ce soit

Essayez-le dans Claude Code

Demandez-le en langage courant. Ce sont des phrases simples, pas un langage de commande :

« Crée un carrousel de 5 diapositives à partir de ./assets/slides, vérifie que chacune respecte les limites d’Instagram, publie-le, et enregistre le lien permanent dans les notes de version. »

Cela enchaîne search_instagram → plan_ad → render_ad → post_to_meta (target: "instagram"). 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 Instagram : le point délicat

Une légende Instagram ne peut pas être modifiée une fois la publication en ligne ; intégrez donc la vérification au script plutôt qu’à des excuses : faites montrer à Claude Code l’ordre des diapositives et la légende, et seulement ensuite appelez l’outil de publication. Si un rendu s’avère faux, manage_meta_post supprime toute la publication, albums compris. L’ordre compte plus qu’on ne le pense. La diapositive 2 doit suivre la diapositive 1, et Hermoso conserve exactement l’ordre que vous transmettez.

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 Instagram avant de publier

search_meta_ads couvre les emplacements Instagram autant que Facebook, puisqu'il s'agit d'une seule bibliothèque. Pour l'organique, search_instagram recherche les Reels publics par mot-clé, c'est la surface où le format circule réellement ; les extractions de profils et de hashtags passent par fetch_social_data et search_instagram_hashtag.

La partie payante

Les emplacements Instagram s'achètent dans la même arborescence de campagnes Meta que Facebook : create_meta_campaign → create_meta_adset → create_meta_ad, avec des emplacements sélectionnables par plateforme et par position. preview_meta_ad montre la publicité rendue réelle par emplacement avant toute dépense, et meta_insights ventile les résultats par âge, sexe, emplacement et pays. Cette ventilation oriente la création suivante.

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 : Facebook · Threads · TikTok · YouTube · X · LinkedIn · Pinterest · Bluesky · Telegram. Ou voir tout ce que Claude Code peut publier.

Publier sur Instagram 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 Instagram ?

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 Instagram, ainsi que ceux qui recherchent les publicités déjà diffusées sur votre marché et créent d’abord le visuel.

Comment connecter Instagram à 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 Instagram dans Hermoso sous Paramètres → Connecteurs, qui est un écran de consentement OAuth dans le navigateur. Ensuite, Claude Code publie sur Instagram comme un appel d’outil ordinaire.

Claude Code a-t-il besoin de mon mot de passe Instagram ?

Non. Vous connectez Instagram à Hermoso une fois, via un écran de consentement OAuth dans un navigateur, puis Claude Code y accède comme à un appel d'outil. Relier un compte est la seule étape qui ne se fait pas sans interface ; ensuite, rien n'exige de mot de passe, et aucun identifiant n'est jamais transmis au modèle.

Claude Code peut-il planifier un post Instagram 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. Instagram fait partie des onze canaux qui se mettent en file.

Claude Code peut-il publier un carrousel sur Instagram ?

Oui, de 2 à 10 diapositives, et les images et vidéos peuvent être mélangées. Dix est la limite publiée par Meta elle-même, et non une limite inventée par Hermoso. Claude Code appelle le même outil de publication dans les deux cas, et un canal incapable de porter un carrousel est refusé avec la vraie raison.

Combien coûte la publication sur Instagram depuis Claude Code ?

Publier sur Instagram ne coûte aucun crédit ; Meta ne facture rien par appel d'API. Les crédits sont dépensés pour le rendu lui-même. 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.