Codex から YouTube に投稿

Hermoso はマーケティング用の MCP サーバーです。922+ のツールを一つの OAuth 対応エンドポイントで提供し、エージェントが市場で既に配信されている広告をリサーチし、完成した画像と動画の広告を生成し、それらを投稿し、その背後にある有料キャンペーンを作れるようにします。Codex は一つの接続からこれらすべてを使えます。このページでは、その中の一部を扱います。Codex が YouTube で実際に何をできて、YouTube が何をさせないかです。

Hermoso を Codex に接続する

1. コマンド1つ。キーは不要です。

   codex plugin marketplace add hermoso-ai/hermoso && codex plugin add hermoso@hermoso

   Codex は Hermoso の公開リポジトリにあるマーケットプレイスのファイルを読み込み、5つのスキルをインストールします(リサーチ、ブランドからの広告作成、生成、商品撮影、マーケティング)。スキルは npx 経由で hermoso コマンドを実行するため、セッションにツール一覧は読み込まれず、コマンドが実行されるまでコンテキストも消費しません。
2. 一度サインインします。

   npx -y hermoso auth login

   ブラウザでサインインすると、所有者のみが読める認証情報が ~/.hermoso/config.json に保存されます。CI やコンテナなど、ブラウザがないマシンの場合は、MCP & CLI → Terminal & API keys でキーを作成し、npx -y hermoso auth login --token hmk_… を実行してください。キーには実際の支出権限があるため、パスワードと同じように扱ってください。
3. 任意: MCP サーバーも追加する場合。

   codex mcp add hermoso -- npx -y hermoso mcp

   これでサーバーが ~/.codex/config.toml に書き込まれ、同じ保存済み認証情報を読み込みます。そのためファイルにキーは書かれません。ホストされたエンドポイントを使いたい場合は、codex mcp add hermoso --url https://app.hermoso.ai/mcp を実行し、codex mcp login hermoso で OAuth サインインを行います。スキルは、どちらを使わなくてもすべてのツールに届きます。
4. Codex に何かを頼みます。「競合上位3社の、最も長く配信されている広告を取得して、一番良いフックを9:16の動画にリミックスして」、または「このレンダリングをチャンネルに投稿して」。エージェントがツールを選び、支出はあなたが承認します。

Codex は MCP サーバーを ~/.codex/config.toml に保存します。信頼されたプロジェクトでは .codex/config.toml に保存されます。このファイルは JSON ではなく TOML 形式なので、mcpServers のブロックをコピーしても読み込まれません。手書きする場合は [mcp_servers.hermoso] として、command = "npx" と args = ["-y", "hermoso", "mcp"] を指定します。末尾の mcp は必須です。npx -y hermoso だけではヘルプを表示して終了します。Codex は Claude Code と同じ .claude-plugin の形式でプラグインのマーケットプレイスを読み込むため、同じリポジトリで両方にインストールできます。

その後、Hermoso の 設定 → コネクタ で YouTube 自体を一度接続してください。これはブラウザでの OAuth 同意画面なので、唯一ブラウザが必要な手順です。そのあとはすべてツール呼び出しです。

Codex が使える 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 の上限

Codex で試す

普通の言葉で頼んでください。これは DSL ではなく、普通の文章です。

「非対話: 入力フォルダーの mp4 ごとに、100 文字以内のタイトルと 5,000 文字の説明文を書き、サムネイルを生成して、限定公開でアップロードし、JSON を出力してください。」

これは make_thumbnail → post_to_youtube → set_youtube_thumbnail → youtube_video_insights の流れです。対話モードでは、Codex は実行前にその呼び出しを表示します。非対話モードでは確認する相手がいないため、投稿や支出を伴う手順は、その前提で設計する必要があります。

YouTube での Codex：要注意の点

無人の実行からは、必ず限定公開でアップロードしてください。YouTube には Studio の下書きがないため、限定公開がレビューの状態になります。公開範囲をそのまま公開にしたバッチは、後から静かに取り消すことができません。また、先にチャンネルを確認してください。Google プロジェクトが未確認の場合、ジョブがどの公開範囲を指定しても、アップロードは非公開に固定されます。これはバグのように見えますが、バグではありません。

無人実行では、ツールマニフェスト全体ではなく、--json 付きの hermoso CLI を使うことをおすすめします。コンテキストの消費がはるかに少なく、結果の検証もしやすくなります。

投稿の前に YouTube をリサーチする

search_youtube は公開されている YouTube のインデックスを検索します。「自分がアップロードした動画」を確認する質問とは別物で、その用途には list_youtube_videos を使います。競合の動画については、analyze_video がナレーション、画面内のテキスト、タイムスタンプ付きのビート一覧を返します。フックを作り直す前に、まさに必要な情報がそろいます。

有料の側

Hermoso の Google Ads ツールは、検索、ディスプレイ、Performance Max キャンペーンを構築します。ツリー全体を1回のアトミックな操作で作成し、エージェントが説明する前に Google から読み戻します。さらに、Keyword Planner の検索ボリューム、コンバージョンアクション、サイトリンクとコールアウトの作成と紐付けにも対応します。YouTube 動画キャンペーンの作成機能はなく、あるかのように示すのは誤りです。YouTube の動画アセットはアップロードして紐付けられますが、Hermoso が作成するキャンペーンの種類は検索、ディスプレイ、Performance Max です。

Codex だけではできないこと

予算を持ったエージェントは、被害の範囲が限られていて初めて役に立つので、囲いはプロンプトではなくサーバー側にあります。すべての広告キャンペーン、広告セット、広告グループ、広告は一時停止の状態で作成され、実際のお金を動かす支出の切り替えは、明示的な確認フラグなしでは実行されません。すべてのレンダリングは、まず見積もられます（hermoso_capabilities が、支出の前に各モデルの正確なクレジット費用を公開します）。クレジットは最初のプロバイダー呼び出しの前に確保され、後で正確な費用で精算されるので、送信に失敗しても、何も得られないのに請求されることはありません。削除も確認が必要で、エージェントが何を作ったかを伝える前に、すべてのキャンペーンのツリーは広告プラットフォームから読み戻されます。

あえて完全なヘッドレスにしていない手順が一つあります。アカウントの接続は OAuth の同意画面なので、ブラウザでチャンネルを一度接続します。そのあとはすべてツール呼び出しです。

その他のマトリクス

Codex からの投稿先: Facebook · Instagram · Threads · TikTok · X · LinkedIn · Pinterest · Bluesky · Telegram。または Codex から投稿できるすべての先をご覧ください。

YouTube への投稿元: Claude · ChatGPT · Claude Code · Cursor · Cline · OpenClaw · Grok Bot · Hermes · Gemini CLI · Perplexity · Le Chat · Claude Cowork · Perplexity Computer · Paperclip · コマンドラインからの広告

よくある質問

Codex から YouTube に投稿できますか？

はい、Hermoso の Codex プラグイン経由で可能です。codex plugin marketplace add hermoso-ai/hermoso && codex plugin add hermoso@hermoso を実行し、Hermoso のスキルをインストールします。その後、npx -y hermoso auth login で一度サインインしてください。ブラウザが開き、認証情報は自動で保存されるため、キーの作成も貼り付けも不要です。MCP サーバーも使う場合は、codex mcp add hermoso -- npx -y hermoso mcp を実行します。その後、Codex では 922 以上のツールが使えます。YouTube に投稿するツールや、市場で配信中の広告を調べるツール、クリエイティブを作成するツールも含まれます。

YouTube を Codex に接続するには？

手順は2つ、それぞれ一度だけです。codex plugin marketplace add hermoso-ai/hermoso && codex plugin add hermoso@hermoso を実行し、Hermoso のスキルをインストールします。その後、npx -y hermoso auth login で一度サインインしてください。ブラウザが開き、認証情報は自動で保存されるため、キーの作成も貼り付けも不要です。MCP サーバーも使う場合は、codex mcp add hermoso -- npx -y hermoso mcp を実行します。次に Hermoso の 設定 → コネクタ で YouTube を接続します。ブラウザ上の OAuth 同意画面です。以降、Codex は通常のツール呼び出しとして YouTube に投稿します。

Codex から投稿するときの YouTube の文字数上限は？

YouTube のタイトルは100文字が上限です。説明は別のフィールドで、最大5,000文字、タグは最大30個です。予約された項目のテキストはタイトルになるので、両方を明示的に渡す必要があります。Hermoso は投稿の作成またはキューに入れる時点で適用するので、後で誰も見ていないときに失敗するのではなく、Codex にすぐ伝わります。

Codex で YouTube の投稿を後から予約できますか？

はい。schedule_post は、他のすべてのチャンネルと共有する一つのカレンダーに投稿を入れます。キャプションを変えたい場合は、チャンネルごとに付けられます。list_scheduled と cancel_scheduled で読み取りと取り消しができます。YouTube は、キューに入る十一チャンネルの一つです。

Codex から YouTube に非公開や下書きで投稿できますか？

はい：公開、限定公開、非公開。YouTube の API には Studio の下書きがないため、限定公開がレビューの状態に最も近く、即時の投稿はそれが既定になります。Hermoso は、YouTube ができない公開範囲を依頼された時点で拒否し、黙ってより弱い形で公開することはありません。

Codex から YouTube に投稿するのにコストはかかりますか？

YouTube への投稿にはクレジットがかかりません。YouTube は API 呼び出しごとに料金を取らないためです。クレジットは動画とサムネイルの生成にかかります。プランは月額 $29、$69、$149 で、それぞれ 1,200、3,000、7,000 クレジットです。すべての機能が Free を含むすべてのプランに含まれます。例外はエンタープライズ向けの SSO だけです。