Hermoso

Hermoso：MCP、CLI、スキル

AI 広告ジェネレーターを内蔵した AI マーケティングエージェントを、Claude Code、Claude.ai、Cursor、Codex、独自のスクリプトなど、あらゆる AI エージェントから利用できます。市場で成果を上げている広告を調査し、画像広告や動画広告を生成し（実際の商品を合成し、コピーと CTA も追加）、自分のソーシャルチャネルに公開して、それらを支える広告キャンペーンを構築・管理できます。すべて MCP ツール、CLI、またはインストール可能な Claude スキルから操作できます。

ツールは 1090 個です。 tools/list が常に正式な一覧です。hermoso_capabilities（無料）を使うと、レンダリングごとの正確なクレジット費用を含む最新のモデルカタログと、すべての機能マップを取得できます。

モデルに上乗せ料金はありません。 AI モデルの上乗せ料金を払いすぎるのはやめましょう。プランについては、hermoso.ai/pricing をご覧ください。

Chrome 拡張機能もあります。 Hermoso：広告を保存して複製を使うと、ワンクリックであらゆる広告をスワイプファイルに保存して自分のブランド向けに複製できるほか、あらゆる企業のウェブサイトから広告を取得できます。

ほとんどの機能は無料です。 投稿の公開と予約、広告キャンペーンの構築と管理、分析とインサイト、コメントと DM、コネクター、プロフィール、チームシートは、すべてのプランで無料です。投稿ごとやチャネルごとの料金、シート料金もありません。クレジットを消費するのは、AI モデルの実行（画像、動画、音声、テキスト、プランニング、ポストプロダクション）と Ad Spy による調査のみです。また、すでにレンダリングした広告を投稿しても、追加料金はかかりません。例外は X（Twitter）で、X は API リクエストごとに課金するため、投稿と読み取りには呼び出しごとに数クレジットがかかります。

接続できるサービス。 広告プラットフォーム：Meta、Google Ads、TikTok Ads、LinkedIn Ads、Reddit Ads、X Ads、Pinterest Ads、Snapchat Ads、Microsoft Advertising、Apple Search Ads、ChatGPT Ads、AppLovin Ads、および Google Merchant Center の商品フィード。公開と予約の対象チャネルは11 個：Facebook、Instagram、Threads、TikTok、YouTube、X、LinkedIn、Pinterest、Bluesky、Telegram、Google Business Profile。メッセージング：WhatsApp（個人にメッセージを送るため、公開チャネルの 12 個目には数えません）、Instagram、Facebook Pages、Messenger、X の DM 自動化（キーワード付きコメント、DM、ストーリーへの返信、または ig.me / m.me のリンクから自動返信できます）。広告調査：Meta、Google、LinkedIn の広告ライブラリに加え、オーガニックの TikTok、Instagram、YouTube、Threads、Reddit。分析：Google Analytics 4、Google Search Console、および接続済みプラットフォームそれぞれの投稿・キャンペーンインサイト。ファイル：Google Drive、Sheets、Docs、OneDrive。

すべてを一度に使う必要はありません。 調査、制作、公開・予約、広告管理は、それぞれが独立した領域です。あるツールを使うために、別のツールを先に使う必要はありません。すでにあるクリエイティブを公開または予約して、ここでは何も生成しないこともできます（upload_file を使うと、ローカルまたは外部のあらゆるファイルを、公開・予約・広告作成の各ツールで使える URL に変換できます）。自分の広告アカウントで、自分のクリエイティブを使ってキャンペーンを構築・閲覧することもできます。ブランドを下書きせず、チャネルも接続せずに競合を調査することも、何も接続せずにファイルを生成してダウンロードするだけにすることもできます。必要な機能だけを使うことも、すべてを組み合わせて使うこともできます。

1つのコマンドでインストール

このリポジトリは、プラグインマーケットプレイス、Gemini CLI 拡張機能、スキルパッケージを兼ねているため、コーディングエージェントに Hermoso を1行でインストールできます。どの方法でも、同じ5つのスキル（hermoso-research、hermoso-generate、 hermoso-ad-from-brand、hermoso-product-photoshoot、hermoso-marketing）がインストールされ、スキルが npx を通じて hermoso CLI を実行します。セッションにツール一覧が読み込まれることはありません。CLI コマンドは実行されるまでコストがかからず、すべてのツールを利用できます。 初回は、エージェントが npx -y hermoso auth login を実行し、ブラウザーが開いてサインインします。

Claude Code:

claude plugin marketplace add hermoso-ai/hermoso && claude plugin install hermoso@hermoso

セッション中は、同じ操作を /plugin marketplace add hermoso-ai/hermoso、続けて /plugin install hermoso@hermoso で行えます。

Codex CLI（同じマーケットプレイスファイルを読み込みます）:

codex plugin marketplace add hermoso-ai/hermoso && codex plugin add hermoso@hermoso

Gemini CLI:

gemini extensions install https://github.com/hermoso-ai/hermoso

Grok（xAI）には3つの形態があり、それぞれ接続方法が異なります。

• grok.com と Grok アプリでは、ホスト型コネクターを使用します。Plugins → Connectors → New Connector → Custom を開き（または grok.com/connectors に直接アクセスし）、https://app.hermoso.ai/mcp を貼り付けて、Hermoso アカウントでサインインします。

• Grok Bot：Hermoso Marketing Bot templateを追加します。Hermoso に接続済みの状態で追加され、 キーを求められます。キーはアプリの MCP & CLI → Terminal & API keys から作成できます。

• Grok Build（xAI のターミナルエージェント）は、ローカル MCP サーバーを実行します。一度サインインしてから、以下を追加します。

  npx -y hermoso auth login
  grok mcp add hermoso -- npx -y hermoso mcp
  

Cursor、OpenCode、GitHub Copilot、Windsurf など、ほか約75のエージェントには、オープンスキルインストーラーを使用します。

npx skills add hermoso-ai/hermoso

インストール先のエージェントを選択するよう求められます。-a opencode（または cursor、github-copilot、windsurf）で1つを指定でき、 --skill hermoso-research で単一のスキルをインストールできます。VS Code のエージェントプラグインでは、このリポジトリ全体を読み込むこともできます。Chat: Install Plugin From Source を実行して、 https://github.com/hermoso-ai/hermoso を貼り付けます。

ChatGPT と Claude.ai はブラウザーで動作し、CLI を実行できないため、代わりにホスト型コネクターを使用します（下記を参照）。 ChatGPT デスクトップアプリと ChatGPT ワークスペースの管理者も、このリポジトリの .claude-plugin/marketplace.json を読み込んでスキルをインストールできます。

マシンでブラウザーを使えない場合は、アプリの MCP & CLI からキーを作成して、 npx -y hermoso auth login --token <key> を実行します。

サーバー、CI ジョブ、または Hermoso を1日に何度も呼び出すエージェントゲートウェイでは、1回だけインストールして （npm i -g hermoso）、hermoso を直接呼び出してください。npx は実行のたびに npm レジストリへパッケージを問い合わせるため、 負荷の高いマシンでは npm によってレート制限される場合があります。CLI が HTTP エラーについて「Hermoso から送信されたものではない」と表示した場合、 リクエストが当社に届く前に、お客様側の何か（プロキシ、ファイアウォール、ゲートウェイなど）が拒否したことを意味します。

エージェントが使うべき接続方式は？

2 つの方式があり、どちらが適切かは、こちらの好みではなく、クライアントでできることによって決まります。

クライアント	使用するもの	理由
ブラウザーで動作する：Claude.ai、ChatGPT、Claude Desktop	ホスト型コネクター https://app.hermoso.ai/mcp	ローカルプロセスを起動できないため、URL が唯一の方式です。インストールも、キーの貼り付けも不要で、保存済みのブランドコンテキストとともにツール一式を利用できます。これらのクライアントにはこちらが適切な選択肢であり、劣ったものではありません。
シェルを実行できる：Claude Code、Codex、Gemini CLI、Cursor、Cline、OpenClaw、Hermes、独自のスクリプト	上記の 1 コマンドでのインストール、または CLI 自体（npm install -g hermoso）	ツールマニフェストは、ツールを呼び出すかどうかにかかわらず、すべてのセッションに読み込まれます。シェルコマンドは実行されるまでコストがかからず、デフォルトのツール一覧に限らず、すべてのツールにアクセスできます。

CLI は、ツールマニフェストで得られる情報を、必要なときに、尋ねられた場合にだけ提供します。

npx -y hermoso tools --search reddit   # every matching tool, name + one line
npx -y hermoso tools plan_ad           # one tool's full argument schema
npx -y hermoso call plan_ad --json '{"product":"…"}'   # run it

tools と tools <name> はパッケージに同梱されたレジストリを読み取ります（キーもネットワークもサインインも不要）。そのため、誰かがサインインする前に、エージェントは製品全体を確認できます。コストが発生するのは call だけで、その場合に限り、一度 hermoso auth login を実行する必要があります。

コーディングエージェント自身のツール一覧にもツールを追加しますか？ それが MCP サーバーです。利用は任意です。hermoso auth login を 1 回実行すれば、CLI で使えるようになるだけでなく、claude mcp add hermoso -- npx -y hermoso mcp も env ブロックなしでキーを取得できます。これにより、エージェントは構造化された結果が必要なときはネイティブツールを使い、幅広い操作が必要なときはシェルを使えます。すべてのセッションでコンテキストを消費するため、あるセッションで 1 つの領域に取り組み、そこで多くの呼び出しを行うようになったら追加してください。enable_tools({groups:['ads']}) を使えば、コストのかからない 1 回の呼び出しでキャンペーン管理を有効にできます。

エージェントが自分でサインアップできます

Hermoso アカウントを持たないエージェントでも、アカウントを作成して自分専用のキーを取得し、同じセッション内で広告のレンダリングを開始できます。 ブラウザーを操作する人も、チケットも、待ち時間も必要ありません。

# 1. Start a signup. This call takes no credential, because the credential is what it creates.
curl -sX POST https://app.hermoso.ai/v1/signup \
  -H 'content-type: application/json' \
  -d '{"plan":"pro","period":"mo","email":"[email protected]"}'
# -> { "id": "cs_...", "checkout_url": "https://checkout.stripe.com/...", "claim_token": "hsc_...", "email": { "address": "[email protected]", "verified": false } }
# email = the human behind the account. A verification link goes there; the account works before it is clicked.
# It is a contact mailbox only, never a sign-in. GET /v1/account/email reports the state; POST /v1/account/email/resend re-sends or changes it.

# 2. Pay at checkout_url. Store claim_token first: it is returned only in that response.

# 3. Claim it. Poll until status is "ready".
curl -sX POST https://app.hermoso.ai/v1/signup/cs_.../claim \
  -H 'content-type: application/json' \
  -d '{"claim_token":"hsc_..."}'
# -> { "status": "ready", "api_key": "hmk_...", "credits": 3000 }

この hmk_ キーは、このページにある /v1、MCP サーバー、CLI のすべてで使えるのと同じ認証情報です。クライアントをこのキーに接続すれば、すべての機能を利用できます。

ブラウザーを操作できるエージェントなら、支払いもすでに自分で完了できます。 チェックアウトには Stripe 独自のホストページを使うため、Claude in Chrome などのクライアントであれば、現在すでに人の手を借りずに完了できます。それ以外の場合は、ワンクリックで引き継げます。checkout_url をカードを持っている人に送信してください。運用開始後も同じ仕組みを使えます。buy_credits と upgrade_plan は、追加クレジットや上位プランを購入するための支払い用リンクを発行し、billing_status でいつでも残高を確認できます。

エージェントが自分専用の支払い認証情報を持っていれば、人の手を借りずに支払えます。 {"packId": "pack-1k"} を指定して POST /api/billing/machine-payment を呼び出すと、Machine Payments Protocol を通じた Stripe の支払いチャレンジを含む HTTP 402 と WWW-Authenticate: Payment が返されます。チャレンジに応じて支払い、再試行すれば、同じクレジットパックが同じ残高に追加されます。GET /api/billing/config では、machinePayments の下にパックの一覧が表示されます。パックも価格も同じで、呼び出しごとの課金はありません。

エージェントを使う方法には、有料プランが必要です。 どのプランでも構いません。無料プランは app.hermoso.ai からサインアップする人向けで、ここから無料プランをリクエストすると、その旨を伝える拒否応答が返されます。支払いが完了するまで何も作成されないため、未払いのサインアップによってアカウントが残ったり、料金が発生したりすることはありません。

人の操作がまだ必要なことが一つあります。事前に知っておくとよいでしょう。 ソーシャルアカウントや広告アカウントを接続するには OAuth 同意画面が必要ですが、どのプラットフォームでも同意画面をヘッドレスで完了することはできません。list_connectors で、すでに接続されているものと、まだ接続されていないものを確認できます。それ以外は、ブラウザーを一切使わずに実行できます。リサーチ、生成、すでに接続済みのチャネルへの公開、キャンペーンの作成、レポートの作成が可能です。

リクエストとレスポンスの完全な形式、およびその他すべてのエンドポイントは、ルートを登録する同じテーブルからライブで提供される OpenAPI ドキュメント app.hermoso.ai/openapi.json に記載されています。

すぐに使える：ホスト型 Claude.ai コネクター

https://app.hermoso.ai/mcp?src=readme を Claude → Customize → Connectors → Add → Add custom connector に貼り付け、Continue を押します。Authentication の下で Sign in now を選択します（検出用ハンドシェイクが公開されているため、Claude の検出機能は「No sign-in」をあらかじめ選択します。そのままにすると、最初のリクエストで「Authentication required」と返されます）。Add と Connect を押して、Hermoso アカウントで承認すれば完了です。保存済みのブランドコンテキストを利用できるすべてのツールセットが、プランに請求されます。

Claude Code のクイックスタート（コマンド 1 つ）

1. app.hermoso.ai でアカウントを取得します。無料プランが含まれており、プランとクレジットは Web Studio で使うものと同じです。または、ブラウザーを使わずに、上記の POST /v1/signup でエージェントに有料プランの登録を任せることもできます。
2. プラグインをインストールします。これにより、npx 経由で hermoso CLI を操作する 5 つの Hermoso スキルが追加されます：

claude plugin marketplace add hermoso-ai/hermoso && claude plugin install hermoso@hermoso

すでにセッション内にいますか？ /plugin marketplace add hermoso-ai/hermoso を実行し、続けて /plugin install hermoso@hermoso を実行します。 Codex、Gemini CLI などについては、1 つのコマンドでインストールをご覧ください。 3. 一度だけサインインします。npx -y hermoso auth login を実行するとブラウザーが開きます。エージェントも Hermoso を初めて使うときに自動で実行します。ブラウザーのないマシンでは、MCP & CLI タブの Terminal & API keys（Settings → API keys、または https://app.hermoso.ai/?tab=api-keys から直接アクセス）にあるキーを使って、npx -y hermoso auth login --token hmk_… を実行します。 4. 通常のプロンプトでやりたいことを指示します。Claude Code がタスクに合った Hermoso スキルを選び、コマンドを実行します。コマンドを入力する必要はありません。

CLI を手動でインストールする場合は、npm install -g hermoso を実行すると、同じ hermoso コマンドが PATH に追加されます。スキルはコマンドが存在する場合、それを使用します。

ホスト型 URL は Claude Code でも使えますが、セッションにツール一覧を読み込まないため、Claude Code ではプラグインを使うほうが手軽です。コネクターを使う場合は、claude mcp add --transport http hermoso "https://app.hermoso.ai/mcp?src=readme" を実行します。claude mcp list には、claude mcp login hermoso を一度実行してブラウザーで承認するまで ! Needs authentication と表示されます（ヘッドレスマシンでは --no-browser を指定するとリンクが表示されます）。2026-09-25 に Claude Code 2.1.282 で計測しました。

これで、エージェントはプロフィールのコンテキストを反映した Studio の全機能を利用できます。Web アプリで設定したブランド情報、製品、ロゴ、学習済みメモリが自動的に適用されます（保存済みの内容は get_brand で確認できます。設定内容を使用するには、plan_ad／plan_variations で brand を省略してください）。レンダリングには Hermoso クレジットが使われ、Studio と同じ料金が適用されます。クレジットが消費されるのは AI モデルの実行と Ad Spy のリサーチのみです。公開、スケジュール設定、広告管理、分析はどのプランでも無料です（X への投稿と X データの読み取りは、呼び出しごとに課金される唯一の例外です。X 広告の管理は無料です）。

1. MCP サーバー（stdio）、コーディングエージェントでは任意

hermoso mcp は、Hermoso のツール一式を公開する stdio MCP サーバーを起動します。これは、Hermoso のツールを独自の一覧に追加したいクライアント向けです。公開済みの hermoso パッケージを使うため、リポジトリをクローンする必要はありません。npx -y hermoso mcp で取得して実行できます。CLI で一度サインインすれば、hermoso mcp が hermoso auth login で保存したベアラートークンを読み込むため、クライアントの設定にキーを記載する必要はありません：

npm install -g hermoso && hermoso auth login && claude mcp add hermoso -- npx -y hermoso mcp

ブラウザーのないマシンでは、サインインを省略し、代わりにキーをクライアントに渡します：

claude mcp add hermoso -e HERMOSO_TOKEN=hmk_… -- npx -y hermoso mcp

Cursor／Codex の場合は、同じ方法でサインインしてから mcp.json に追加します（Codex では同等の TOML 形式を使用します）。上記の方法でサインインした場合は、env ブロック全体を削除してください。ホームディレクトリを読み取れないプロセスが実行される CI 用に記載しています：

{ "mcpServers": { "hermoso": { "command": "npx", "args": ["-y", "hermoso", "mcp"],
  "env": { "HERMOSO_API_BASE": "https://app.hermoso.ai", "HERMOSO_TOKEN": "<your token>" } } } }

続けて、エージェントに 「Hermoso で画像広告を生成して」 と指示します。

1090 個のツールでできること

広告調査／リサーチ — find_competitors、competitor_teardown、pull_competitor_ads、research_ads、Meta／Google／LinkedIn の広告ライブラリ（search_meta_ads、search_google_ads、search_linkedin_ads）、オーガニックソーシャル（search_tiktok、search_instagram、search_youtube、search_reddit、search_threads）、fetch_social_data、mine_angles、analyze_video、check_ad_policy、list_skills／get_skill。 作成 — draft_brand → plan_ad → render_ad（Studio の高品質パイプライン：テキストの合成、クリアな音声、音楽、ブランドのエンドカード）、または generate_image / generate_video / generate_avatar（UGC クリエイター＋リップシンク）。 ワークスペースの保存済みキャストは再利用できます。list_creators は保存済みクリエイターをポートレート URL とともにすべて返し、save_creator で追加、delete_creator で削除できます。ポートレートを generate_avatar / generate_video / recast_motion に再度渡せば、レンダリングのたびに新しい顔になるのではなく、同じ人物がすべての広告に出演します。 そのほか、make_template_ad（ネイティブ HTML 広告フォーマット）、make_explainer、product_sizzle、make_thumbnail、clone_static、recast_motion、reframe_video、upscale_video、dub_video、change_voice、finish_video、fix_beat、stitch_video、clip_video、post_edit に加え、広告を複数展開して順位付けする plan_variations ＋ score_ad もあります。 長さは自由に設定できます： plan_ad に durationSeconds を渡すと、ストーリーボードはその長さに合わせて作成されます。レンダリングモデルの 1 クリップに収まる長さなら、連続した 1 テイクとしてレンダリングされ、それより長い場合は複数の幕をつないで構成します（15 秒クリップ対応モデルの場合、40 秒は 15＋15＋10）。再生速度を上げて時間を圧縮することはありません。1 クリップに収まる長さはモデル自体の最大値であり、固定の数値ではありません。ほとんどの動画モデルは 1 クリップあたり 15 秒が上限ですが、最長クリップ対応モデルなら、ネイティブ同期音声付きの途切れない 1 テイクを 30 秒間撮影できます。hermoso_capabilities で、各ティアの対応時間、解像度、正確なクレジットコストをリアルタイムで確認できます。そのモデルを model に指定すれば利用できます。モデル名を指定しないレンダリングは、より限定的な自動選択プールに振り分けられます。

Ads Studio（make_static_ads）：商品と件数を選ぶと、完成した静止画広告をまとめて一度の呼び出しで生成できます。それぞれ異なる訴求角度とレイアウトで、実際の商品写真とロゴが配置されます。広告の生成元となる商品カタログ（list_products、add_product、refresh_products、update_product、remove_product）は、各商品のライブページをキャッシュしたもので、商品名、写真、価格はページから取得します。

どの動画でも人物を入れ替えられます（recast_hook、recast_motion）：シーン、カット、音声はそのままに、自分の写真、保存済みクリエイター、AI 生成の人物を使って、画面に映る人物を変更できます（ウェブ版 Studio では、言葉でプレゼンターを指定できます）。 自分の写真に写った実在の人物を使うには有料プランが必要ですが、AI 生成の人物はすべてのプランで利用できます。

モデルをそのまま試せるプレイグラウンド — 広告向けの設定を介さず、全カタログ（画像／動画／音声／文章生成モデル 30 種以上。各モデルのレンダリング 1 回あたりの正確なクレジットコスト付き）を利用できます。useBrand:false を指定した generate_image / generate_video、generate_voice、generate_text が使えます。画像生成のデフォルトは Nano Banana 2.1 です。 独自のチャネルに投稿 — 11種類に対応します。Facebook、Instagram、Threads（post_to_meta）、TikTok （post_to_tiktok）、YouTube（post_to_youtube + update_youtube_video、youtube_video_insights、コメントの読み取り／返信）、X（post_to_x、x_post_metrics、x_post_insights、x_mentions、list_x_dms、send_x_dm）、 LinkedIn のプロフィールと会社のページ（post_to_linkedin、post_to_linkedin_page）、Pinterest （post_to_pinterest + ボード）、Bluesky（post_to_bluesky、delete_bluesky_post、bluesky_post_metrics、さらに list_bluesky_convos／read_bluesky_dm／send_bluesky_dm）、Telegram（post_to_telegram、 delete_telegram_message、list_telegram_chats）、Google ビジネス プロフィール（後述）です。schedule_post／list_scheduled／cancel_scheduled を使うと、この一連のチャネル全体で共通のコンテンツカレンダーを利用できます。upload_file では、Hermoso でレンダリングしたメディアだけでなく、外部またはローカルのあらゆるメディアを取り込めます。 X への投稿では、API 呼び出しごとにクレジットが課金されます（X はリクエストごとに課金します）。リンクを含む投稿は、リンクを含まない投稿の 13 倍の費用がかかります。 Google ビジネス プロフィールは、Google 検索とマップに表示されるビジネスの情報パネルです。post_to_google_business は、テキストと任意で写真を 1 枚、さらに行動を促すボタンを含む投稿を公開します（Google の投稿では動画を利用できないため、動画のみのスケジュールはこのチャネルでは受け付けられません）。list_google_business_posts と delete_google_business_post で、表示中の投稿を管理できます。list_google_business_reviews では未返信のレビューを探し、reply_to_google_business_review ではビジネスとして返信できます。google_business_insights は検索とマップでの表示回数、通話数、ウェブサイトのクリック数、ルート検索のリクエスト数を報告し、google_business_search_keywords はリスティングを見つけるためにユーザーが検索した語句を報告します。list_business_locations、get_business_location、update_business_location では、営業時間、電話番号、ウェブサイト、説明、カテゴリなど、リスティング自体の情報を読み取り、編集できます。ビジネス プロフィールの Q&A は提供していません。Google は 2025-11-03 にこれを終了しました。

WhatsApp で顧客にメッセージを送信 — これはメッセージ機能であり、12 番目の投稿チャネルではありません。個人にメッセージを送信するもので、フィードへの投稿は行いません。list_whatsapp_accounts でビジネスアカウントとその電話番号を探し、list_whatsapp_templates／create_whatsapp_template／delete_whatsapp_template で Meta の審査を受けるテンプレートを管理し、send_whatsapp_message でメッセージを送信します。実際の電話番号に届き、会話ごとに Meta からビジネスに請求されるため、送信には確認が必要です。保留中の事項ではなく、Meta の API に関する恒久的な制約が 2 つあります。Hermoso は WhatsApp の Webhook を受信しないため、読み取れるメッセージ履歴はありません — 受信トレイ機能ではなく、list_inbox の対象にも含まれません — また、顧客から最初のメッセージが届いて開始する 24 時間の時間枠を過ぎると、WhatsApp が受け付けるのは承認済みのテンプレートのみです。

Instagram の DM を自動化 — save_instagram_dm_automation で、ブランドに代わってユーザーに返信するルールを設定できます。投稿 1 件、次の投稿、またはすべての投稿へのキーワード付きコメントには非公開で返信し、DM、ストーリーへの返信、または ig.me リンクには回答します。リンクボタン、公開コメントへの返信、フォロー条件、ドライランも任意で設定できます。test_instagram_dm_automation では、サンプルのコメントや DM に対して何が送信されるかを、実際には送信せずに正確に確認できます。list_instagram_dm_automations／delete_instagram_dm_automation では、各ルールの統計情報と送信ログを確認するか、ルールを削除できます。各ユーザーへの返信は投稿ごとに 1 回までです。Meta では、コメントから 7 日以内であれば非公開で返信できます。また、送信処理では AI を実行しないため、クレジットは消費されません。 Facebook と X のDMも自動化 — save_dm_automation（test_dm_automation、list_dm_automations、delete_dm_automation を含む）では channel を指定します。instagram、facebook（ページ投稿または広告へのキーワードコメントには Messenger で非公開の返信が届き、Messenger のキーワードまたは m.me リンクには回答します）、または x（キーワードを含む @メンション、または自分の投稿への返信には公開返信し、DM のキーワードにはDMで返信します）を指定できます。X では、相手が先にあなたへDMを送っている場合にのみ自動DMが許可されます。また、相手が「STOP」と書いたDMを送ると、その人は配信を停止できます。Facebook は Instagram と同様に無料です。X は呼び出しごとに課金されるため、X が配信するメンション、返信、DMごと、および送信する返信やDMごとに、X の自動化ではクレジットが消費されます。クレジットがなくなると、X のルールは停止します。

投稿の自動運転（set_post_refill、get_post_refill、run_post_refill）：投稿の頻度、投稿先、テーマ（「Instagram と Bluesky に、ゆったりした朝の習慣について1日2件投稿し、先に確認させてください」など）を伝えると、Hermoso がブランドに合わせた新しい投稿を作成し、カレンダーを埋めます。先に確認する方法（各バッチが承認、編集、または作り直しを待つ）と、自動投稿する方法（そのままスケジュールに追加され、あとから取り消すことも可能）を選べます。残したメモに沿って、各チャンネルでうまくいった内容をもとに文章を作成します。クレジットは投稿が作成されたときにのみ消費されます。

広告を運用 — キャンペーン全体を一時停止状態で作成し、報告前に内容を読み返します。すべての費用変更には確認が必要です。対応プラットフォームは12種類です。Meta、Google Ads、LinkedIn Ads、Reddit Ads、Pinterest Ads、Microsoft Advertising、ChatGPT Ads（OpenAI の Advertiser API）、X Ads、TikTok Ads、Snapchat Ads、Apple Ads（App Store の Apple Search Ads）、AppLovin Ads（各アカウントが持つキーを使ったレポートとウェブサイトピクセルに対応。キャンペーン作成は、AppLovin がアカウントで Campaign Management API アクセスを有効にした後に対応し、サーバー側のコンバージョンイベントは AppLovin がリクエストに応じて発行する Conversion API キーを使用します）。各プラットフォームには、一覧表示、レポート、作成、予算・ステータスの各ツールがあります（例：list_google_ads_campaigns、google_ads_report、create_google_ads_campaign、set_google_ads_budget、set_google_ads_status）。Snapchat には、他のプラットフォームにはない追加手順があります。広告は CREATIVE を参照し、Snapchat の各クリエイティブには Public Profile id が必要です。upload_snapchat_ads_creative を使って作成してください。

ショッピング掲載面に商品データを提供 — Google Merchant Center は、小売業向け Performance Max またはショッピングキャンペーンで広告するカタログです（create_google_ads_performance_max_campaign では merchantCenterId を指定します）。ここから、アカウントとアカウントのステータス、データソース、商品の登録・更新・削除、地域ごとの在庫、割り当て量、商品レベルのパフォーマンスを確認する merchant_report、通知、コンバージョンソースを管理できます。さらに、不承認への対応も可能です。list_merchant_issues で問題を確認し、merchant_issue_help で Google が公式に案内している修正方法を取得できます。プロモーションを利用するには、Google のプロモーションプログラムに販売者自身が登録する必要があります。登録していない場合、Google はこのサブAPIを拒否します。 Microsoft Merchant Center も同様の機能（ストア、カタログ、商品、問題）に対応し、Bing ショッピングで利用できます。 広告の成果を測定する — Google Analytics 4 が成果の把握を可能にします。ここにある他のコネクターは広告にかかった「費用」を報告しますが、このコネクターは広告が「もたらした成果」を報告します。analytics_report では、チャネル、参照元／メディア、キャンペーン、ランディングページ、国、デバイス、日付ごとにセッション、ユーザー、コンバージョン、収益を分類できるため、Hermoso が作成したキャンペーンと、そのキャンペーンがもたらした収益をひとつの会話で確認できます。analytics_realtime では、現在サイトを訪れているユーザーを確認できます。まず list_analytics_properties を使ってください。ツールが受け取るのは数値のプロパティ ID であり、トラッキング スニペットに記載された G-XXXXXXXXX の測定 ID ではありません。このツールを使うと、測定 ID からプロパティ ID を特定できます。読み取りだけでなく、書き込みも可能です。create_analytics_key_event は、GA4 がすでに収集しているイベントをキーイベントとして設定します。これにより、Google Ads にコンバージョンとしてインポートできるようになります。また、create_analytics_custom_dimension はイベントパラメーターを登録し、その項目でレポートを分類できるようにします。プロパティがすでに測定している項目は list_analytics_definitions で確認できます。Google Ads、YouTube、Drive と同じ Google アカウントでサインインしますが、接続はそれぞれ別です。 GA4 専用です。API には Universal Analytics のインターフェースはありません。カスタム ディメンションはアーカイブできますが、削除することはできません。また、プロパティごとにイベントスコープのカスタム ディメンションを 50 個まで設定できます。

ファイル — Google Drive の CRUD 操作（save_to_drive、list_drive_files、update_drive_file、delete_drive_file、create_drive_folder）、Google Sheets（create_sheet、append_to_sheet、read_sheet）、Google Docs（create_doc、append_to_doc）、OneDrive（save_to_onedrive と完全な CRUD 操作）。

ワークスペースとアカウント — プロフィール（list_brands、create_brand、use_brand、update_brand、delete_brand。1 つのアカウントに複数のプロフィールを登録でき、それぞれをブランド、クライアント、クリエイター、個人用ワークスペースとして使えます。そのため、代理店はここで全クライアントを管理できます）、メモリー（remember、forget、list_memory）、カスタムスキル（save_skill、get_skill、list_skills、delete_skill。旧 AI-Employee ペルソナを統合した、ひとつのライブラリです）、チーム（list_team、invite_member、remove_member、set_role）、設定（get_settings、update_settings。広告、スクリプト、プランの作成に使う言語も含みます）、コネクター（list_connectors、list_connector_accounts、set_connector_accounts、disconnect_connector）、課金（hermoso_credits、billing_status、buy_credits、upgrade_plan、set_auto_reload）、さらに非同期レンダリング用の list_jobs／get_job があります。

コネクターアカウントは推測ではなく、選択して指定します。 1 人のユーザーが複数の Facebook ページ、Google Ads の顧客アカウント、LinkedIn の会社ページを管理していることはよくあります。プロフィールでチェックを入れたアカウントのみ使用できます。これはサーバー側で強制され、選択が空の場合は何も共有されません。新しいアカウントを連携する手順だけはヘッドレスではありません（OAuth の同意画面が表示されるため、ユーザーはアプリで操作します）。

レンダリングジョブはサーバー側でキューに登録され、完了までポーリングされます。完了すると、配信 URL が返されます。

2. CLI：ターミナルエージェント向けのコンテキスト不要な方法

bin/hermoso.mjs は、完全な MCP ツールセットをサブプロセスコマンドとして公開するため、エージェントは肥大化したツールマニフェストを持ち運ばずに、シェルコマンドを実行できます。

npm install -g hermoso                             # installs `hermoso`
hermoso capabilities                               # valid model ids + costs (run first)
hermoso create --brand "YourBrand" --product "your best-selling product" --format image
hermoso generate image --prompt "…" --ref ./product.png --wait
hermoso generate video --prompt "…" --duration 8 --wait
hermoso competitors yourbrand.com
hermoso research "Liquid Death’s longest-running ads"

任意のコマンドに --json を追加すると、機械処理向けの出力を取得できます。

これらのショートカットはよく使われる方法であり、機能のすべてではありません。 MCP サーバーにあるすべてのツールをここからも利用できます。コネクターのデフォルトの一覧に含まれていない広告キャンペーンやアナリティクスのグループも利用できます。

hermoso tools                          # every tool, grouped, name + one line
hermoso tools --group ads --search reddit   # narrow it
hermoso tools create_meta_campaign     # that tool's full argument schema
hermoso call create_meta_campaign --json '{"name":"…"}'   # run it
hermoso create_meta_campaign --name "…"                   # same thing, shorter

call は MCP サーバーと同じハンドラー、同じ引数検証、同じ確認／支出制限を経由するため、別個の実装が乖離することはありません。tools と tools <name> はパッケージに同梱されたレジストリを参照するため、キーもネットワークもサインインも必要ありません。

3. スキル：コーディングエージェントがインストールするもの

skills/ には、インストール可能な5つのスキルが含まれています。

スキル	機能
hermoso-research	競合を見つけ、実際に配信されている広告を取得し、参考にすべき訴求ポイントを提示します
hermoso-generate	プロンプトから完成した画像、動画、アバター動画、または編集済み動画を作成します
hermoso-ad-from-brand	ブランドまたはドメインから、コンセプトとコピーを含むブランドに合った広告を1つ作成します
hermoso-product-photoshoot	実際の商品写真を、スタジオ、ライフスタイル、またはヒーローシーンに合成します
hermoso-marketing	リサーチ、作成、公開とスケジュール設定、有料キャンペーン、効果測定まで、すべてを行います

これらは、このページの先頭にあるワンコマンドインストールで Claude Code、Codex、Gemini CLI、および npx skills add を通じて追加されるスキルです。リポジトリをクローンした場合は、コピーしてもインストールできます。

cp -r skills/* ~/.claude/skills/

続いて、/hermoso-ad-from-brand an ad for yourbrand.com, our hero product を実行します。

自分の言葉で依頼する

スキルは自動で選ばれます。以下はコマンドではなく、プロンプト全体の例です。

• [商品 + URL] の競合上位5社を見つけ、過去90日間に配信された最も効果的な Meta と TikTok の広告を取得し、根拠を添えて、参考にすべき3つの訴求ポイントと2つのフォーマットを教えてください。
• [ブランド] の今週の広告を作成してください。2つの訴求ポイントを2つのフォーマットで、UGC を1つ、商品ビジュアルを1つ、9:16 で作成します。配信前にスコアを付け、ポリシーに準拠しているか確認してください。
• 競合の広告はこちらです：[リンク]。効果がある理由を分析してから、構成はそのままに、私の商品とブランディングを使って新しい訴求ポイントで作り直してください。
• Instagram、TikTok、X、LinkedIn の今後7日分のソーシャル投稿キューを、最も反応の良かった投稿から再利用して埋めてください。各チャネル向けのキャプションも作成してください。
• 先週の勝ちパターンを使って、Meta と TikTok で1日あたり20ドルのテストキャンペーンを作成してください。広告セットは3つで、それぞれ異なる切り口にします。一時停止状態にして、確認できるよう構成を読み上げてください。
• 先月の全プラットフォームのキャンペーン実績を取得してください。効果があったクリエイティブを2つ挙げ、その理由と、来月のブリーフに記載すべき内容を教えてください。

設定

環境変数	意味
HERMOSO_API_BASE	Hermoso API のオリジン（デフォルトは https://app.hermoso.ai。アプリを自分で実行する場合は http://localhost:3000 を設定します）
HERMOSO_TOKEN	Bearer エージェントキー（hmk_…）。ホスト版アプリへの接続に必須です
HERMOSO_PROFILE	複数のプロフィールがあるアカウント向けのプロフィール ID
HERMOSO_OWNER	別のアカウントから共有されたプロフィール（チームワークスペース）の場合のみ使用します。所有アカウントの ID を指定してください。HERMOSO_PROFILE と併せて設定し、HERMOSO_PROFILE にはそのワークスペースの profileUuid を指定してください（プロフィールの短いスラッグは拒否されます）。list_brands（または CLI から hermoso list_brands）を実行すると、アクセス可能な各ワークスペースの両方の値が表示されます。サーバーはリクエストごとにこのペアを再認証するため、値が誤っている場合は信頼されず、拒否されます。

mcp/http.mjs は、ホスト型リモートコネクタのトランスポートです（Claude.ai に URL を貼り付けて → コネクタに接続）。透明性を保つため、このリポジトリに含まれており、認証済みの ID がなければマウントを拒否します。匿名で費用が発生することはありません。

ライセンス

MIT © Hermoso