Hermoso はマーケティング用の MCP サーバーで、1つの OAuth 対応エンドポイント経由で 922+ 個のツールを提供します。エージェントは、市場で配信中の広告を調べ、完成した画像と動画の広告を作って公開し、その裏で動く有料キャンペーンも構築できます。Claude Code はこのすべてを1つの接続で利用します。このページでは、その一部として、Claude Code が X で実際に何をできるか、そして X が何を許さないかを説明します。
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 サーバーは、同じツールと同じアカウントを利用します。違いはコンテキストです。ツール一覧は、入力する前にすべてのセッションに読み込まれますが、スキルはコマンドが実行されるまで何のコストもかかりません。
続けて、Hermoso の Settings → Connectors で X 自体を一度だけ接続してください。これは OAuth の同意画面なので、ブラウザでの操作が必要な唯一の手順です。それ以降はすべてツール呼び出しです。
Claude Code が使える 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 の制限
| テキスト | 文字数は投稿アカウントの上限に従います。通常は280文字、X Premium では最大25,000文字です。Hermoso は X からサブスクリプションを読み取るため、長い投稿も全文が投稿されます。何も切り詰められることはありません。上限は投稿の作成またはキューへの追加時に適用されます。そのため、文字数オーバーの投稿は、送信途中で黙って切られるのではなく、あなたがその場で修正できるうちに拒否されます。 |
|---|---|
| 公開範囲 | 公開のみ。X の投稿は、存在した瞬間から公開されます。API には下書きも限定公開の投稿もありません。鍵付きアカウントは存在しますが、これはアカウント全体の設定で、Hermoso は読み取りも制御もしません。投稿ごとに選べるものではありません。 |
| カルーセル | 理由を明記して拒否します。「X にはスワイプできるカルーセルがありません。」 API は1投稿に最大4つのメディアを付けられ、グリッド状に表示されます。すべての画像が一度に見え、スワイプできる部分がありません。そのため、番号付きの「1/6 · SWIPE」スライドデッキは、意図どおりには投稿できません。拒否の理由には、代わりの方法も示されます。「最も強いスライド1枚を X に投稿するか、この投稿から X を外してください。」 読者にスワイプを促すデッキをグリッドで公開するのは、公開しないよりも悪い結果になります。 |
| どのアカウントか | なし。X は接続されたアカウントに投稿します。 |
Claude Code で試す
普通の言葉で頼んでください。これは DSL ではなく、普通の文章です。
「./notes/launch.md を、5投稿以内の X スレッドにしてください。リンクは最後の投稿だけに入れ、投稿する前に料金を教えてください。」
これは get_brand → generate_text → post_to_x → x_post_insights_historical の流れです。Claude Code はツールを実行する前に確認を求め、やり取りはターミナルに残るため、投稿の手順は y を押す前に目で確認できます。
Claude Code で X を使うときの注意点
リンクは5投稿すべてではなく1投稿に入れてください。リンクを含む投稿は、リンクなしの投稿のおよそ13倍の料金になるため、すべての投稿にリンクを入れるスレッドは最も高くつく形です。リンク検出は、リンクがあると想定する側に寄せて設計されています。文字数オーバーの文章は切り詰めずに拒否され、超過分も数えられます。スクリプトでは、投稿が途中で止まるのではなく、対処できる明確な失敗として返ります。
プラグインにはツールのマニフェストがありません。これは、長時間の無人実行で特に重要です。エージェントは工程ごとに hermoso コマンドをシェルから呼び出し、どのコマンドにも付けられる --json によって、検証可能な機械向けの出力を得ます。
投稿前に 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 が付与した権限レベルとともに表示されます。
Claude Code だけではできないこと
予算を持ったエージェントは、被害の範囲が限られていて初めて役に立つので、囲いはプロンプトではなくサーバー側にあります。すべての広告キャンペーン、広告セット、広告グループ、広告は一時停止の状態で作成され、実際のお金を動かす支出の切り替えは、明示的な確認フラグなしでは実行されません。すべてのレンダリングは、まず見積もられます（hermoso_capabilities が、支出の前に各モデルの正確なクレジット費用を公開します）。クレジットは最初のプロバイダー呼び出しの前に確保され、後で正確な費用で精算されるので、送信に失敗しても、何も得られないのに請求されることはありません。削除も確認が必要で、エージェントが何を作ったかを伝える前に、すべてのキャンペーンのツリーは広告プラットフォームから読み戻されます。
あえて完全なヘッドレスにしていない手順が一つあります。アカウントの接続は OAuth の同意画面なので、ブラウザでチャンネルを一度接続します。そのあとはすべてツール呼び出しです。
その他のマトリクス
Claude Code から投稿できる先: Facebook · Instagram · Threads · TikTok · YouTube · LinkedIn · Pinterest · Bluesky · Telegram。または Claude Code から投稿できるすべての先をご覧ください。
X への投稿元: Claude · ChatGPT · Cursor · Codex · Cline · OpenClaw · Grok Bot · Hermes · Gemini CLI · Perplexity · Le Chat · Claude Cowork · Perplexity Computer · Paperclip · Claude Code マーケティング
よくある質問
Claude Code から X に投稿できますか？
はい、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 以上のツールが使えます。X に投稿するツールや、市場で配信中の広告を調べるツール、クリエイティブを作成するツールも含まれます。
X を 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 で一度サインインします。ブラウザが開き、認証情報は自動で保存されるため、キーの作成も貼り付けも不要です。次に Hermoso の 設定 → コネクタ で X を接続します。ブラウザ上の OAuth 同意画面です。以降、Claude Code は通常のツール呼び出しとして X に投稿します。
Claude Code に X のパスワードは必要ですか？
いいえ。X の接続は、ブラウザの OAuth 同意画面で Hermoso と一度だけ行います。その後、Claude Code はツール呼び出しで X を利用します。アカウントの連携だけはブラウザでの操作が必要で、それ以降はパスワードが不要です。認証情報がモデルに渡されることもありません。
Claude Code で X の投稿を後日の予約にできますか？
はい。schedule_post は、他のすべてのチャネルと共有の1つのカレンダーに投稿を予約します。文面を変えたい場合は、チャネルごとのキャプションも設定できます。list_scheduled と cancel_scheduled で予約を確認し、取り消せます。X は、予約に対応する11チャネルのひとつです。
Claude Code で X にカルーセル投稿できますか？
いいえ。X の API は1投稿に最大4つのメディアを添付でき、それらはグリッド状に表示されます。すべての画像が一度に見え、スワイプできる部分はありません。そのため、番号付きのスライドデッキを意図どおりに投稿することはできません。Claude Code はどちらの場合も同じ投稿ツールを呼び出します。カルーセルを扱えないチャネルには、その理由を添えて拒否されます。
Claude Code から X に投稿するといくらかかりますか？
X は、呼び出しごとにクレジットを消費する唯一のコネクタです。X が API リクエストごとに課金するためです。目安は、投稿が $0.015、リンクを含む投稿が $0.200 で、約13倍になります。エージェントは投稿の前に料金を提示されます。プランは月額 $29、$69、$149 で、それぞれ 1,200、3,000、7,000 クレジットです。すべての機能は Free プランを含む全プランで使えます。例外はエンタープライズ SSO だけです。