Publier sur Pinterest depuis Codex

Une exécution Codex planifiée peut déjà créer des tableaux et générer des créations de Pins. Le Pin lui-même est bloqué en production pour les applications en accès Trial, et l'erreur indique le niveau d'accès.

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. Codex accède à l'ensemble via une seule connexion. Cette page couvre une partie : ce que Codex peut réellement faire sur Pinterest, et ce que Pinterest ne lui permettra pas de faire.

Connecter Hermoso à Codex

  1. Une seule commande, sans clé.
    codex plugin marketplace add hermoso-ai/hermoso && codex plugin add hermoso@hermoso
    Codex lit le fichier de marketplace du dépôt public d'Hermoso et installe ses cinq compétences (research, ad-from-brand, generate, product-photoshoot et marketing). Les compétences exécutent la commande hermoso via npx : aucune liste d'outils n'est donc chargée dans vos sessions, et rien ne consomme de contexte tant qu'une commande n'est pas lancée.
  2. Connectez-vous une fois.
    npx -y hermoso auth login
    Cela ouvre une connexion dans le navigateur et enregistre un identifiant réservé au propriétaire dans ~/.hermoso/config.json. Pas de navigateur sur cette machine, par exemple en CI ou dans un conteneur ? Créez une clé sous MCP & CLI → Terminal et clés d'API, puis exécutez 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.
    codex mcp add hermoso -- npx -y hermoso mcp
    Cela écrit le serveur dans ~/.codex/config.toml et lit le même identifiant enregistré, si bien qu'aucune clé ne va dans le fichier. Vous préférez le point d'accès hébergé ? codex mcp add hermoso --url https://app.hermoso.ai/mcp, puis codex mcp login hermoso pour la connexion OAuth. Les compétences atteignent tous les outils sans l'un ni l'autre.
  4. Demandez quelque chose à Codex. « 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.

Codex conserve les serveurs MCP dans ~/.codex/config.toml, ou dans .codex/config.toml d'un projet de confiance, et ce fichier est au format TOML, pas JSON : un bloc mcpServers copié ne se chargera pas, et une entrée écrite à la main est [mcp_servers.hermoso] avec command = "npx" et args = ["-y", "hermoso", "mcp"]. Le mot mcp final est indispensable : npx -y hermoso sans sous-commande affiche l'aide et s'arrête. Codex lit les marketplaces de plugins dans la même disposition .claude-plugin que Claude Code, ce qui explique qu'un seul dépôt s'installe dans les deux.

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 Codex

  • 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

TexteLa description d’une épingle est limitée à 800 caractères, et son titre à 100. Cette limite est appliquée à la création ou à la mise en file d’attente : une publication trop longue est refusée pendant que vous êtes encore là pour la corriger, au lieu d’être coupée en silence au moment de la publication.
VisibilitéPublic, et le contrôle se fait au niveau du tableau plutôt que de l’épingle. Une épingle hérite de l’état public ou secret de son tableau ; « publier quelque part de privé » s’exprime donc par le choix d’un tableau secret. C’est pourquoi le tableau est un argument obligatoire plutôt qu’une valeur par défaut.
CarrouselDe 2 à 5 images, images uniquement. Les deux bornes viennent directement de l’OpenAPI v5 de Pinterest (minItems: 2, maxItems: 5), la seule source lisible par machine que Pinterest publie (son site développeur est une application rendue côté client qui ne renvoie rien à une requête). Il n’existe pas de source multi-vidéos, donc une diapositive vidéo est refusée au lieu d’être supprimée en silence.
Quel compteboardId, et c’est le seul champ d’identité refusé à la mise en file d’attente plutôt qu’au moment de la publication. Sans lui, rien n’est programmé, car « une épingle sur le mauvais tableau est une erreur publique, nous ne la choisissons donc jamais à votre place ».

Essayez-le dans Codex

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

« Mode non interactif : pour chaque nouveau produit du flux, générez une image de Pin verticale, un titre et une description, et préparez le lot complet en JSON. »

Cela enchaîne list_pinterest_boards → plan_ad → generate_image → post_to_pinterest. En mode interactif, Codex affiche l'appel avant de l'exécuter. En mode non interactif, personne n'est là pour répondre, ce qu'il faut prendre en compte pour toute étape qui publie ou dépense.

Codex sur Pinterest : le point délicat

Préparez, ne publiez pas. Une tâche sans surveillance qui tente de créer des Pins en production avec un accès Trial échouera sur chaque élément, et aucune politique de nouvelle tentative ne corrige un niveau d'accès. Les tableaux se lisent et s'écrivent, donc la structure peut être construite pour de bon, et boardId est refusé à la mise en file plutôt qu'au moment du déclenchement. Pour une exécution planifiée, c'est la différence entre un échec net maintenant et un échec silencieux plus tard.

Pour les exécutions sans surveillance, préférez la CLI hermoso avec --json plutôt que la liste complète des outils : elle consomme beaucoup moins de contexte et se vérifie plus facilement.

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 Codex 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 Codex, publiez sur : Facebook · Instagram · Threads · TikTok · YouTube · X · LinkedIn · Bluesky · Telegram. Ou voir tout ce que Codex peut publier.

Publier sur Pinterest depuis : Claude · ChatGPT · Claude Code · Cursor · Cline · OpenClaw · Grok Bot · Hermes · Gemini CLI · Perplexity · Le Chat · Claude Cowork · Perplexity Computer · Paperclip · Publicités depuis la ligne de commande

Questions fréquentes

Codex peut-il publier sur Pinterest ?

Oui, avec le plugin Codex d'Hermoso. Exécutez codex plugin marketplace add hermoso-ai/hermoso && codex plugin add hermoso@hermoso, ce qui installe les compétences d'Hermoso, puis connectez-vous une fois avec npx -y hermoso auth login. La connexion ouvre un navigateur et enregistre l'identifiant elle-même : il n'y a donc ni clé à créer ni clé à coller. Pour le serveur MCP aussi, exécutez codex mcp add hermoso -- npx -y hermoso mcp. Codex dispose alors de plus de 922 outils, dont ceux qui publient sur Pinterest, ainsi que ceux qui recherchent les publicités déjà diffusées sur votre marché et créent les visuels.

Comment connecter Pinterest à Codex ?

Deux étapes, une fois chacune. Exécutez codex plugin marketplace add hermoso-ai/hermoso && codex plugin add hermoso@hermoso, ce qui installe les compétences d'Hermoso, puis connectez-vous une fois avec npx -y hermoso auth login. La connexion ouvre un navigateur et enregistre l'identifiant elle-même : il n'y a donc ni clé à créer ni clé à coller. Pour le serveur MCP aussi, exécutez codex mcp add hermoso -- npx -y hermoso mcp. Puis connectez Pinterest dans Hermoso sous Paramètres → Connecteurs : c'est un écran de consentement OAuth dans le navigateur. Ensuite, Codex publie sur Pinterest comme un simple appel d'outil.

Codex 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 Codex 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 Codex ?

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.

Codex 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. Codex 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.

Codex 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.

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