Hermoso はマーケティング用の MCP サーバーです。922+ のツールを一つの OAuth 対応エンドポイントで提供し、エージェントが市場で既に配信されている広告をリサーチし、完成した画像と動画の広告を生成し、それらを投稿し、その背後にある有料キャンペーンを作れるようにします。Claude Code は一つの接続からこれらすべてを使えます。このページでは、その中の一部を扱います。Claude Code が Telegram で実際に何をできて、Telegram が何をさせないかです。
Hermoso を Claude Code に接続する
- コマンドは1つで、キーは不要です。
すでにセッション内にいる場合は、claude plugin marketplace add hermoso-ai/hermoso && claude plugin install hermoso@hermoso/plugin marketplace add hermoso-ai/hermosoを入力し、続けて/plugin install hermoso@hermosoを入力します。インストールされるのは Hermoso のスキル5つ（research、ad-from-brand、generate、product-photoshoot、marketing）で、npx経由でhermosoコマンドを実行します。そのため、ツール一覧がセッションに読み込まれることはなく、実行されるまでコンテキストを消費しません。 - 一度だけサインインします。
ループバック経由でブラウザのサインイン画面が開きます。これはnpx -y hermoso auth loginghと同じ仕組みです。認証情報は所有者だけが読める形で~/.hermoso/config.jsonに保存されます。Claude Code は、Hermoso が必要になった最初の時点で、これを代わりに実行します。CI、リモートのマシン、コンテナなど、そのマシンにブラウザがない場合は、MCP & CLI → Terminal & API keys でキーを作成し、npx -y hermoso auth login --token hmk_…を実行してください。キーには実際の支出の権限があるため、パスワードと同じように扱ってください。 - 任意：MCP サーバーも追加する。Hermoso のツールを Claude Code 自身のツール一覧にも入れたい場合は、サインイン後に
claude mcp add hermoso -- npx -y hermoso mcpを実行してください。同じ保存済みの認証情報を読むため、.claude.jsonにキーが入ることはありません。MCP を追加しなくても、スキルからすべてのツールを使えます。 - Claude Code に何かを頼みます。「競合上位3社の、最も長く配信されている広告を取得して、一番良いフックを9:16の動画にリミックスして」、または「このレンダリングをチャンネルに投稿して」。エージェントがツールを選び、支出はあなたが承認します。
プラグインとオプションの MCP サーバーは、同じツールと同じアカウントを利用します。違いはコンテキストです。ツール一覧は、入力する前にすべてのセッションに読み込まれますが、スキルはコマンドが実行されるまで何のコストもかかりません。
続けて、@BotFather から取得したボットトークンを、Hermoso の Settings → Connectors に貼り付けて、Telegram 自体を一度だけ接続してください。そのボットをチャンネルの管理者として追加します。同意画面はありません。トークンが認証情報になり、投稿するのはボットです。
Claude Code が使える 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 はそれらを把握できず、推測もしません。 |
Claude Code で試す
普通の言葉で頼んでください。これは DSL ではなく、普通の文章です。
「./out/launch の4枚の画像を、./copy/tg.txt のキャプションを付けて、チャット -1001234567890 に1つの Telegram アルバムとして送り、メッセージ ID を記録してください。」
これは render_ad → post_to_telegram → pin_telegram_message → create_telegram_invite_link の流れです。Claude Code はツールを実行する前に確認を求め、やり取りはターミナルに残るため、投稿の手順は y を押す前に目で確認できます。
Telegram での Claude Code：要注意の点
テキストの上限は2つあり、メディアを添付すると厳しい方が適用されます。テキストのみのメッセージは 4,096 文字、キャプションは 1,024 文字です。アルバムではキャプションは最初の項目に1つだけ表示されます。Hermoso はリンクを渡すのではなくファイルをアップロードするため、写真は1枚 10MB、動画は 50MB まで上げられます。メッセージ ID は保存してください。編集と削除の両方に必要で、Telegram はボットが後からそれを調べる手段を提供していません。
プラグインにはツールのマニフェストがありません。これは、長時間の無人実行で特に重要です。エージェントは工程ごとに hermoso コマンドをシェルから呼び出し、どのコマンドにも付けられる --json によって、検証可能な機械向けの出力を得ます。
投稿の前に 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 を対象としています。
Claude Code だけではできないこと
予算を持ったエージェントは、被害の範囲が限られていて初めて役に立つので、囲いはプロンプトではなくサーバー側にあります。すべての広告キャンペーン、広告セット、広告グループ、広告は一時停止の状態で作成され、実際のお金を動かす支出の切り替えは、明示的な確認フラグなしでは実行されません。すべてのレンダリングは、まず見積もられます（hermoso_capabilities が、支出の前に各モデルの正確なクレジット費用を公開します）。クレジットは最初のプロバイダー呼び出しの前に確保され、後で正確な費用で精算されるので、送信に失敗しても、何も得られないのに請求されることはありません。削除も確認が必要で、エージェントが何を作ったかを伝える前に、すべてのキャンペーンのツリーは広告プラットフォームから読み戻されます。
ご自身で行っていただく手順が1つだけあります。@BotFather でボットを作成し、チャンネルに追加することです。それ以降はすべてツール呼び出しです。
その他のマトリクス
Claude Code から投稿できる先: Facebook · Instagram · Threads · TikTok · YouTube · X · LinkedIn · Pinterest · Bluesky。または Claude Code から投稿できるすべての先をご覧ください。
Telegram への投稿元: Claude · ChatGPT · Cursor · Codex · Cline · OpenClaw · Grok Bot · Hermes · Gemini CLI · Perplexity · Le Chat · Claude Cowork · Perplexity Computer · Paperclip · Claude Code マーケティング
よくある質問
Claude Code から Telegram に投稿できますか？
はい。Hermoso の Claude Code プラグインを使います。コマンドは1つです。claude plugin marketplace add hermoso-ai/hermoso && claude plugin install hermoso@hermoso。セッション内では、/plugin marketplace add hermoso-ai/hermoso に続けて /plugin install hermoso@hermoso を実行します。インストールされるのは、hermoso CLI を動かす Hermoso のスキル5つです。そのため、ツール一覧がセッションに読み込まれることはありません。npx -y hermoso auth login で一度サインインしてください。ブラウザが開き、認証情報は自動で保存されるため、作成するキーも貼り付けるキーもありません。その後、Claude Code は 922+ 個のツールを使えるようになります。Telegram に投稿するツールのほか、市場で配信中の広告をリサーチするツールや、そもそもクリエイティブを生成するツールも含まれます。
Telegram を Claude Code に接続するには？
手順は2つ、それぞれ一度だけです。コマンドは1つ: claude plugin marketplace add hermoso-ai/hermoso && claude plugin install hermoso@hermoso、またはセッション内で /plugin marketplace add hermoso-ai/hermoso の後に /plugin install hermoso@hermoso。hermoso CLI を操作する Hermoso のスキル5つがインストールされるため、セッションにツール一覧は読み込まれません。npx -y hermoso auth login で一度サインインします。ブラウザが開き、認証情報は自動で保存されるため、キーの作成も貼り付けも不要です。次に Telegram で @BotFather からボットを作成し、そのトークンを Hermoso の 設定 → コネクタ に貼り付けます。さらに、ボットをチャンネルに管理者として追加し、「メッセージの投稿」権限を与えてください。以降、Claude Code は毎回どのチャットに投稿するかを指定しながら、通常のツール呼び出しとして Telegram に投稿します。
Claude Code に Telegram のパスワードを渡す必要がありますか？
いいえ。Telegram は @BotFather で作成したボット経由で接続し、Hermoso が保持するのはそのボットのトークンだけです。そのため Claude Code はボットとして投稿し、ご自身の個人の Telegram アカウントとして投稿することはありません。トークンはいつでも @BotFather で取り消せます。また、モデルに渡されることはありません。
Claude Code で Telegram の投稿を後から予約できますか？
はい。schedule_post は、他のすべてのチャンネルと共有する一つのカレンダーに投稿を入れます。キャプションを変えたい場合は、チャンネルごとに付けられます。list_scheduled と cancel_scheduled で読み取りと取り消しができます。Telegram は、キューに入る十一チャンネルの一つです。
Claude Code で Telegram にカルーセルを投稿できますか？
はい。写真と動画を混ぜた2〜10件のアルバムとして可能です。これは sendMediaGroup に関する Telegram 自身のルールです。アルバムのキャプションは、最初のアイテムに1つだけ付きます。Claude Code はどちらの場合も同じ公開ツールを呼び出し、カルーセルを扱えないチャネルには、その理由を添えて拒否されます。
Claude Code から Telegram に投稿するのにコストはかかりますか？
Telegram への投稿にクレジットはかかりません。Telegram は呼び出しごとの料金がないためです。クレジットを使うのはクリエイティブの生成時です。プランは月額 $29、$69、$149 で、それぞれ 1,200、3,000、7,000 クレジットです。すべての機能は Free プランを含む全プランで使えます。例外はエンタープライズ SSO だけです。