Hermoso はマーケティング用の MCP サーバーです。922+ のツールを一つの OAuth 対応エンドポイントで提供し、エージェントが市場で既に配信されている広告をリサーチし、完成した画像と動画の広告を生成し、それらを投稿し、その背後にある有料キャンペーンを作れるようにします。Claude Code は一つの接続からこれらすべてを使えます。このページでは、その中の一部を扱います。Claude Code が Bluesky で実際に何をできて、Bluesky が何をさせないかです。
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 で、ハンドルと Bluesky の アプリパスワード を使い、Bluesky 自体を一度だけ接続してください。同意画面はありません。アプリパスワードは Bluesky の設定で作成し、本来のパスワードに触れることなく、そこで取り消せます。
Claude Code が使える Bluesky のツール
post_to_bluesky: 接続したアカウントとして投稿を公開します。300文字まで、代替テキスト付きの画像を最大4枚、または任意のキャプショントラック付きの MP4 動画1本を添付できます。メディアのないリンクには、プレビューカードが付きます。Bluesky はプレビューを取得しないため、Hermoso が作成します。schedule_post: ほかのすべてのチャネルと共有のカレンダーに投稿をキューへ入れます。300文字の上限は、発火時ではなくキューへ入れる時点で確認されます。list_bluesky_posts: アカウント自身の最近の投稿を、AT-URI と最新の数値とともに表示します。リポストには印が付くため、他人の投稿を自分の投稿として扱うことはありません。bluesky_post_metrics / bluesky_account: 投稿ごとのいいね、リポスト、返信、引用、ブックマーク数と、ご自身のアカウントまたは任意の公開アカウントのフォロワー数、フォロー数、投稿数を表示します。list_bluesky_convos / read_bluesky_dm / send_bluesky_dm: ダイレクトメッセージを読み、返信します。フォローしていない相手からのメッセージリクエストも含みます。manage_bluesky_convo / react_to_bluesky_dm / mark_bluesky_convo_read: リクエストを承認し、会話をミュート、ロック、または退出します。絵文字で1つリアクションし、未読数をクリアします。delete_bluesky_post: 投稿を削除します。最初の呼び出しでは何も削除せず、削除される内容を読み返して確認します。
Bluesky はサインイン画面ではなく、アプリパスワードで接続します。Bluesky の設定でパスワードを作成し、ハンドルとともに Settings → Connectors に貼り付けてください。作成時にダイレクトメッセージへのアクセスにチェックを入れてください。入れないと、DM ツールはパスワードではチャットできないと表示します。これは接続の不具合ではなく、パスワードの性質によるものです。Hermoso が送信前に確認するルールがほかに2つあります。動画には Bluesky アカウントでメールアドレスの確認が済んでいる必要があること、リンクカードと画像は同じ投稿に添付できないことです。公開にクレジットはかかりません。Bluesky は呼び出しごとの料金がないためです。
自動化の前に知っておくべき Bluesky の上限
| テキスト | Bluesky の投稿は300文字に加えて、3,000バイトが上限です。そのため、絵文字の多い投稿は300文字未満でも長すぎる場合があります。投稿の作成またはキューへの追加時に適用されるため、文字数オーバーの投稿は、送信途中で黙って切られるのではなく、あなたがその場で修正できるうちに拒否されます。 |
|---|---|
| 公開範囲 | 公開のみ。Bluesky の投稿は AT Protocol 上の公開記録で、限定公開、非公開、下書きの形式はありません。確認は呼び出しの前に行い、後から行うことはありません。 |
| カルーセル | 2〜4枚の画像のみ。4という数字は、画像埋め込みの AT Protocol レキシコンに基づく Bluesky 自身の上限です。5枚目は黙って落とされるのではなく、拒否されます。動画は1本のクリップだけを含む別の埋め込みで、投稿が持てる埋め込みは1つだけです。そのため Bluesky の投稿は、画像、動画1本、リンクカードのいずれか1種類になります。 |
| どのアカウントか | ブランドが Bluesky アカウントを複数接続していない限り、必要ありません。複数接続している場合は account でどれかを指定します。指定せずに複数ある場合は、推測されるのではなく、その旨を明記して拒否されます。 |
Claude Code で試す
普通の言葉で頼んでください。これは DSL ではなく、普通の文章です。
「./notes/bluesky.txt のリリースノートを、./assets の2枚のスクリーンショット(代替テキスト付き)と一緒に Bluesky に投稿し、投稿の AT-URI を ./out/posts.log に追記してください。」
これは get_brand → generate_image → post_to_bluesky → bluesky_post_metrics の流れです。Claude Code はツールを実行する前に確認を求め、やり取りはターミナルに残るため、投稿の手順は y を押す前に目で確認できます。
Bluesky での Claude Code：要注意の点
AT-URI は必ず保存してください。bluesky_post_metrics と delete_bluesky_post はどちらも、bsky.app のリンクではなく at:// の URI で投稿を指定します。Web の URL だけを保存したスクリプトは、list_bluesky_posts を経由して投稿を探し直す必要があります。後から読み取れる数値は件数のみです。いいね、リポスト、返信、引用、ブックマークです。Bluesky はプロトコル上インプレッション数を公開していないため、エンゲージメント率を計算することはできません。それを表示するレポートがあれば、その数値は作り物です。
プラグインにはツールのマニフェストがありません。これは、長時間の無人実行で特に重要です。エージェントは工程ごとに hermoso コマンドをシェルから呼び出し、どのコマンドにも付けられる --json によって、検証可能な機械向けの出力を得ます。
投稿の前に Bluesky をリサーチする
Hermoso には Bluesky の広告ライブラリも Bluesky 検索もないため、そこでの競合リサーチは1つの率直な方法に限られます。bluesky_account で、任意の公開アカウントのフォロワー数、フォロー数、投稿数を読み取れます。競合の規模を把握し、週ごとの推移を追うには十分です。リサーチ機能のそのほかの部分（Meta、Google、LinkedIn の広告ライブラリ、オーガニックの TikTok、Instagram、YouTube、Reddit、Threads）はそのまま使えます。
有料の側
Hermoso に Bluesky の広告商品はなく、あるかのように示すこともありません。ここでの Bluesky はオーガニックです。公開、予約、読み取り、返信、計測ができます。有料ツールは、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つだけあります。Bluesky のアプリパスワードを作成し、一度接続することです。それ以降はすべてツール呼び出しです。
その他のマトリクス
Claude Code から投稿できる先: Facebook · Instagram · Threads · TikTok · YouTube · X · LinkedIn · Pinterest · Telegram。または Claude Code から投稿できるすべての先をご覧ください。
Bluesky への投稿元: Claude · ChatGPT · Cursor · Codex · Cline · OpenClaw · Grok Bot · Hermes · Gemini CLI · Perplexity · Le Chat · Claude Cowork · Perplexity Computer · Paperclip · Claude Code マーケティング
よくある質問
Claude Code から Bluesky に投稿できますか？
はい。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+ 個のツールを使えるようになります。Bluesky に投稿するツールのほか、市場で配信中の広告をリサーチするツールや、そもそもクリエイティブを生成するツールも含まれます。
Bluesky を 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 で一度サインインします。ブラウザが開き、認証情報は自動で保存されるため、キーの作成も貼り付けも不要です。次に Bluesky の設定でアプリパスワードを作成し(DM ツールを使う場合は、DM へのアクセスにチェックを入れてください)、ハンドルと一緒に Hermoso の 設定 → コネクタ に貼り付けます。以降、Claude Code は通常のツール呼び出しとして Bluesky に投稿します。
Claude Code から Bluesky に非公開や下書きで投稿できますか？
いいえ。Bluesky の投稿は AT Protocol 上の公開記録で、限定公開、非公開、下書きの形式はありません。そのため、確認は呼び出しの前に行うべきものです。Hermoso は、Bluesky が対応できない公開範囲を指定された場合、より弱い形で黙って公開するのではなく、その場で拒否します。
Claude Code から Bluesky に投稿するのにコストはかかりますか？
Bluesky への公開にクレジットはかかりません。Bluesky は呼び出しごとの料金がないためです。クレジットを使うのはクリエイティブの生成時です。プランは月額 $29、$69、$149 で、それぞれ 1,200、3,000、7,000 クレジットです。すべての機能は Free プランを含む全プランで使えます。例外はエンタープライズ SSO だけです。
Claude Code から投稿するときの Bluesky の文字数上限は？
Bluesky の投稿は300文字と3,000バイトが上限です。そのため、絵文字の多い投稿は300文字未満でも拒否されることがあります。Hermoso は、どちらの上限が適用されたか、どれだけ超過したかを伝えます。投稿の作成またはキューへの追加時に適用されるため、Claude Code にはすぐに伝わります。誰も見ていないときに後から失敗することはありません。
Claude Code で Bluesky の投稿を後から予約できますか？
はい。schedule_post は、他のすべてのチャンネルと共有する一つのカレンダーに投稿を入れます。キャプションを変えたい場合は、チャンネルごとに付けられます。list_scheduled と cancel_scheduled で読み取りと取り消しができます。Bluesky は、キューに入る十一チャンネルの一つです。