Gemini CLI から X に投稿

Hermoso はマーケティング用の MCP サーバーで、1つの OAuth 対応エンドポイント経由で 922+ 個のツールを提供します。エージェントは、市場で配信中の広告を調べ、完成した画像と動画の広告を作って公開し、その裏で動く有料キャンペーンも構築できます。Gemini CLI はこのすべてを1つの接続で利用します。このページでは、その一部として、Gemini CLI が X で実際に何をできるか、そして X が何を許さないかを説明します。

Hermoso を Gemini CLI に接続する

1. 拡張機能をインストールします。

   gemini extensions install https://github.com/hermoso-ai/hermoso

   Hermoso の公開リポジトリの最新リリースをインストールします。これには 5 つのスキル（research、ad-from-brand、generate、product-photoshoot、marketing）と GEMINI.md コンテキストファイルが含まれます。スキルは npx を通じて hermoso コマンドを実行するため、Gemini CLI のツール一覧には何も追加されず、コマンドが実行されるまでコンテキストも消費しません。gemini extensions list では、スキルが Agent skills の下に表示されます。
2. 一度サインインします。

   npx -y hermoso auth login

   ブラウザでのサインインが開き、所有者のみが読める認証情報を ~/.hermoso/config.json に保存します。Gemini CLI は、Hermoso が初めて必要になったときに、代わりにこれを実行できます。そのマシンにブラウザがない場合は、MCP & CLI → Terminal & API keys でキーを作成し、npx -y hermoso auth login --token hmk_… を実行してください。
3. 任意: MCP サーバーも追加する場合。

   gemini mcp add --scope user --transport http hermoso https://app.hermoso.ai/mcp

   最初の接続が 401 を返すと、Gemini CLI は Hermoso の認可サーバーを見つけて自分自身を登録するため、settings.json にキーを書く必要はありません。セッション内で /mcp auth hermoso を実行するとサインインできます。スキルは、これがなくてもすべてのツールに届きます。
4. Gemini CLI に何かを頼みます。「競合上位3社の、最も長く配信されている広告を取得して、一番良いフックを9:16の動画にリミックスして」、または「このレンダリングをチャンネルに投稿して」。エージェントがツールを選び、支出はあなたが承認します。

上記のインストールは、2026-09-23 に、クリーンなホームディレクトリで Gemini CLI 0.60.0 を使って実行しました。hermoso-ai/hermoso の最新リリースを取得し、gemini extensions list に 5 つのスキルとコンテキストファイルが表示されました。拡張機能は独自の MCP サーバーを持ちません。これは意図的です。ツール一覧はすべてのセッションに読み込まれますが、スキルは実行されるまで何のコストもかからないからです。Hermoso は Google と提携しておらず、そのように主張することもありません。

続けて、Hermoso の Settings → Connectors で X 自体を一度だけ接続してください。これは OAuth の同意画面なので、ブラウザでの操作が必要な唯一の手順です。それ以降はすべてツール呼び出しです。

Gemini CLI が使える 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 の制限

Gemini CLI で試す

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

“./notes/launch.md を 1 件の X 投稿にしてください。収まらなければ短いスレッドにし、リンクは最後の投稿にだけ入れて、まず料金を教えてください。”

流れは get_brand → generate_text → post_to_x → x_post_insights_historical です。Gemini CLI はシェルコマンドを実行する前に確認を求め、スキルは hermoso コマンドを通じて動くため、公開は「はい」と答える前に読める 1 行として表示されます。MCP ツールについては、1 回だけ許可するか、そのツールを常に許可するか、サーバーを常に許可するかを選べます。

Gemini CLI で X を使うときの注意点

Hermoso の MCP サーバーを Gemini CLI に追加して X に投稿させる場合は、--trust を付けないでください。このフラグは、そのサーバーのすべての確認をスキップしてしまいます。X では、各投稿、読み取り、削除が課金対象の呼び出しになり、リンク付きの投稿は、リンクなしの約 13 倍の料金です。Premium アカウントでは、長い投稿 1 件が課金呼び出し 1 回ですが、5 投稿のスレッドは 5 回になります。

Gemini CLI で、この安全性を決める 2 つの詳細があります。gemini mcp add は、--scope user を渡さない限り、プロジェクトの .gemini/settings.json に書き込みます。1 つのリポジトリを常に 1 つのブランドで動かしたい場合は、これが役立ちます。また、Hermoso を --trust 付きで追加しないでください。サーバーに対するすべての確認をスキップしてしまい、公開の前に出る確認も含まれます。MCP ツールは mcp_hermoso_ とツール名を組み合わせた名前で届き、--exclude-tools を使えば、いくつでも完全に除外できます。

投稿前に 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 が付与した権限レベルとともに表示されます。

Gemini CLI だけではできないこと

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

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

その他のマトリクス

Gemini CLI から次に投稿: Facebook · Instagram · Threads · TikTok · YouTube · LinkedIn · Pinterest · Bluesky · Telegram。またはGemini CLI で投稿できるすべてをご覧ください。

次から X に投稿: Claude · ChatGPT · Claude Code · Cursor · Codex · Cline · OpenClaw · Grok Bot · Hermes · Perplexity · Le Chat · Claude Cowork · Perplexity Computer · Paperclip

よくある質問

Gemini CLI から X に投稿できますか？

はい、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+ のツールを使えるようになります。X への投稿ツールや、市場で配信中の広告をリサーチするツール、そもそもクリエイティブをレンダリングするツールも含まれます。

X を 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 の 設定 → コネクタ で X を接続します。これはブラウザで表示される OAuth の同意画面です。その後は、Gemini CLI が X への投稿を通常のツール呼び出しとして実行できます。

Gemini CLI で X に非公開または下書きで投稿できますか？

いいえ。X の投稿は、存在した瞬間から公開されます。API には下書きも限定公開の投稿もありません。Hermoso は、X が対応できない公開範囲を指定された場合、より弱い形で黙って公開するのではなく、その場で拒否します。

Gemini CLI は、投稿の前に X をリサーチできますか？

広告ライブラリを通じてはできません。X は広告ライブラリを公開していないためです。Hermoso が X で読み取るのは、ご自身のアカウントです。投稿の指標、任意の期間の広告主向けインサイト、ブランドへのメンションです。

Gemini CLI から投稿する場合、X のキャプションの上限はいくつですか？

アカウントによって異なります。Hermoso は推測せず、確認します。通常の X アカウントは280文字が上限です。X Premium のアカウントは最大25,000文字です。Hermoso は X からサブスクリプションを読み取って投稿を送るため、長い投稿も全文が投稿され、何も切り詰められません。Premium アカウントでは、長い投稿1件のほうが、スレッドより読みやすく、料金も安く済むことが多いです。5つに分けると5回の課金になりますが、1件の長文投稿なら課金は1回です。Premium では、Markdown で書く長文の Article も使え、X が認める1時間以内であれば、公開済みの投稿を編集することもできます。Hermoso は投稿の作成またはキューへの追加時に適用するため、Gemini CLI にはすぐに伝わります。誰も見ていないときに後から失敗することはありません。

Gemini CLI で、投稿だけでなく X 広告も運用できますか？

はい。2026年8月から可能です。X 広告は、独自の OAuth 1.0a 署名を使う別のホストで動作し、Hermoso はその上にツリー全体を構築します。キャンペーン、ラインアイテム、プロモート投稿、ターゲティング、予算、ステータス、レポートです。X は Ads API へのアクセスをアプリ単位ではなく広告アカウント単位で付与するため、OAuth のボタンはありません。business.x.com の Account access で、Hermoso の X ユーザーをご自身の広告アカウントに追加してください。