Codex から投稿、予約、広告配信

Codex とは？

Codex は OpenAI のコーディングエージェントで、ターミナル、IDE 拡張機能、ChatGPT デスクトップアプリから操作できます。対話的にも非対話的にも実行でき、会話ではなくスケジュールに従ってマーケティングの作業を行わせたいときに選ばれるクライアントです。

Codex か ChatGPT か? Codex は OpenAI のコーディングエージェントで、Hermoso をプラグインまたは MCP サーバーとして利用できます。ChatGPT のチャットアプリでは、アプリディレクトリから Hermoso を追加します。

Hermoso は、マーケティングを自動運転させるサービスです。922+ のツールを一つの MCP エンドポイントで提供し、競合の広告リサーチ、100+ のモデルによる完成した画像と動画の広告、十一の SNS チャンネルへの投稿と予約、そして Meta、Google Ads、Microsoft Advertising、Reddit Ads、LinkedIn、Pinterest、X Ads、TikTok Ads、Snapchat Ads、ChatGPT Ads、Apple Search Ads、AppLovin Ads でのキャンペーン管理に対応しています。接続は一つで、Codex からすべて使えます。

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 の形式でプラグインのマーケットプレイスを読み込むため、同じリポジトリで両方にインストールできます。

Codex が投稿できるすべてのチャンネル

それぞれに専用のページがあり、そのチャンネルの実際のキャプション上限、実際の公開範囲の選択肢、拒否する内容とその理由、そして Codex 向けの言い回しで書いた実例があります。

これらすべてのチャンネルは、チャンネルごとのキャプションを付けて、一つの schedule_post のカレンダーを通ります。list_scheduled は、単一の緑のチェックマークではなく、チャンネルごとの結果を報告します。「ジョブが成功した」と「投稿が出た」は別の問いだからです。予約された投稿は Hermoso に保存されるので、Codex が動いているかどうかに関係なく、時刻どおりに出ます。

Google ビジネスプロフィール は最も新しいチャンネルです。Google 検索とマップの掲載情報に、写真とボタン付きの投稿を出し、クチコミへの返信、掲載情報の編集、そして掲載情報から得られる電話、ウェブサイトへのクリック、道順のリクエストを扱います。Codex は同じツールでこれに接続し、schedule_post で同じカレンダーに予約できます。

構築済みだが提供していないチャンネルがあります

率直に言うことが、長い一覧よりも価値があります。コードベースには一つの投稿先が存在しますが、見送っています。理由は私たちではなく、プラットフォーム側の待ちだからです。

• Reddit：オーガニックな投稿と投稿の統計は構築済みです。ただし Reddit の Responsible Builder Policy では、アプリが Data API を使う前に明示的な書面による承認が必要で、その申請はまだ下りていません。そのため、無効な API につながる OAuth 画面として提示するのではなく、コネクタは見送っています。Reddit Ads は別の接続で、こちらは稼働しています。キャンペーンのツリー全体、予測、ターゲティング検索、ピクセル、リードフォームに対応しています。

OAuth が成功しても API が動かないコネクタは、まだ提供されていないコネクタより悪いので、利用可能な一覧には載せていません。

接続したら入力する三つの例

1. リサーチ。「私の競合上位三社は誰で、最も長く配信されている Meta 広告は何ですか？ どのフックが繰り返し使われているか教えて。」 これは find_competitors → pull_competitor_ads → mine_angles を実行します。
2. 制作。「そのフックを使った9:16の UGC 動画広告を作って。私の本物の製品写真とキャプションを焼き込んで。」 これは get_brand → plan_ad → render_ad を実行し、完成した mp4 の URL を返します。
3. 配信。「火曜日の午前9時に Instagram と TikTok に予約して、それを中心に、米国をターゲットに1日$30で一時停止中の Meta キャンペーンを作って。」 これは schedule_post → create_meta_campaign → create_meta_ad を実行します。

Codex だけではできないこと

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

一つの手順だけは、あえて人の手に残しています。それは各アカウントを一度だけ接続することです。ほとんどのチャンネルは、ブラウザでプラットフォーム自身の OAuth 同意画面を通して接続します。Bluesky はアプリパスワードを、Telegram はボットトークンを取り、Hermoso に貼り付けます。その後はすべて、ツール呼び出しで済みます。

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

費用

Codex に Hermoso を追加しても、追加料金はかかりません。クレジットのメーターは一つで、どのクライアントから呼び出されたかは関係ありません。無料アカウントは、登録時に30クレジットで始まり、獲得できる250+クレジットがあります。クレジットが使われるのは AI モデルと Ad Spy リサーチだけです。投稿、予約、広告運用、分析は、X を除くすべてのチャンネルで無料です。X は API リクエストごとに料金がかかるため、呼び出しごとに課金されます。有料プランは月額 $29、$69、$149 で、それぞれ 1,200、3,000、7,000 クレジットです。すべての機能がすべてのプランに含まれます。hermoso_capabilities で、どのレンダリングも実行前に正確なクレジット価格を確認できます。

トラブルシューティング

• ローカルサーバーがヘルプを表示して終了する。引数の末尾に mcp がありません。npx -y hermoso だけではヘルプが表示され、npx -y hermoso mcp でサーバーが起動します。
• そのマシンにブラウザがない。MCP & CLI → Terminal & API keys でキーを作成し、代わりに npx -y hermoso auth login --token hmk_… を実行してください。
• チャンネルが見当たりません。Hermoso で 設定 → コネクタ から接続してから、Codex に list_connectors をもう一度実行してもらってください。
• Codex が Hermoso を使わずに答えます。リクエストの中で名前を挙げてください。「Hermoso を使って…」。これで、どのツールで処理すべきかに迷いがなくなります。

投稿の先へ

投稿は最後のステップで、最も小さなものです。同じ接続で、Codex は Meta、Google、LinkedIn の広告ライブラリに加えて、リサーチ用に TikTok、Instagram、YouTube、Reddit、Threads のオーガニック投稿も使えます。100+ の画像・動画・音声・文章モデルを一つのクレジットのメーターで使え、UGC アバター、吹き替え、アップスケール、ネイティブの HTML 広告フォーマットにも対応します。さらに、十二の有料プラットフォームすべてのキャンペーンツリーを扱えます。ベンダーごとの API キーを持つ必要も、覚えるべき別のアプリもありません。

ツールの全一覧、Hermoso が動作するすべてのエージェント、マーケティング MCP とはをご覧ください。このクライアントに関する詳しい話は、コマンドラインからの広告をご覧ください。

他のエージェントでの Hermoso

以下のどのエージェントでも、同じ Hermoso アカウントが使えます。ブランド、ライブラリ、スケジュール、クレジットは、それらの間で引き継がれます。

よくある質問

Codex で SNS に投稿できますか？

はい。Hermoso をインストールすれば可能です。Codex は、Facebook、Instagram、Threads、TikTok、YouTube、X、LinkedIn、Pinterest、Bluesky、Telegram、Google ビジネス プロフィールに公開できます。チャネルごとのキャプション付きで、11すべてを1つのキューから予約できます。

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 は 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 の形式でプラグインのマーケットプレイスを読み込むため、同じリポジトリで両方にインストールできます。

Codex で競合の広告を調べられますか?

はい。Codex からは、Meta、Google、LinkedIn の広告ライブラリを、オーガニックな TikTok、Instagram、YouTube、Reddit、Threads と合わせて検索できます。結果は配信期間の長さ順です。数か月間配信され続けている広告は、それだけ成果を出している広告だからです。また、競合のサイトを解析し、動画のナレーション、画面上のテキスト、タイムスタンプ付きのビート一覧を返すこともできます。

Codex で Hermoso を使うのに、別のアカウントは必要ですか?

いいえ。Hermoso のアカウントが1つあれば十分で、Codex はそのアカウントで認証します。サインインの手順で認証情報が自動で保存されるため、貼り付ける必要はありません。Web スタジオ app.hermoso.ai も同じエンジンと同じクレジットを使います。

Codex に投稿や広告の運用を任せても安全ですか？

お金がかかる操作や取り消せない操作は、Codex の設定にかかわらず、Hermoso のサーバー側でゲートされています。すべてのキャンペーンは一時停止の状態で作成され、支出の切り替えや削除には明示的な確認が必要です。また投稿は、接続して Hermoso で有効にしたアカウントにしか届きません。対話モードでは、Codex は実行前にその呼び出しを表示します。非対話モードでは確認する相手がいないため、投稿や支出を伴う手順は、その前提で設計する必要があります。

Codex の CLI とデスクトップアプリで、Hermoso の設定は共有されますか?

はい、MCP サーバーについては共有されます。OpenAI は、Codex CLI、IDE 拡張機能、ChatGPT デスクトップアプリの Codex が共有する設定ファイル ~/.codex/config.toml を1つ定めています。そのため codex mcp add で追加したサーバーは、この3つすべてに表示されます。