Hermoso はマーケティング用の MCP サーバーで、1つの OAuth 対応エンドポイント経由で 922+ 個のツールを提供します。エージェントは、市場で配信中の広告を調べ、完成した画像と動画の広告を作って公開し、その裏で動く有料キャンペーンも構築できます。Codex はこのすべてを1つの接続で利用します。このページでは、その一部として、Codex が X で実際に何をできるか、そして X が何を許さないかを説明します。
Hermoso を Codex に接続する
- コマンド1つ。キーは不要です。
Codex は Hermoso の公開リポジトリにあるマーケットプレイスのファイルを読み込み、5つのスキルをインストールします(リサーチ、ブランドからの広告作成、生成、商品撮影、マーケティング)。スキルはcodex plugin marketplace add hermoso-ai/hermoso && codex plugin add hermoso@hermosonpx経由でhermosoコマンドを実行するため、セッションにツール一覧は読み込まれず、コマンドが実行されるまでコンテキストも消費しません。 - 一度サインインします。
ブラウザでサインインすると、所有者のみが読める認証情報がnpx -y hermoso auth login~/.hermoso/config.jsonに保存されます。CI やコンテナなど、ブラウザがないマシンの場合は、MCP & CLI → Terminal & API keys でキーを作成し、npx -y hermoso auth login --token hmk_…を実行してください。キーには実際の支出権限があるため、パスワードと同じように扱ってください。 - 任意: 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 サインインを行います。スキルは、どちらを使わなくてもすべてのツールに届きます。 - 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 の Settings → Connectors で X 自体を一度だけ接続してください。これは OAuth の同意画面なので、ブラウザでの操作が必要な唯一の手順です。それ以降はすべてツール呼び出しです。
Codex が使える X のツール
post_to_x: テキスト、代替テキスト付きの画像や動画、スレッド全体、返信、引用投稿、投票を投稿します。返信できる相手を制限することもできます。post_x_article: 長文の Article を公開します。Markdown で書けば、見出し、リスト、引用、リンク、コードブロック、表がすべてそのまま反映されます。edit_x_post: 公開済みの投稿を、X が認める1時間以内に書き直します。schedule_post: 共有カレンダーに投稿を予約します。x_post_metrics: 投稿の公開されているカウント数。x_post_insights: 直近28時間に限り、広告主向けの数値を返します。インプレッション、リンクのクリック、プロフィールへのアクセス、動画の再生数、視聴完了の四分位を含みます。x_post_insights_historical: 同じ数値を任意の期間で、一度に最大25件の投稿分まで取得します。「先月はどうだったか」を知りたいときはこれを使います。x_mentions: ブランドについて投稿しているユーザー。delete_x_post: 投稿を削除します。
X は、呼び出しごとに料金がかかる唯一のコネクタで、その数字は隠さず公開しています。Meta、TikTok、LinkedIn、YouTube、Threads、Drive は、リクエストごとの料金がかかりません。X は当社に課金するため、これらの呼び出しには少額のクレジットがかかります。通常の投稿は1リクエストあたり $0.015、リンクを含む投稿は $0.200 で、約13倍です。削除、読み取り、代替テキストのメタデータ書き込みにはそれぞれ料金があり、インサイトは返された投稿ごとに課金されます。リンクの判定は、リンクがあると想定する側に意図的に寄せています。逆に外すと13倍のコストがかかるためです。実際の影響として、X では良い投稿1件が5件に勝ります。エージェントは投稿前に料金を提示されます。文字数は一律280ではなく、投稿アカウントの上限に従います。Hermoso はそのアカウントの X のサブスクリプションを読み取り、Premium で許される場合は最大25,000文字まで送信します。そのため、長い投稿は拒否されずに全文が投稿され、何も切り詰められません。これは料金面でも安く済みます。同じ文章を5件に分けると5回の課金になりますが、1件の長文投稿は課金が1回で済みます。X Premium では、Hermoso が公開する2つの機能も使えます。1つは長文の Article で、見出し、リスト、引用、コードブロック、表を保ったまま Markdown で書けます。もう1つは、X が認める1時間以内に、公開済みの投稿を 編集できる機能です。
自動化する前に知っておきたい X の制限
| テキスト | 文字数は投稿アカウントの上限に従います。通常は280文字、X Premium では最大25,000文字です。Hermoso は X からサブスクリプションを読み取るため、長い投稿も全文が投稿されます。何も切り詰められることはありません。上限は投稿の作成またはキューへの追加時に適用されます。そのため、文字数オーバーの投稿は、送信途中で黙って切られるのではなく、あなたがその場で修正できるうちに拒否されます。 |
|---|---|
| 公開範囲 | 公開のみ。X の投稿は、存在した瞬間から公開されます。API には下書きも限定公開の投稿もありません。鍵付きアカウントは存在しますが、これはアカウント全体の設定で、Hermoso は読み取りも制御もしません。投稿ごとに選べるものではありません。 |
| カルーセル | 理由を明記して拒否します。「X にはスワイプできるカルーセルがありません。」 API は1投稿に最大4つのメディアを付けられ、グリッド状に表示されます。すべての画像が一度に見え、スワイプできる部分がありません。そのため、番号付きの「1/6 · SWIPE」スライドデッキは、意図どおりには投稿できません。拒否の理由には、代わりの方法も示されます。「最も強いスライド1枚を X に投稿するか、この投稿から X を外してください。」 読者にスワイプを促すデッキをグリッドで公開するのは、公開しないよりも悪い結果になります。 |
| どのアカウントか | なし。X は接続されたアカウントに投稿します。 |
Codex で試す
普通の言葉で頼んでください。これは DSL ではなく、普通の文章です。
「非対話: リリースごとに X の投稿を1件、280 文字以内で行い、リンクはその1投稿だけに入れて、請求された料金を記録してください。」
これは get_brand → generate_text → post_to_x → x_post_insights_historical の流れです。対話モードでは、Codex は実行前にその呼び出しを表示します。非対話モードでは確認する相手がいないため、投稿や支出を伴う手順は、その前提で設計する必要があります。
Codex で X を使うときの注意点
この作業の予算は、意図して立ててください。投稿、削除、読み取りのたびに課金されます。インサイトは返された投稿ごとに課金されます。そしてリンクを含む投稿は、リンクのない投稿のおよそ13倍の料金になります。無人のジョブでは、スレッドではなく出来事ごとに1投稿にすること、リンクは複数ではなく1つにすること、そしてジョブの実行頻度に上限を設けることを意味します。文字数上限は明確な拒否として返されるため、失敗したジョブは、中途半端な内容を投稿するのではなく、はっきりと失敗します。
無人実行では、ツールマニフェスト全体ではなく、--json 付きの hermoso CLI を使うことをおすすめします。コンテキストの消費がはるかに少なく、結果の検証もしやすくなります。
投稿前に X を調べる
検索できる X の広告ライブラリはありません。ここでの X のリサーチは、ご自身のアカウントが対象です。メンション、投稿の指標、広告主向けの過去の数値などです。リサーチ機能のそのほかの部分はそのまま使えます。Meta、Google、LinkedIn の広告ライブラリや、オーガニックの TikTok、Instagram、YouTube、Reddit、Threads が含まれます。
有料の側
X 広告は2026年8月に提供を開始したため、X は今や両方の領域をカバーします。X Ads API は独立したプロダクトで、別のホストと独自の OAuth 1.0a 署名を使います。そのため、ほかの機能より後に提供されました。Hermoso は現在、その上に広告投稿のツリー全体を構築します。キャンペーン、ラインアイテム（X での広告グループの名称）、プロモート投稿、ターゲティング、予算、ステータス、レポートです。X 広告は投稿を宣伝するものなので、クリエイティブは投稿そのものであり、Hermoso がオーガニックで公開するのと同じ投稿になります。実際の費用を発生させるスイッチは、ほかの11プラットフォームと同様に、明示的な確認がないと動きません。予算を立てる前に知っておいてほしいことがあります。X は Ads API へのアクセスをアプリ単位ではなく広告アカウント単位で付与します。そのため、OAuth のボタンはありません。business.x.com の Account access で、Hermoso の X ユーザーをご自身の広告アカウントに追加してください。すると list_x_ads_accounts に、X が付与した権限レベルとともに表示されます。
Codex だけではできないこと
予算を持ったエージェントは、被害の範囲が限られていて初めて役に立つので、囲いはプロンプトではなくサーバー側にあります。すべての広告キャンペーン、広告セット、広告グループ、広告は一時停止の状態で作成され、実際のお金を動かす支出の切り替えは、明示的な確認フラグなしでは実行されません。すべてのレンダリングは、まず見積もられます（hermoso_capabilities が、支出の前に各モデルの正確なクレジット費用を公開します）。クレジットは最初のプロバイダー呼び出しの前に確保され、後で正確な費用で精算されるので、送信に失敗しても、何も得られないのに請求されることはありません。削除も確認が必要で、エージェントが何を作ったかを伝える前に、すべてのキャンペーンのツリーは広告プラットフォームから読み戻されます。
あえて完全なヘッドレスにしていない手順が一つあります。アカウントの接続は OAuth の同意画面なので、ブラウザでチャンネルを一度接続します。そのあとはすべてツール呼び出しです。
その他のマトリクス
Codex からの投稿先: Facebook · Instagram · Threads · TikTok · YouTube · LinkedIn · Pinterest · Bluesky · Telegram。または Codex から投稿できるすべての先をご覧ください。
X への投稿元: Claude · ChatGPT · Claude Code · Cursor · Cline · OpenClaw · Grok Bot · Hermes · Gemini CLI · Perplexity · Le Chat · Claude Cowork · Perplexity Computer · Paperclip · コマンドラインからの広告
よくある質問
Codex から X に投稿できますか？
はい、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 以上のツールが使えます。X に投稿するツールや、市場で配信中の広告を調べるツール、クリエイティブを作成するツールも含まれます。
X を 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 の 設定 → コネクタ で X を接続します。ブラウザ上の OAuth 同意画面です。以降、Codex は通常のツール呼び出しとして X に投稿します。
Codex で X にカルーセル投稿できますか？
いいえ。X の API は1投稿に最大4つのメディアを添付でき、それらはグリッド状に表示されます。すべての画像が一度に見え、スワイプできる部分はありません。そのため、番号付きのスライドデッキを意図どおりに投稿することはできません。Codex はどちらの場合も同じ投稿ツールを呼び出します。カルーセルを扱えないチャネルには、その理由を添えて拒否されます。
Codex から X に投稿するといくらかかりますか？
X は、呼び出しごとにクレジットを消費する唯一のコネクタです。X が API リクエストごとに課金するためです。目安は、投稿が $0.015、リンクを含む投稿が $0.200 で、約13倍になります。エージェントは投稿の前に料金を提示されます。プランは月額 $29、$69、$149 で、それぞれ 1,200、3,000、7,000 クレジットです。すべての機能は Free プランを含む全プランで使えます。例外はエンタープライズ SSO だけです。
Codex に X のパスワードは必要ですか？
いいえ。X の接続は、ブラウザの OAuth 同意画面で Hermoso と一度だけ行います。その後、Codex はツール呼び出しで X を利用します。アカウントの連携だけはブラウザでの操作が必要で、それ以降はパスワードが不要です。認証情報がモデルに渡されることもありません。
Codex で X の投稿を後日の予約にできますか？
はい。schedule_post は、他のすべてのチャネルと共有の1つのカレンダーに投稿を予約します。文面を変えたい場合は、チャネルごとのキャプションも設定できます。list_scheduled と cancel_scheduled で予約を確認し、取り消せます。X は、予約に対応する11チャネルのひとつです。