Cursor から X に投稿

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

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 が認可サーバーに対して動的クライアント登録を行うため、やはりキーを持つ必要はありません。

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

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

Cursor で試す

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

「このブランチのリリースノートから X のスレッドを作成し、すべての投稿を 280 文字以内に収め、リンクは最後の投稿だけに入れて、まず料金を教えてください。」

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

Cursor で X を使うときの注意点

エディタでは、文字数超過の拒否は機能です。Hermoso はアカウントの許容量(通常は 280 文字、X Premium では最大 25,000 文字)を確認し、切り詰めた投稿ではなく、超過分を示す明確なエラーを返します。そのため、修正は文章の編集と再試行で済みます。リンクは1投稿に入れてください。リンクを含む投稿は、リンクのない投稿のおよそ13倍の料金がかかるため、リンクを5回入れた5投稿のスレッドは、その言葉どおりの高い料金になります。

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

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

Cursor だけではできないこと

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

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

その他のマトリクス

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

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

よくある質問

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

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

X を Cursor に接続するにはどうすればよいですか？

手順は2つ、それぞれ一度だけです。npm install -g hermoso && hermoso auth login を実行し、~/.cursor/mcp.json が npx -y hermoso mcp を指すようにします。ブラウザでサインインすると認証情報が保存されるため、ファイルにキーは書かれません。次に Hermoso の 設定 → コネクタ で X を接続します。ブラウザ上の OAuth 同意画面です。以降、Cursor は通常のツール呼び出しとして X に投稿します。

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

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

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

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

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

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

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

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