Publier sur YouTube depuis Claude Code

L’import, le titre, la description, les tags et la miniature forment une seule chaîne depuis le terminal, et non répertorié est l’étape de relecture, car l’API YouTube n’a pas de brouillon Studio.

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

  • post_to_youtube : téléverse une vidéo finie avec un titre, une description de jusqu'à 5 000 caractères, jusqu'à 30 tags et un réglage de confidentialité.
  • schedule_post : met en file le téléversement, et transmet la description et les tags avec lui.
  • set_youtube_thumbnail : place une miniature soignée sur le téléversement. C'est le levier le plus important sur le taux de clic ; sans cela, YouTube choisit une image plus ou moins au hasard.
  • make_thumbnail : génère d'abord cette miniature.
  • update_youtube_video / list_youtube_videos : modifient les métadonnées d'un téléversement, ou listent vos propres téléversements, y compris les vidéos non répertoriées et privées qu'une recherche publique ne voit pas.
  • youtube_video_insights / youtube_channel : vues, temps de visionnage, pourcentage moyen visionné et abonnés gagnés.
  • list_youtube_comments / reply_to_youtube_comment : lire les commentaires et y répondre au nom de la chaîne.

L'unité est réellement une vidéo : post_to_youtube prend un videoUrl, et il n'existe aucun chemin pour une image. Deux verrous plus discrets à connaître avant un téléversement automatisé : un projet Google non vérifié verrouille videos.insert sur privé, quelle que soit votre demande, et les miniatures personnalisées exigent une chaîne vérifiée par téléphone.

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

TexteUn titre YouTube est limité à 100 caractères, et le texte d'un élément planifié devient le titre. La description est un champ distinct de jusqu'à 5 000 caractères, portant jusqu'à 30 tags. 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, non répertorié ou privé. Il n'existe pas de brouillon Studio : « L'API de YouTube peut téléverser en public, non répertorié ou privé, mais ne peut pas créer de brouillon Studio ». Le non répertorié est donc l'approximation la plus proche d'un état de relecture, et c'est l'option par défaut d'une publication immédiate, afin qu'une vidéo prête pour la publicité ne devienne pas publique par accident.
CarrouselRefusé, nommément. « L'unité de YouTube est une vidéo, pas une série d'images fixes. Transformez les diapositives en vidéo (Hermoso peut les assembler) et publiez celle-ci, ou retirez YouTube de cette publication. » Hermoso n'a pas inventé cette limite pour éviter du travail : c'est simplement ce qu'est YouTube. Le refus intervient à la mise en file, avec la marche à suivre, au lieu d'une première diapositive publiée en silence.
Quel compteAucune. YouTube publie sur la chaîne connectée.

Essayez-le dans Claude Code

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

« Pour chaque fichier de ./films, rédige un titre de moins de 100 caractères et une description complète, génère une miniature, importe-le en non répertorié, et écris un CSV des identifiants et URL des vidéos. »

Cela enchaîne make_thumbnail → post_to_youtube → set_youtube_thumbnail → youtube_video_insights. 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 YouTube : le point délicat

Les imports en lot sont là où apparaît le piège des métadonnées : la légende devient le titre, limité à 100 caractères, tandis que la description est un champ distinct de 5 000 caractères avec jusqu’à 30 tags. Passez les deux explicitement. Et vérifiez l’état de la chaîne avant le lot : un projet Google non vérifié verrouille les imports en privé, et les miniatures personnalisées exigent une chaîne vérifiée par téléphone.

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

search_youtube recherche dans l’index public de YouTube. C’est une question différente de « qu’ai-je mis en ligne ? », et list_youtube_videos sert à cela. Pour le film d’un concurrent, analyze_video renvoie la voix off, le texte à l’écran et la liste des temps forts avec horodatage, ce qui est précisément ce qu’il faut avant de recréer une accroche.

La partie payante

Les outils Google Ads de Hermoso créent des campagnes Search, Display et Performance Max (toute l’arborescence en une seule opération atomique, relue auprès de Google avant que votre agent ne la raconte), ainsi que les volumes du Planificateur de mots clés, les actions de conversion, et les liens annexes et accroches créés et rattachés. Il n’existe pas de créateur de campagne vidéo YouTube, et il serait faux de le suggérer : un élément vidéo YouTube peut être importé et rattaché, mais les types de campagnes que Hermoso crée sont Search, Display et Performance Max.

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 · X · LinkedIn · Pinterest · Bluesky · Telegram. Ou voir tout ce sur quoi Claude Code peut publier.

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

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

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

Claude Code peut-il publier en privé ou en brouillon sur YouTube ?

Oui : public, non répertorié ou privé. L'API de YouTube ne dispose pas de brouillon Studio, donc le non répertorié est l'état de relecture le plus proche, et c'est l'option par défaut d'une publication immédiate. Hermoso refuse une visibilité que YouTube 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 YouTube depuis Claude Code ?

Publier sur YouTube ne coûte aucun crédit ; YouTube ne facture rien par appel d'API. Les crédits sont dépensés pour la génération de la vidéo et de la miniature. 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 YouTube lorsqu'on publie depuis Claude Code ?

Un titre YouTube est limité à 100 caractères. La description est un champ distinct allant jusqu'à 5 000 caractères, avec jusqu'à 30 tags. Le texte d'un élément planifié devient le titre, donc les deux doivent être transmis explicitement. Hermoso l'applique à la création ou à la mise en file, si bien que Claude Code en est averti immédiatement plutôt que d'échouer plus tard, quand personne ne surveille.

Claude Code peut-il planifier un post YouTube 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. YouTube 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