Hermoso はマーケティング用の MCP サーバーです。922+ のツールを一つの OAuth 対応エンドポイントで提供し、エージェントが市場で既に配信されている広告をリサーチし、完成した画像と動画の広告を生成し、それらを投稿し、その背後にある有料キャンペーンを作れるようにします。Gemini CLI は一つの接続からこれらすべてを使えます。このページでは、その中の一部を扱います。Gemini CLI が YouTube で実際に何をできて、YouTube が何をさせないかです。
Hermoso を Gemini CLI に接続する
- 拡張機能をインストールします。
Hermoso の公開リポジトリの最新リリースをインストールします。これには 5 つのスキル(research、ad-from-brand、generate、product-photoshoot、marketing)とgemini extensions install https://github.com/hermoso-ai/hermosoGEMINI.mdコンテキストファイルが含まれます。スキルはnpxを通じてhermosoコマンドを実行するため、Gemini CLI のツール一覧には何も追加されず、コマンドが実行されるまでコンテキストも消費しません。gemini extensions listでは、スキルが Agent skills の下に表示されます。 - 一度サインインします。
ブラウザでのサインインが開き、所有者のみが読める認証情報をnpx -y hermoso auth login~/.hermoso/config.jsonに保存します。Gemini CLI は、Hermoso が初めて必要になったときに、代わりにこれを実行できます。そのマシンにブラウザがない場合は、MCP & CLI → Terminal & API keys でキーを作成し、npx -y hermoso auth login --token hmk_…を実行してください。 - 任意: MCP サーバーも追加する場合。
最初の接続が 401 を返すと、Gemini CLI は Hermoso の認可サーバーを見つけて自分自身を登録するため、gemini mcp add --scope user --transport http hermoso https://app.hermoso.ai/mcpsettings.jsonにキーを書く必要はありません。セッション内で/mcp auth hermosoを実行するとサインインできます。スキルは、これがなくてもすべてのツールに届きます。 - Gemini CLI に何かを頼みます。「競合上位3社の、最も長く配信されている広告を取得して、一番良いフックを9:16の動画にリミックスして」、または「このレンダリングをチャンネルに投稿して」。エージェントがツールを選び、支出はあなたが承認します。
上記のインストールは、2026-09-23 に、クリーンなホームディレクトリで Gemini CLI 0.60.0 を使って実行しました。hermoso-ai/hermoso の最新リリースを取得し、gemini extensions list に 5 つのスキルとコンテキストファイルが表示されました。拡張機能は独自の MCP サーバーを持ちません。これは意図的です。ツール一覧はすべてのセッションに読み込まれますが、スキルは実行されるまで何のコストもかからないからです。Hermoso は Google と提携しておらず、そのように主張することもありません。
その後、Hermoso の 設定 → コネクタ で YouTube 自体を一度接続してください。これはブラウザでの OAuth 同意画面なので、唯一ブラウザが必要な手順です。そのあとはすべてツール呼び出しです。
Gemini CLI が使える 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 は接続されたチャンネルに公開します。 |
Gemini CLI で試す
普通の言葉で頼んでください。これは DSL ではなく、普通の文章です。
“./renders/demo.mp4 を、100 文字未満のタイトル、./docs/demo.md の説明文、10 個のタグ、生成したサムネイル付きで、限定公開の YouTube にアップロードしてください。”
流れは make_thumbnail → post_to_youtube → set_youtube_thumbnail → youtube_video_insights です。Gemini CLI はシェルコマンドを実行する前に確認を求め、スキルは hermoso コマンドを通じて動くため、公開は「はい」と答える前に読める 1 行として表示されます。MCP ツールについては、1 回だけ許可するか、そのツールを常に許可するか、サーバーを常に許可するかを選べます。
YouTube での Gemini CLI:要注意の点
説明文は独立した項目として渡してください。予約投稿の項目のテキストは 100 文字のタイトルになり、リンクを入れる 5,000 文字の説明文は、頼まない限り空のままになります。API には Studio の下書きがないため、限定公開でアップロードし、確認したあとに update_youtube_video で公開に切り替えてください。カスタムサムネイルには、電話番号で認証されたチャンネルが必要です。
Gemini CLI で、この安全性を決める 2 つの詳細があります。gemini mcp add は、--scope user を渡さない限り、プロジェクトの .gemini/settings.json に書き込みます。1 つのリポジトリを常に 1 つのブランドで動かしたい場合は、これが役立ちます。また、Hermoso を --trust 付きで追加しないでください。サーバーに対するすべての確認をスキップしてしまい、公開の前に出る確認も含まれます。MCP ツールは mcp_hermoso_ とツール名を組み合わせた名前で届き、--exclude-tools を使えば、いくつでも完全に除外できます。
投稿の前に YouTube をリサーチする
search_youtube は公開されている YouTube のインデックスを検索します。「自分がアップロードした動画」を確認する質問とは別物で、その用途には list_youtube_videos を使います。競合の動画については、analyze_video がナレーション、画面内のテキスト、タイムスタンプ付きのビート一覧を返します。フックを作り直す前に、まさに必要な情報がそろいます。
有料の側
Hermoso の Google Ads ツールは、検索、ディスプレイ、Performance Max キャンペーンを構築します。ツリー全体を1回のアトミックな操作で作成し、エージェントが説明する前に Google から読み戻します。さらに、Keyword Planner の検索ボリューム、コンバージョンアクション、サイトリンクとコールアウトの作成と紐付けにも対応します。YouTube 動画キャンペーンの作成機能はなく、あるかのように示すのは誤りです。YouTube の動画アセットはアップロードして紐付けられますが、Hermoso が作成するキャンペーンの種類は検索、ディスプレイ、Performance Max です。
Gemini CLI だけではできないこと
予算を持ったエージェントは、被害の範囲が限られていて初めて役に立つので、囲いはプロンプトではなくサーバー側にあります。すべての広告キャンペーン、広告セット、広告グループ、広告は一時停止の状態で作成され、実際のお金を動かす支出の切り替えは、明示的な確認フラグなしでは実行されません。すべてのレンダリングは、まず見積もられます(hermoso_capabilities が、支出の前に各モデルの正確なクレジット費用を公開します)。クレジットは最初のプロバイダー呼び出しの前に確保され、後で正確な費用で精算されるので、送信に失敗しても、何も得られないのに請求されることはありません。削除も確認が必要で、エージェントが何を作ったかを伝える前に、すべてのキャンペーンのツリーは広告プラットフォームから読み戻されます。
あえて完全なヘッドレスにしていない手順が一つあります。アカウントの接続は OAuth の同意画面なので、ブラウザでチャンネルを一度接続します。そのあとはすべてツール呼び出しです。
その他のマトリクス
Gemini CLI から次に投稿: Facebook · Instagram · Threads · TikTok · X · LinkedIn · Pinterest · Bluesky · Telegram。またはGemini CLI で投稿できるすべてをご覧ください。
次から YouTube に投稿: Claude · ChatGPT · Claude Code · Cursor · Codex · Cline · OpenClaw · Grok Bot · Hermes · Perplexity · Le Chat · Claude Cowork · Perplexity Computer · Paperclip
よくある質問
Gemini CLI から YouTube に投稿できますか?
はい、Hermoso の Gemini CLI 拡張機能で可能です。gemini extensions install https://github.com/hermoso-ai/hermoso を実行すると、hermoso コマンドを操作する Hermoso のスキルが 5 つ追加されます。その後、npx -y hermoso auth login で一度サインインしてください。サインインではブラウザが開き、認証情報は自動的に保存されるため、作成するキーも貼り付けるキーもありません。Gemini CLI 自身のツール一覧にも Hermoso のツールを入れたい場合は、gemini mcp add --scope user --transport http hermoso https://app.hermoso.ai/mcp で、OAuth でサインインするホスト型サーバーを追加できます。これで Gemini CLI は 922+ のツールを使えるようになります。YouTube への投稿ツールや、市場で配信中の広告をリサーチするツール、そもそもクリエイティブをレンダリングするツールも含まれます。
YouTube を Gemini CLI に接続するには?
2 つの手順で、それぞれ 1 回だけ行います。gemini extensions install https://github.com/hermoso-ai/hermoso を実行すると、hermoso コマンドを操作する Hermoso のスキルが 5 つ追加されます。その後、npx -y hermoso auth login で一度サインインしてください。サインインではブラウザが開き、認証情報は自動的に保存されるため、作成するキーも貼り付けるキーもありません。Gemini CLI 自身のツール一覧にも Hermoso のツールを入れたい場合は、gemini mcp add ... で OAuth でサインインするホスト型サーバーを追加できます。次に Hermoso の 設定 → コネクタ で YouTube を接続します。これはブラウザで表示される OAuth の同意画面です。その後は、Gemini CLI が YouTube への投稿を通常のツール呼び出しとして実行できます。
Gemini CLI で YouTube にカルーセルを投稿できますか?
いいえ。拒否の理由は「非対応」と書くのではなく、その理由を明記します。YouTube の単位は静止画の集まりではなく動画です。Hermoso はスライドを1本の動画につなげて、それを代わりに投稿できます。Gemini CLI はどちらの場合も同じ公開ツールを呼び出し、カルーセルを扱えないチャネルには、その理由を添えて拒否されます。
Gemini CLI で、投稿だけでなく YouTube 広告も運用できますか?
Hermoso は、Google 広告の検索、ディスプレイ、Performance Max キャンペーンを構築します。Keyword Planner の検索ボリュームとコンバージョンアクションにも対応します。YouTube の動画キャンペーンを作成する機能はなく、あるかのように示すこともありません。
Gemini CLI に YouTube のパスワードを渡す必要がありますか?
いいえ。YouTube は、ブラウザでの OAuth 同意画面を通して一度だけ Hermoso に接続します。その後、Gemini CLI はツール呼び出しとしてそれを使います。アカウントの接続は唯一ヘッドレスではない手順で、それ以降はパスワードは不要で、認証情報がモデルに渡されることは一切ありません。
Gemini CLI は、投稿の前に YouTube をリサーチできますか?
はい。search_youtube は公開 YouTube のインデックスを検索し、list_youtube_videos はご自身のアップロード動画(限定公開を含む)を読み取り、analyze_video は競合動画のナレーション、画面内テキスト、タイムスタンプ付きのビート一覧を返します。