Cursor から Telegram に投稿

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

Hermoso を Cursor に接続する

1. インストールとサインイン。

   npm install -g hermoso && hermoso auth login

   ブラウザが1回開きます。作成も貼り付けも不要です。認証情報は所有者のみが読める形で ~/.hermoso/config.json に保存されます。ブラウザのないマシンでは、MCP & CLI → Terminal & API keys で作成したキーを hermoso auth login --token hmk_… で渡してください。
2. ~/.cursor/mcp.json に追加(またはプロジェクトの .cursor/mcp.json)。hermoso mcp は上で行ったサインインを読み込むため、ファイルにキーは書きません:

   { "mcpServers": { "hermoso": { "command": "npx", "args": ["-y", "hermoso", "mcp"] } } }

3. またはワンクリックインストールは MCP のページから行えます。このディープリンクは、ホストされた URL をインストールし、認証は Cursor 自身の OAuth フローに任せます。どちらも使えますが、前提条件が異なります。
4. Cursor に何かを頼みます。「競合上位3社の、最も長く配信されている広告を取得して、一番良いフックを9:16の動画にリミックスして」、または「このレンダリングをチャンネルに投稿して」。エージェントがツールを選び、支出はあなたが承認します。

上のブロックは、公開済みの hermoso npm パッケージをマシン上で実行します。そのためキーを貼り付ける必要はなく、ツールを呼び出すまではツール一覧のコストもかかりません。代わりにディープリンクを使う場合は、Cursor が認可サーバーに対して動的クライアント登録を行うため、やはりキーを持つ必要はありません。

続けて、@BotFather から取得したボットトークンを、Hermoso の Settings → Connectors に貼り付けて、Telegram 自体を一度だけ接続してください。そのボットをチャンネルの管理者として追加します。同意画面はありません。トークンが認証情報になり、投稿するのはボットです。

Cursor が使える 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 の上限

Cursor で試す

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

「CHANGELOG.md のリリースノートを、リンクプレビューをオフにしたテキストメッセージとして Telegram チャンネルに投稿し、その後、通知なしで固定してください。」

これは render_ad → post_to_telegram → pin_telegram_message → create_telegram_invite_link の流れです。Cursor は各ツール呼び出しを、実行前にコンポーザーに表示します。そのため、投稿は偶然起きる副作用ではなく、クリック1回の操作になります。

Telegram での Cursor：要注意の点

固定はデフォルトで通知が出ないため、お知らせを固定しても全メンバーに通知は飛びません。通知を出したい場合は依頼してください。ボットには、管理者として固定の権限が必要です。テキストのみの投稿では、リンクプレビューは Telegram の既定の動作で、オフにできます。変更履歴に5つのリンクがあり、最初のリンクのプレビューがメッセージを占めてしまうような場合は、オフにする価値があります。

特定のブランドに常に紐づけたいリポジトリでは、ホームディレクトリではなくプロジェクトの .cursor/mcp.json に設定を置いてください。そうしないと、hermoso auth login が使うワークスペースが固定されません。

投稿の前に 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 を対象としています。

Cursor だけではできないこと

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

ご自身で行っていただく手順が1つだけあります。@BotFather でボットを作成し、チャンネルに追加することです。それ以降はすべてツール呼び出しです。

その他のマトリクス

Cursor からの投稿先: Facebook · Instagram · Threads · TikTok · YouTube · X · LinkedIn · Pinterest · Bluesky。または Cursor から投稿できるすべての先をご覧ください。

Telegram への投稿元: Claude · ChatGPT · Claude Code · Codex · Cline · OpenClaw · Grok Bot · Hermes · Gemini CLI · Perplexity · Le Chat · Claude Cowork · Perplexity Computer · Paperclip

よくある質問

Cursor から Telegram に投稿できますか？

はい、Hermoso の MCP サーバー経由で可能です。npm install -g hermoso && hermoso auth login を実行し、~/.cursor/mcp.json が npx -y hermoso mcp を指すようにします。ブラウザでサインインすると認証情報が保存されるため、ファイルにキーは書かれません。その後、Cursor では 922 以上のツールが使えます。Telegram に投稿するツールや、市場で配信中の広告を調べるツール、クリエイティブを作成するツールも含まれます。

Telegram を Cursor に接続するには？

手順は2つ、それぞれ一度だけです。npm install -g hermoso && hermoso auth login を実行し、~/.cursor/mcp.json が npx -y hermoso mcp を指すようにします。ブラウザでサインインすると認証情報が保存されるため、ファイルにキーは書かれません。次に Telegram で @BotFather からボットを作成し、そのトークンを Hermoso の 設定 → コネクタ に貼り付けます。さらに、ボットをチャンネルに管理者として追加し、「メッセージの投稿」権限を与えてください。以降、Cursor は毎回どのチャットに投稿するかを指定しながら、通常のツール呼び出しとして Telegram に投稿します。

Cursor から投稿するときの Telegram の文字数上限は？

テキストだけの Telegram メッセージは4,096文字までです。写真や動画を添付すると、テキストはキャプションになり、上限は1,024文字です。Hermoso は、どちらの上限が適用されたかを伝えます。投稿の作成またはキューへの追加時に適用するため、Cursor にはすぐに伝わります。誰も見ていないときに後から失敗することはありません。

Cursor で、投稿だけでなく Telegram 広告も運用できますか？

いいえ。Hermoso に Telegram の広告はありません。ここでの Telegram は、ご自身のボットで運営するチャンネルです。投稿、固定、編集、招待リンク、購読者数です。

Cursor から Telegram に非公開や下書きで投稿できますか？

Bot API には下書きや非公開メッセージはありません。Telegram の公開範囲はチャットに属します。非公開のグループやチャンネルに投稿すれば、そのメンバーだけが見られます。Hermoso は、Telegram が対応できない公開範囲を指定された場合、より弱い形で黙って公開するのではなく、その場で拒否します。

Cursor は、投稿の前に Telegram をリサーチできますか？

いいえ。Hermoso には Telegram の広告ライブラリやチャンネル検索はありません。公開広告ライブラリとオーガニックのプラットフォームでクリエイティブをリサーチし、その結果を投稿する場所が Telegram です。