Hermoso はマーケティング用の MCP サーバーです。922+ のツールを一つの OAuth 対応エンドポイントで提供し、エージェントが市場で既に配信されている広告をリサーチし、完成した画像と動画の広告を生成し、それらを投稿し、その背後にある有料キャンペーンを作れるようにします。Claude Code は一つの接続からこれらすべてを使えます。このページでは、その中の一部を扱います。Claude Code が Instagram で実際に何をできて、Instagram が何をさせないかです。
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 の 設定 → コネクタ で Instagram 自体を一度接続してください。これはブラウザでの OAuth 同意画面なので、唯一ブラウザが必要な手順です。そのあとはすべてツール呼び出しです。
Claude Code が使える Instagram のツール
post_to_meta：target: "instagram"を指定して Instagram に公開します。Instagram はビジュアルのチャンネルで、API もそれを前提にしています。投稿には画像か動画が必要です。schedule_post：共有カレンダーにキューします。キャプションを Facebook や LinkedIn 版と変えたい場合は、チャンネルごとに付けられます。list_meta_comments / reply_to_meta_comment / moderate_meta_comment：投稿へのコメントを読み、返信し、管理します。meta_page_insights / meta_post_insights：アカウント単位と投稿単位のリーチ、インプレッション、保存、エンゲージメント。search_instagram：公開された Instagram のリールをキーワードで検索します。公開ではなくリサーチのためのものです。
自動化の前に知っておきたい Instagram の事実が二つあります。Meta の API にはInstagram のネイティブな予約機能はありません。そのため、予約は Instagram のものではなく Hermoso のキューになり、Instagram に対して Facebook の scheduleAt を渡すと、黙って今すぐ投稿するのではなく拒否されます。また、公開後の Instagram のキャプションは編集できません。Meta が公開済みの投稿で変更を許すのは、コメントを有効にするかどうかだけです。投稿の削除は可能です。manage_meta_post は、通常の投稿、ストーリーズ、リール、カルーセルのアルバム全体を削除できますが、アルバムの中の一枚だけを削除することはできません。
自動化の前に知っておくべき Instagram の上限
| テキスト | Instagram のキャプションは2,200文字が上限です。投稿の作成またはキューに入れる時点で適用されるので、上限を超えた投稿は、黙って途中で切られるのではなく、あなたがまだそこにいるうちに拒否され、修正できます。 |
|---|---|
| 公開範囲 | 公開のみ。Meta のコンテンツ公開 API は即時に公開するか、まったく公開しないかのどちらかで、Instagram には「限定公開、非公開、下書きの投稿はない」とされています。Instagram でレビューの工程が必要なら、呼び出しの後ではなく、前に行う必要があります。 |
| カルーセル | 2〜10枚のスライド、画像と動画は混在可能。上限の10は Meta 自身のもので、それが適用する対応表に引用されています。「カルーセルは、画像、動画、またはその両方の混在で最大10件までです」。下限の2は当社のもので、どのプラットフォームでも1枚のスライドはカルーセルではないからです。1枚のリクエストは、拒否されるのではなく、通常の投稿として公開されます。 |
| どのアカウントか | pageId。Instagram は接続された Facebook ページを通して公開するので、同じ識別フィールドで選びます。 |
Claude Code で試す
普通の言葉で頼んでください。これは DSL ではなく、普通の文章です。
「./assets/slides から5枚スライドのカルーセルを作り、それぞれが Instagram の上限内に収まるか確認して、公開し、パーマリンクをリリースノートに保存してください。」
流れは search_instagram → plan_ad → render_ad → post_to_meta（target: "instagram"）です。Claude Code はツールを実行する前に確認を求めます。やり取りはターミナルにそのまま残るため、公開の手順は、y を押す前に読める1行です。
Instagram での Claude Code：要注意の点
Instagram のキャプションは、投稿が公開された後には編集できません。そのため、謝罪ではなく検証をスクリプトに組み込んでください。Claude Code にスライドの順序とキャプションを表示させ、そのうえで初めて公開ツールを呼び出すようにします。レンダリングが不適切だった場合は、manage_meta_post でアルバムを含む投稿全体を削除できます。順序は想像以上に重要です。スライド2はスライド1の後に続く必要があり、Hermoso は渡された順序をそのまま保持します。
プラグインにはツールのマニフェストがありません。これは、長時間の無人実行で特に重要です。エージェントは工程ごとに hermoso コマンドをシェルから呼び出し、どのコマンドにも付けられる --json によって、検証可能な機械向けの出力を得ます。
投稿の前に Instagram をリサーチする
search_meta_ads は一つのライブラリなので、Facebook に加えて Instagram の配置も対象にします。オーガニックについては、search_instagram が公開リールをキーワードで検索します。これは形式が実際に動いている面です。プロフィールとハッシュタグの取得は fetch_social_data と search_instagram_hashtag を通します。
有料の側
Instagram の配置は、Facebook と同じ Meta のキャンペーンツリーを通して購入します。create_meta_campaign → create_meta_adset → create_meta_ad。配置はプラットフォームと位置ごとに選べます。preview_meta_ad は、支出の前に配置ごとの実際にレンダリングされた広告を表示し、meta_insights は結果を年齢、性別、配置、国別に分けます。その内訳が次のクリエイティブを形作ります。
Claude Code だけではできないこと
予算を持ったエージェントは、被害の範囲が限られていて初めて役に立つので、囲いはプロンプトではなくサーバー側にあります。すべての広告キャンペーン、広告セット、広告グループ、広告は一時停止の状態で作成され、実際のお金を動かす支出の切り替えは、明示的な確認フラグなしでは実行されません。すべてのレンダリングは、まず見積もられます（hermoso_capabilities が、支出の前に各モデルの正確なクレジット費用を公開します）。クレジットは最初のプロバイダー呼び出しの前に確保され、後で正確な費用で精算されるので、送信に失敗しても、何も得られないのに請求されることはありません。削除も確認が必要で、エージェントが何を作ったかを伝える前に、すべてのキャンペーンのツリーは広告プラットフォームから読み戻されます。
あえて完全なヘッドレスにしていない手順が一つあります。アカウントの接続は OAuth の同意画面なので、ブラウザでチャンネルを一度接続します。そのあとはすべてツール呼び出しです。
その他のマトリクス
Claude Code から投稿: Facebook · Threads · TikTok · YouTube · X · LinkedIn · Pinterest · Bluesky · Telegram。または Claude Code から公開できるすべてをご覧ください。
Instagram への投稿元: Claude · ChatGPT · Cursor · Codex · Cline · OpenClaw · Grok Bot · Hermes · Gemini CLI · Perplexity · Le Chat · Claude Cowork · Perplexity Computer · Paperclip · Claude Code のマーケティング
よくある質問
Claude Code から Instagram に投稿できますか？
はい。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+ 個のツールを使えるようになります。Instagram に投稿するツールのほか、市場で配信中の広告をリサーチするツールや、そもそもクリエイティブを生成するツールも含まれます。
Instagram を 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 の Settings → Connectors で Instagram を接続します。ブラウザで OAuth の同意画面が開きます。その後は、Claude Code が通常のツール呼び出しとして Instagram に投稿します。
Claude Code に Instagram のパスワードを渡す必要がありますか？
いいえ。Instagram は、ブラウザでの OAuth 同意画面を通して一度だけ Hermoso に接続します。その後、Claude Code はツール呼び出しとしてそれを使います。アカウントの接続は唯一ヘッドレスではない手順で、それ以降はパスワードは不要で、認証情報がモデルに渡されることは一切ありません。
Claude Code で Instagram の投稿を後から予約できますか？
はい。schedule_post は、他のすべてのチャンネルと共有する一つのカレンダーに投稿を入れます。キャプションを変えたい場合は、チャンネルごとに付けられます。list_scheduled と cancel_scheduled で読み取りと取り消しができます。Instagram は、キューに入る十一チャンネルの一つです。
Claude Code で Instagram にカルーセルを投稿できますか？
はい。スライドは2〜10枚で、画像と動画を混ぜられます。上限の十枚は Meta 自身が公表しているもので、Hermoso が作ったものではありません。Claude Code はどちらの場合も同じ公開ツールを呼び出し、カルーセルを載せられないチャンネルは、本当の理由を添えて拒否されます。
Claude Code から Instagram に投稿するのにコストはかかりますか？
Instagram への投稿にはクレジットがかかりません。Meta は API 呼び出しごとに料金を取らないためです。クレジットはレンダリング自体にかかります。プランは月額 $29、$69、$149 で、それぞれ 1,200、3,000、7,000 クレジットです。すべての機能が Free を含むすべてのプランに含まれます。例外はエンタープライズ向けの SSO だけです。