Hermoso はマーケティング用の MCP サーバーです。922+ のツールを一つの OAuth 対応エンドポイントで提供し、エージェントが市場で既に配信されている広告をリサーチし、完成した画像と動画の広告を生成し、それらを投稿し、その背後にある有料キャンペーンを作れるようにします。Claude Code は一つの接続からこれらすべてを使えます。このページでは、その中の一部を扱います。Claude Code が YouTube で実際に何をできて、YouTube が何をさせないかです。
Hermoso を Claude Code に接続する
- コマンドは1つで、キーは不要です。
すでにセッション内にいる場合は、claude plugin marketplace add hermoso-ai/hermoso && claude plugin install hermoso@hermoso/plugin marketplace add hermoso-ai/hermosoを入力し、続けて/plugin install hermoso@hermosoを入力します。インストールされるのは Hermoso のスキル5つ（research、ad-from-brand、generate、product-photoshoot、marketing）で、npx経由でhermosoコマンドを実行します。そのため、ツール一覧がセッションに読み込まれることはなく、実行されるまでコンテキストを消費しません。 - 一度だけサインインします。
ループバック経由でブラウザのサインイン画面が開きます。これはnpx -y hermoso auth loginghと同じ仕組みです。認証情報は所有者だけが読める形で~/.hermoso/config.jsonに保存されます。Claude Code は、Hermoso が必要になった最初の時点で、これを代わりに実行します。CI、リモートのマシン、コンテナなど、そのマシンにブラウザがない場合は、MCP & CLI → Terminal & API keys でキーを作成し、npx -y hermoso auth login --token hmk_…を実行してください。キーには実際の支出の権限があるため、パスワードと同じように扱ってください。 - 任意：MCP サーバーも追加する。Hermoso のツールを Claude Code 自身のツール一覧にも入れたい場合は、サインイン後に
claude mcp add hermoso -- npx -y hermoso mcpを実行してください。同じ保存済みの認証情報を読むため、.claude.jsonにキーが入ることはありません。MCP を追加しなくても、スキルからすべてのツールを使えます。 - Claude Code に何かを頼みます。「競合上位3社の、最も長く配信されている広告を取得して、一番良いフックを9:16の動画にリミックスして」、または「このレンダリングをチャンネルに投稿して」。エージェントがツールを選び、支出はあなたが承認します。
プラグインとオプションの MCP サーバーは、同じツールと同じアカウントを利用します。違いはコンテキストです。ツール一覧は、入力する前にすべてのセッションに読み込まれますが、スキルはコマンドが実行されるまで何のコストもかかりません。
その後、Hermoso の 設定 → コネクタ で YouTube 自体を一度接続してください。これはブラウザでの OAuth 同意画面なので、唯一ブラウザが必要な手順です。そのあとはすべてツール呼び出しです。
Claude Code が使える YouTube のツール
post_to_youtube：タイトル、最大5,000文字の説明、最大30個のタグ、そして公開範囲の設定付きで、完成した動画をアップロードします。schedule_post：アップロードをキューに入れ、説明とタグもそれに付随して渡します。set_youtube_thumbnail：アップロードにデザインしたサムネイルを設定します。クリック率への最大の影響要因で、それがなければ YouTube はフレームをほぼ無作為に選びます。make_thumbnail：そのサムネイル自体を生成します。update_youtube_video / list_youtube_videos：アップロードのメタデータを編集するか、非公開や限定公開を含む自分のアップロードを一覧表示します。公開検索では見えないものです。youtube_video_insights / youtube_channel：再生回数、視聴時間、平均視聴率、獲得した登録者数。list_youtube_comments / reply_to_youtube_comment：コメントを読み、チャンネルとして返信します。
ユニットは本当に動画です。post_to_youtube は videoUrl を取り、画像の経路はまったくありません。自動アップロードの前に知っておくべき、より小さな制約が二つあります。確認されていない Google プロジェクトでは、何を頼んでも videos.insert は非公開に固定されます。また、カスタムサムネイルには電話認証済みのチャンネルが必要です。
自動化の前に知っておくべき YouTube の上限
| テキスト | YouTube のタイトルは100文字が上限で、予約項目のテキストがタイトルになります。説明は別のフィールドで、最大5,000文字、最大30個のタグを載せられます。投稿の作成またはキューに入れる時点で適用されるので、上限を超えた投稿は、黙って途中で切られるのではなく、あなたがまだそこにいるうちに拒否され、修正できます。 |
|---|---|
| 公開範囲 | 公開、限定公開、非公開。Studio の下書きはありません。「YouTube の API は公開、限定公開、非公開としてアップロードできますが、Studio の下書きを作ることはできません」。そのため限定公開がレビューの状態に最も近く、即時の投稿はそれが既定になるので、広告に使えるアップロードが誤って公開されることがありません。 |
| カルーセル | 名前を挙げて拒否。「YouTube の単位は静止画の集まりではなく動画です。スライドを動画にしてから（Hermoso で結合できます）、その動画を投稿するか、この投稿から YouTube を外してください。」 Hermoso は、作業を避けるためにこの制限を作ったのではありません。それが YouTube そのものです。拒否はキューに入る時点で、進め方を添えて返され、黙って最初のスライドが投稿されることはありません。 |
| どのアカウントか | なし。YouTube は接続されたチャンネルに公開します。 |
Claude Code で試す
普通の言葉で頼んでください。これは DSL ではなく、普通の文章です。
「./films の各ファイルについて、100文字未満のタイトルと完全な説明文を書き、サムネイルを生成して、限定公開でアップロードしてください。動画 ID と URL の CSV を書き出してください。」
流れは make_thumbnail → post_to_youtube → set_youtube_thumbnail → youtube_video_insights です。Claude Code はツールを実行する前に確認を求めます。やり取りはターミナルにそのまま残るため、公開の手順は、y を押す前に読める1行です。
YouTube での Claude Code：要注意の点
まとめてアップロードすると、メタデータの落とし穴が表れます。キャプションはタイトルになり、100文字が上限です。一方、説明文は別の5,000文字のフィールドで、タグは最大30個です。両方を明示的に渡してください。また、バッチの前にチャンネルの状態を確認してください。認証されていない Google プロジェクトでは、アップロードが非公開に固定され、カスタムサムネイルには電話番号認証済みのチャンネルが必要です。
プラグインにはツールのマニフェストがありません。これは、長時間の無人実行で特に重要です。エージェントは工程ごとに hermoso コマンドをシェルから呼び出し、どのコマンドにも付けられる --json によって、検証可能な機械向けの出力を得ます。
投稿の前に YouTube をリサーチする
search_youtube は公開されている YouTube のインデックスを検索します。「自分がアップロードした動画」を確認する質問とは別物で、その用途には list_youtube_videos を使います。競合の動画については、analyze_video がナレーション、画面内のテキスト、タイムスタンプ付きのビート一覧を返します。フックを作り直す前に、まさに必要な情報がそろいます。
有料の側
Hermoso の Google Ads ツールは、検索、ディスプレイ、Performance Max キャンペーンを構築します。ツリー全体を1回のアトミックな操作で作成し、エージェントが説明する前に Google から読み戻します。さらに、Keyword Planner の検索ボリューム、コンバージョンアクション、サイトリンクとコールアウトの作成と紐付けにも対応します。YouTube 動画キャンペーンの作成機能はなく、あるかのように示すのは誤りです。YouTube の動画アセットはアップロードして紐付けられますが、Hermoso が作成するキャンペーンの種類は検索、ディスプレイ、Performance Max です。
Claude Code だけではできないこと
予算を持ったエージェントは、被害の範囲が限られていて初めて役に立つので、囲いはプロンプトではなくサーバー側にあります。すべての広告キャンペーン、広告セット、広告グループ、広告は一時停止の状態で作成され、実際のお金を動かす支出の切り替えは、明示的な確認フラグなしでは実行されません。すべてのレンダリングは、まず見積もられます（hermoso_capabilities が、支出の前に各モデルの正確なクレジット費用を公開します）。クレジットは最初のプロバイダー呼び出しの前に確保され、後で正確な費用で精算されるので、送信に失敗しても、何も得られないのに請求されることはありません。削除も確認が必要で、エージェントが何を作ったかを伝える前に、すべてのキャンペーンのツリーは広告プラットフォームから読み戻されます。
あえて完全なヘッドレスにしていない手順が一つあります。アカウントの接続は OAuth の同意画面なので、ブラウザでチャンネルを一度接続します。そのあとはすべてツール呼び出しです。
その他のマトリクス
Claude Code から投稿できる先: Facebook · Instagram · Threads · TikTok · X · LinkedIn · Pinterest · Bluesky · Telegram。または Claude Code から投稿できるすべての先をご覧ください。
YouTube への投稿元: Claude · ChatGPT · Cursor · Codex · Cline · OpenClaw · Grok Bot · Hermes · Gemini CLI · Perplexity · Le Chat · Claude Cowork · Perplexity Computer · Paperclip · Claude Code マーケティング
よくある質問
Claude Code から YouTube に投稿できますか？
はい。Hermoso の Claude Code プラグインを使います。コマンドは1つです。claude plugin marketplace add hermoso-ai/hermoso && claude plugin install hermoso@hermoso。セッション内では、/plugin marketplace add hermoso-ai/hermoso に続けて /plugin install hermoso@hermoso を実行します。インストールされるのは、hermoso CLI を動かす Hermoso のスキル5つです。そのため、ツール一覧がセッションに読み込まれることはありません。npx -y hermoso auth login で一度サインインしてください。ブラウザが開き、認証情報は自動で保存されるため、作成するキーも貼り付けるキーもありません。その後、Claude Code は 922+ 個のツールを使えるようになります。YouTube に投稿するツールのほか、市場で配信中の広告をリサーチするツールや、そもそもクリエイティブを生成するツールも含まれます。
YouTube を Claude Code に接続するには？
手順は2つで、どちらも一度だけです。コマンドは1つです。claude plugin marketplace add hermoso-ai/hermoso && claude plugin install hermoso@hermoso。セッション内では、/plugin marketplace add hermoso-ai/hermoso に続けて /plugin install hermoso@hermoso を実行します。インストールされるのは、hermoso CLI を動かす Hermoso のスキル5つです。そのため、ツール一覧がセッションに読み込まれることはありません。npx -y hermoso auth login で一度サインインしてください。ブラウザが開き、認証情報は自動で保存されるため、作成するキーも貼り付けるキーもありません。続けて、Hermoso の Settings → Connectors で YouTube を接続します。ブラウザで OAuth の同意画面が開きます。その後は、Claude Code が通常のツール呼び出しとして YouTube に投稿します。
Claude Code から YouTube に非公開や下書きで投稿できますか？
はい：公開、限定公開、非公開。YouTube の API には Studio の下書きがないため、限定公開がレビューの状態に最も近く、即時の投稿はそれが既定になります。Hermoso は、YouTube ができない公開範囲を依頼された時点で拒否し、黙ってより弱い形で公開することはありません。
Claude Code から YouTube に投稿するのにコストはかかりますか？
YouTube への投稿にはクレジットがかかりません。YouTube は API 呼び出しごとに料金を取らないためです。クレジットは動画とサムネイルの生成にかかります。プランは月額 $29、$69、$149 で、それぞれ 1,200、3,000、7,000 クレジットです。すべての機能が Free を含むすべてのプランに含まれます。例外はエンタープライズ向けの SSO だけです。
Claude Code から投稿するときの YouTube の文字数上限は？
YouTube のタイトルは100文字が上限です。説明は別のフィールドで、最大5,000文字、タグは最大30個です。予約された項目のテキストはタイトルになるので、両方を明示的に渡す必要があります。Hermoso は投稿の作成またはキューに入れる時点で適用するので、後で誰も見ていないときに失敗するのではなく、Claude Code にすぐ伝わります。
Claude Code で YouTube の投稿を後から予約できますか？
はい。schedule_post は、他のすべてのチャンネルと共有する一つのカレンダーに投稿を入れます。キャプションを変えたい場合は、チャンネルごとに付けられます。list_scheduled と cancel_scheduled で読み取りと取り消しができます。YouTube は、キューに入る十一チャンネルの一つです。