Gemini CLI から Instagram に投稿

Gemini CLI からの Instagram では、キャプションは後から変更できない唯一の部分なので、呼び出しの前にレンダリングとキャプションを確認する形になります。

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

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

Gemini CLI が使える Instagram のツール

  • post_to_meta:target: "instagram" を指定して Instagram に公開します。Instagram はビジュアルのチャンネルで、API もそれを前提にしています。投稿には画像か動画が必要です。
  • schedule_post:共有カレンダーにキューします。キャプションを Facebook や LinkedIn 版と変えたい場合は、チャンネルごとに付けられます。
  • list_meta_comments / reply_to_meta_comment / moderate_meta_comment:投稿へのコメントを読み、返信し、管理します。
  • meta_page_insights / meta_post_insights:アカウント単位と投稿単位のリーチ、インプレッション、保存、エンゲージメント。
  • search_instagram:公開された Instagram のリールをキーワードで検索します。公開ではなくリサーチのためのものです。

自動化の前に知っておきたい Instagram の事実が二つあります。Meta の API にはInstagram のネイティブな予約機能はありません。そのため、予約は Instagram のものではなく Hermoso のキューになり、Instagram に対して Facebook の scheduleAt を渡すと、黙って今すぐ投稿するのではなく拒否されます。また、公開後の Instagram のキャプションは編集できません。Meta が公開済みの投稿で変更を許すのは、コメントを有効にするかどうかだけです。投稿の削除は可能です。manage_meta_post は、通常の投稿、ストーリーズ、リール、カルーセルのアルバム全体を削除できますが、アルバムの中の一枚だけを削除することはできません。

自動化の前に知っておくべき Instagram の上限

テキストInstagram のキャプションは2,200文字が上限です。投稿の作成またはキューに入れる時点で適用されるので、上限を超えた投稿は、黙って途中で切られるのではなく、あなたがまだそこにいるうちに拒否され、修正できます。
公開範囲公開のみ。Meta のコンテンツ公開 API は即時に公開するか、まったく公開しないかのどちらかで、Instagram には「限定公開、非公開、下書きの投稿はない」とされています。Instagram でレビューの工程が必要なら、呼び出しの後ではなく、前に行う必要があります。
カルーセル2〜10枚のスライド、画像と動画は混在可能。上限の10は Meta 自身のもので、それが適用する対応表に引用されています。「カルーセルは、画像、動画、またはその両方の混在で最大10件までです」。下限の2は当社のもので、どのプラットフォームでも1枚のスライドはカルーセルではないからです。1枚のリクエストは、拒否されるのではなく、通常の投稿として公開されます。
どのアカウントかpageId。Instagram は接続された Facebook ページを通して公開するので、同じ識別フィールドで選びます。

Gemini CLI で試す

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

“./assets/slides の画像をファイル名順に並べて 6 枚スライドの Instagram カルーセルを作り、キャプションを見せて、私が承知したら投稿してください。”

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

Instagram での Gemini CLI:要注意の点

Gemini CLI はシェルコマンドを実行する前に確認を求め、スキルは hermoso コマンドを通じて Hermoso に届くため、キャプションの確認はその確認プロンプトで行われます。Meta は、公開中の Instagram キャプションの編集を認めていません。変更できるのはコメントを有効にするかどうかだけです。削除は manage_meta_post でサポートされており、アルバム全体も対象です。ただしアルバムから 1 枚だけ削除することはできません。

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

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

search_meta_ads は一つのライブラリなので、Facebook に加えて Instagram の配置も対象にします。オーガニックについては、search_instagram が公開リールをキーワードで検索します。これは形式が実際に動いている面です。プロフィールとハッシュタグの取得は fetch_social_data と search_instagram_hashtag を通します。

有料の側

Instagram の配置は、Facebook と同じ Meta のキャンペーンツリーを通して購入します。create_meta_campaign → create_meta_adset → create_meta_ad。配置はプラットフォームと位置ごとに選べます。preview_meta_ad は、支出の前に配置ごとの実際にレンダリングされた広告を表示し、meta_insights は結果を年齢、性別、配置、国別に分けます。その内訳が次のクリエイティブを形作ります。

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

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

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

その他のマトリクス

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

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

よくある質問

Gemini CLI から Instagram に投稿できますか?

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

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

Gemini CLI から Instagram に非公開や下書きで投稿できますか?

いいえ。Instagram のコンテンツ公開 API は、公開するか何もしないかのどちらかです。限定公開、非公開、下書きの投稿はありません。公開済みのキャプションは編集できません。Meta が公開中の投稿で変更を許しているのは、コメントを有効にするかどうかだけです。投稿の削除には対応しており、通常の投稿、ストーリーズ、リール、カルーセルのアルバム全体が対象です。Hermoso は、Instagram が対応できない公開範囲を指定された場合、より弱い形で黙って公開するのではなく、その場で拒否します。

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

はい。search_meta_ads は Meta 広告ライブラリの Instagram の掲載面を対象にし、search_instagram はキーワードで公開リールを検索します。

Gemini CLI から投稿するときの Instagram の文字数上限は?

Instagram のキャプションは2,200文字が上限です。この上限は、投稿の発火時ではなく、キューに入れた時点で適用されます。Hermoso は投稿の作成またはキューへの追加時に適用するため、Gemini CLI にはすぐに伝わります。誰も見ていないときに後から失敗することはありません。

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

はい。Meta のキャンペーンツリーを通じて可能です。Instagram の掲載面は、Meta の広告セット内で選択します。preview_meta_ad は、費用をかける前に掲載面ごとの実際の広告を表示します。

登録時に30クレジットで無料で始められ、さらに250+クレジットを獲得できます。すべての機能がすべてのプランに含まれます。

無料で始める →   料金を見る