Hermoso はマーケティング用の MCP サーバーです。922+ のツールを一つの OAuth 対応エンドポイントで提供し、エージェントが市場で既に配信されている広告をリサーチし、完成した画像と動画の広告を生成し、それらを投稿し、その背後にある有料キャンペーンを作れるようにします。Gemini CLI は一つの接続からこれらすべてを使えます。このページでは、その中の一部を扱います。Gemini CLI が Telegram で実際に何をできて、Telegram が何をさせないかです。
Hermoso を Gemini CLI に接続する
- 拡張機能をインストールします。
Hermoso の公開リポジトリの最新リリースをインストールします。これには 5 つのスキル（research、ad-from-brand、generate、product-photoshoot、marketing）とgemini extensions install https://github.com/hermoso-ai/hermosoGEMINI.mdコンテキストファイルが含まれます。スキルはnpxを通じてhermosoコマンドを実行するため、Gemini CLI のツール一覧には何も追加されず、コマンドが実行されるまでコンテキストも消費しません。gemini extensions listでは、スキルが Agent skills の下に表示されます。 - 一度サインインします。
ブラウザでのサインインが開き、所有者のみが読める認証情報をnpx -y hermoso auth login~/.hermoso/config.jsonに保存します。Gemini CLI は、Hermoso が初めて必要になったときに、代わりにこれを実行できます。そのマシンにブラウザがない場合は、MCP & CLI → Terminal & API keys でキーを作成し、npx -y hermoso auth login --token hmk_…を実行してください。 - 任意: MCP サーバーも追加する場合。
最初の接続が 401 を返すと、Gemini CLI は Hermoso の認可サーバーを見つけて自分自身を登録するため、gemini mcp add --scope user --transport http hermoso https://app.hermoso.ai/mcpsettings.jsonにキーを書く必要はありません。セッション内で/mcp auth hermosoを実行するとサインインできます。スキルは、これがなくてもすべてのツールに届きます。 - Gemini CLI に何かを頼みます。「競合上位3社の、最も長く配信されている広告を取得して、一番良いフックを9:16の動画にリミックスして」、または「このレンダリングをチャンネルに投稿して」。エージェントがツールを選び、支出はあなたが承認します。
上記のインストールは、2026-09-23 に、クリーンなホームディレクトリで Gemini CLI 0.60.0 を使って実行しました。hermoso-ai/hermoso の最新リリースを取得し、gemini extensions list に 5 つのスキルとコンテキストファイルが表示されました。拡張機能は独自の MCP サーバーを持ちません。これは意図的です。ツール一覧はすべてのセッションに読み込まれますが、スキルは実行されるまで何のコストもかからないからです。Hermoso は Google と提携しておらず、そのように主張することもありません。
続けて、@BotFather から取得したボットトークンを、Hermoso の Settings → Connectors に貼り付けて、Telegram 自体を一度だけ接続してください。そのボットをチャンネルの管理者として追加します。同意画面はありません。トークンが認証情報になり、投稿するのはボットです。
Gemini CLI が使える Telegram のツール
post_to_telegram: 指定したチャットに、ボットとしてメッセージを送信します。テキストは4,096文字まで、または写真1枚、動画1本、写真と動画を混ぜた2〜10件のアルバムを送れます。schedule_post:chatIdを付けて、ほかのすべてのチャネルと同じカレンダーにキューへ入れます。list_telegram_chats: 直近24時間にボットへメッセージを送ったチャットを表示します。ID を探す助けにはなりますが、ボットが参加しているすべてのチャットの一覧ではありません。edit_telegram_message / pin_telegram_message: 閲覧数を失わずにメッセージの本文やキャプションを修正し、CTA を固定または固定解除します。create_telegram_invite_link: キャンペーンごとに名前付きの招待リンクを作成します。有効期限、メンバー数の上限、参加承認を任意で設定でき、どこから誰が参加したかを確認できます。telegram_account: チャットの購読者数またはメンバー数、タイトル、説明、招待リンクを表示します。list_telegram_dms: 直近24時間にボットへ届いたメッセージを新しい順に表示します。post_to_telegramで返信できます。delete_telegram_message: ボットが送ったメッセージを、Telegram の48時間の期限内で、確認の手順を経てから削除します。
Telegram はサインイン画面ではなく、ボットトークンで接続します。Telegram で @BotFather を使ってボットを作成し、トークンを Settings → Connectors に貼り付けてから、そのボットを投稿権限付きの管理者としてチャンネルに追加してください。グループの場合は、投稿できるメンバーとして追加します。Hermoso はそのボットとして投稿し、あなたとしては投稿しません。Telegram 側の制限が2つあり、計画の際に考慮が必要です。ボットは投稿ごとの閲覧数や投稿履歴を取得できないため、購読者数と名前付きの招待リンクが把握できる数字になります。また、ボットに送られたメッセージは24時間で消えます。公開にクレジットはかかりません。
自動化の前に知っておくべき Telegram の上限
| テキスト | Telegram のメッセージは4,096文字までですが、写真や動画を添付すると、テキストがキャプションになるため1,024文字までに制限されます。投稿の作成またはキューへの追加時に適用されるため、文字数オーバーの投稿は、送信途中で黙って切られるのではなく、あなたがその場で修正できるうちに拒否されます。 |
|---|---|
| 公開範囲 | 送信されるか、されないかのどちらかです。下書き、限定公開、非公開の形式はありません。誰が見られるかはチャットで決まります。「非公開のグループやチャンネルに投稿すると、そのメンバーだけが見られます。」silent は通知音なしで届けますが、メッセージを見られる人は変わりません。 |
| カルーセル | アルバムとして2〜10件。写真と動画は混在可能。上限と下限はどちらも Telegram 自身のもので、Bot API の sendMediaGroup（「2〜10件を含める必要があります」）に由来します。混在も同じ仕様です。アルバムには、最初のアイテムに1つだけキャプションが表示されます。Hermoso はリンクを渡す代わりにファイルをアップロードするため、Telegram の上限は写真1枚あたり10MB、動画1本あたり50MB まで引き上げられます。 |
| どのアカウントか | chatId は、すべての投稿で必須です。公開チャンネルの @ユーザー名、または数値 ID を指定します（スーパーグループやチャンネルの ID は -100 で始まります）。Bot API にはボットが参加しているチャットを一覧する方法がないため、Hermoso はそれらを把握できず、推測もしません。 |
Gemini CLI で試す
普通の言葉で頼んでください。これは DSL ではなく、普通の文章です。
「./renders/teaser.mp4 を、1,024 文字以内のキャプション付きで Telegram チャンネル @ourbrand に投稿し、メンバーに通知せずにピン留めしてください。」
この流れは render_ad → post_to_telegram → pin_telegram_message → create_telegram_invite_link です。Gemini CLI はシェルコマンドを実行する前に確認を求め、スキルは hermoso コマンドを通じて動くため、投稿は承認前に読める 1 行として表示されます。MCP ツールの場合は、1 回だけ許可する、そのツールを常に許可する、サーバー全体を常に許可する、のいずれかを選べます。
Telegram での Gemini CLI：要注意の点
呼び出しの前にファイルサイズを確認してください。Hermoso がリンクではなくファイル本体を送る場合でも、Telegram のアップロード動画の上限は 50MB です（リンクの場合の上限は 20MB）。長いレンダリングは、より軽いエンコードが必要になることがあります。ボットは、投稿するチャンネルで「メッセージを投稿」権限を持つ管理者である必要があり、ピン留めには固定の権限も必要です。不足している権限は、Telegram の拒否メッセージに示されます。
Gemini CLI で、この安全性を決める 2 つの詳細があります。gemini mcp add は、--scope user を渡さない限り、プロジェクトの .gemini/settings.json に書き込みます。1 つのリポジトリを常に 1 つのブランドで動かしたい場合は、これが役立ちます。また、Hermoso を --trust 付きで追加しないでください。サーバーに対するすべての確認をスキップしてしまい、公開の前に出る確認も含まれます。MCP ツールは mcp_hermoso_ とツール名を組み合わせた名前で届き、--exclude-tools を使えば、いくつでも完全に除外できます。
投稿の前に Telegram をリサーチする
Hermoso には Telegram の広告ライブラリもチャンネル検索もないため、Telegram での競合リサーチはうたいません。クリエイティブは公開されている場所（Meta、Google、LinkedIn の広告ライブラリや、オーガニックの TikTok、Instagram、YouTube、Reddit、Threads）でリサーチし、完成した広告はここに投稿してください。
有料の側
Hermoso に Telegram の広告はなく、あるかのように示すこともありません。ここでの Telegram は、ご自身が所有し、ボット経由で運営するチャンネルです。投稿、固定、編集、購読者数の計測、招待リンクの追跡ができます。有料ツールは、Meta、Google Ads、Microsoft Advertising、Reddit Ads、LinkedIn、Pinterest、X Ads、TikTok Ads、Snapchat Ads、ChatGPT Ads、Apple Search Ads、AppLovin Ads を対象としています。
Gemini CLI だけではできないこと
予算を持ったエージェントは、被害の範囲が限られていて初めて役に立つので、囲いはプロンプトではなくサーバー側にあります。すべての広告キャンペーン、広告セット、広告グループ、広告は一時停止の状態で作成され、実際のお金を動かす支出の切り替えは、明示的な確認フラグなしでは実行されません。すべてのレンダリングは、まず見積もられます（hermoso_capabilities が、支出の前に各モデルの正確なクレジット費用を公開します）。クレジットは最初のプロバイダー呼び出しの前に確保され、後で正確な費用で精算されるので、送信に失敗しても、何も得られないのに請求されることはありません。削除も確認が必要で、エージェントが何を作ったかを伝える前に、すべてのキャンペーンのツリーは広告プラットフォームから読み戻されます。
ご自身で行っていただく手順が1つだけあります。@BotFather でボットを作成し、チャンネルに追加することです。それ以降はすべてツール呼び出しです。
その他のマトリクス
Gemini CLI から投稿できる先: Facebook · Instagram · Threads · TikTok · YouTube · X · LinkedIn · Pinterest · Bluesky。または Gemini CLI から投稿できるものすべてをご覧ください。
次から Telegram に投稿: Claude · ChatGPT · Claude Code · Cursor · Codex · Cline · OpenClaw · Grok Bot · Hermes · Perplexity · Le Chat · Claude Cowork · Perplexity Computer · Paperclip
よくある質問
Gemini CLI から Telegram に投稿できますか？
はい、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+ のツールを使えるようになります。Telegram への投稿ツールや、市場で配信中の広告をリサーチするツール、そもそもクリエイティブをレンダリングするツールも含まれます。
Telegram を Gemini CLI に接続するには？
手順は 2 つで、それぞれ一度だけです。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 でサインインします。その後、Telegram で @BotFather からボットを作成し、そのトークンを Hermoso の 設定 → コネクター に貼り付けて、ボットをチャンネルに「メッセージを投稿」権限付きの管理者として追加してください。これで Gemini CLI は、毎回チャット名を指定した通常のツール呼び出しとして Telegram に投稿できます。
Gemini CLI から Telegram に非公開や下書きで投稿できますか？
Bot API には下書きや非公開メッセージはありません。Telegram の公開範囲はチャットに属します。非公開のグループやチャンネルに投稿すれば、そのメンバーだけが見られます。Hermoso は、Telegram が対応できない公開範囲を指定された場合、より弱い形で黙って公開するのではなく、その場で拒否します。
Gemini CLI は、投稿の前に Telegram をリサーチできますか？
いいえ。Hermoso には Telegram の広告ライブラリやチャンネル検索はありません。公開広告ライブラリとオーガニックのプラットフォームでクリエイティブをリサーチし、その結果を投稿する場所が Telegram です。
Gemini CLI から投稿するときの Telegram の文字数上限は？
テキストだけの Telegram メッセージは4,096文字までです。写真や動画を添付すると、テキストはキャプションになり、上限は1,024文字です。Hermoso は、どちらの上限が適用されたかを伝えます。投稿の作成またはキューへの追加時に適用するため、Gemini CLI にはすぐに伝わります。誰も見ていないときに後から失敗することはありません。
Gemini CLI で、投稿だけでなく Telegram 広告も運用できますか？
いいえ。Hermoso に Telegram の広告はありません。ここでの Telegram は、ご自身のボットで運営するチャンネルです。投稿、固定、編集、招待リンク、購読者数です。