Publier sur Pinterest 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 Pinterest, et ce que Pinterest 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 Pinterest 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 Pinterest dont dispose Claude Code

• list_pinterest_boards : les tableaux du compte, y compris les tableaux secrets, avec leurs identifiants.
• create_pinterest_board : crée un nouveau tableau.
• post_to_pinterest : crée une épingle image ou vidéo sur un tableau que vous nommez, avec un titre, une description, un lien de destination et un texte alternatif.
• schedule_post : met l’épingle en file d’attente en transmettant boardId.
• list_pinterest_ads_campaigns / pinterest_ads_report : lisent le volet payant.

La limite à connaître avant de planifier un flux Pinterest : cette application détient l’accès d’essai, et Pinterest refuse la création d’épingles en production avec l’accès d’essai. Leurs mots, relevés au premier essai réel : « Les applications en accès d’essai ne peuvent pas créer d’épingles en production. » Les tableaux et les lectures fonctionnent avec l’accès d’essai (lister les tableaux, créer des tableaux, lire les épingles), et l’erreur de Hermoso nomme le niveau d’accès au lieu de vous demander de vous reconnecter, car reconnecter ne peut pas le changer. Une mise à niveau vers l’accès standard débloque la création d’épingles, et elle est en attente de validation. Le même niveau limite aussi le volet payant : en accès d’essai, Pinterest n’expose aucun compte publicitaire.

Limites de Pinterest à 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éez un tableau par gamme de produits, générez cinq Pins verticaux pour chacun avec titres et descriptions, et écrivez le plan complet dans ./out/pinterest.json, prêt à publier. »

Cela enchaîne list_pinterest_boards → plan_ad → generate_image → post_to_pinterest. Claude Code demande confirmation avant d'exécuter un outil, et la transcription est affichée dans le terminal : une étape de publication est une ligne que vous pouvez lire avant d'appuyer sur y.

Claude Code sur Pinterest : le point délicat

Un script qui prépare tout et s'arrête avant le Pin est la bonne forme pour l'instant. Les tableaux se lisent et s'écrivent en accès Trial ; la création de Pins est refusée en production par Pinterest lui-même. Notez aussi que boardId est le seul champ d'identité qu'Hermoso refuse dès la mise en file d'attente plutôt qu'au moment de la publication, car « un Pin sur le mauvais tableau est une erreur publique, donc nous n'en choisissons jamais un à votre place ».

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

Il n’existe pas de bibliothèque publicitaire Pinterest, donc Hermoso ne revendique pas de recherche concurrentielle sur Pinterest. Le visuel que vous y diffuseriez est bien couvert par le reste du studio : make_template_ad et les modèles d’image produisent les visuels fixes verticaux et riches en texte que ce réseau récompense.

La partie payante

Les outils Pinterest Ads existent pour une campagne, un groupe d’annonces et une publicité qui fait la promotion d’une épingle existante, avec archivage au lieu de suppression, car l’API Ads de Pinterest n’a pas de verbe de suppression (les épingles et tableaux organiques se suppriment, via delete_pinterest_pin et delete_pinterest_board ; ce sont les objets payants qui ne peuvent qu’être archivés). Mais le même niveau d’accès d’essai qui bloque la création d’épingles n’expose aucun compte publicitaire, donc les écritures publicitaires ne sont pas utilisables avant l’accès standard. C’est l’état réel, et il vaut mieux le dire en une phrase ici que le découvrir au pire moment.

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

Depuis Claude Code, publiez sur : Facebook · Instagram · Threads · TikTok · YouTube · X · LinkedIn · Bluesky · Telegram. Ou voir tout ce sur quoi Claude Code peut publier.

Publier sur Pinterest depuis : Claude · ChatGPT · Cursor · Codex · Cline · OpenClaw · Grok Bot · Hermes · Gemini CLI · Perplexity · Le Chat · Claude Cowork · Perplexity Computer · Paperclip · Claude Code marketing

Questions fréquentes

Claude Code peut-il publier sur Pinterest ?

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

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

Claude Code peut-il publier un carrousel sur Pinterest ?

Oui en principe : de 2 à 5 images, images uniquement, directement issues de l’OpenAPI v5 de Pinterest. En pratique, la création d’épingles elle-même est bloquée en production tant que cette application détient l’accès d’essai. Claude Code appelle le même outil de publication dans les deux cas, et un canal qui ne peut pas porter un carrousel est refusé, avec la vraie raison indiquée.

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

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

Non. Vous connectez Pinterest à 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.

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

Pinterest ne facture rien par appel API, donc publier ne coûte aucun crédit. Les crédits sont dépensés pour générer le visuel de l’épingle. Les formules 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 chaque formule, y compris la formule Gratuite. La seule exception est le SSO entreprise.