Hermoso — MCP、CLI、スキル

マーケティング業務全体をあらゆるAIエージェントから実行できます：Claude Code、Claude.ai、Cursor、Codex、または独自のスクリプト。市場で勝っている広告を調査し、完成した画像・動画広告（実際の商品を合成し、コピー＋CTAを含む）を生成し、自分のソーシャルチャンネルに公開し、その背後にある広告キャンペーンを構築・管理できます。すべてMCPツール、CLI、またはインストール可能なClaudeスキルを通じて行えます。

718ツール。 tools/list が常に正規のセットです。hermoso_capabilities（無料）は、レンダリングごとの正確なクレジットコストと完全な機能マップを含むライブモデルカタログを返します。

接続先。 広告プラットフォーム：Meta、Google Ads、TikTok Ads、LinkedIn Ads、Reddit Ads、X Ads、Pinterest Ads、Snapchat Ads、Microsoft Advertising、Apple Search Ads、ChatGPT Ads、さらにGoogle Merchant Centerの商品フィード。公開とスケジュール — 10チャンネル：Facebook、Instagram、Threads、TikTok、YouTube、X、LinkedIn、Pinterest、Bluesky、Telegram。メッセージング：WhatsApp（人にメッセージを送るため、11番目の公開チャンネルではありません）。広告調査：Meta、Google、LinkedInの広告ライブラリに加え、オーガニックなTikTok、Instagram、YouTube、Threads、Reddit。分析：Google Analytics 4、Google Search Console、および接続された各プラットフォームの投稿・キャンペーンインサイト。ファイル：Google Drive、Sheets、Docs、OneDrive。

オール・オア・ナッシングではありません。 調査、作成、公開/スケジュール、広告管理は4つの独立した領域です — どのツールも、他のツールを先に使う必要はありません。既存のクリエイティブを公開・スケジュールし、ここでは何も生成しない（upload_file は、ローカルまたは外部ファイルを、すべての公開・スケジュール・広告構築ツールが受け入れるURLに変換します）。自分の広告アカウントで、自分のクリエイティブを使ってキャンペーンを構築・閲覧する。ブランドをドラフトせず、チャンネルを接続せずに競合を調査する。または、何も接続せずにファイルを生成してダウンロードするだけ。必要な部分だけを使うか、すべてを一緒に使うか。

エージェントはどのサーフェスを使うべきか？

2つの形状があり、正しい選択はクライアントが何をできるかによって決まります。私たちの好みではありません。

測定された差（2026-08-27、バイトからの推定ではなく実際のツール定義としてカウント）：

CLIは代わりに、要求されたときにのみ同じ質問に答えます：

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

つまり、ターミナルエージェントは、全ロースターを範囲に含めて約3.4Kトークンで最初の呼び出しに到達します。一方、その一部だけでも182Kです。tools と tools <name> はパッケージに同梱されたレジストリを読み取ります — キー不要、ネットワーク不要、サインイン不要 — そのため、誰もサインインする前にエージェントが製品全体を閲覧できます。call だけがコストを消費し、それには hermoso auth login が一度だけ必要です。

両方を同時に使うのも問題なく、Claude Codeにはそれを推奨します。 1回の hermoso auth login でCLIをカバーし、さらに claude mcp add hermoso -- npx -y hermoso mcp が env ブロックなしでキーを取得できるため、エージェントは構造化された結果が必要なときはネイティブツールに、広さが必要なときはシェルアウトに手を伸ばせます。1つだけにしたい場合は、CLIを選んでください：厳密にカバー範囲が広いです。

シェル対応クライアントでもコネクタの方が良いトレードオフになる場合： 1つの領域に多くの呼び出しを行うセッション。enable_tools({groups:['ads']}) は、1回の無料呼び出しでキャンペーン管理をオンにし、ツールはネイティブになります — シェルのクォート不要、構造化された結果。1つのツールのために221Kトークンのグループを読み込むよりも、1回のシェル往復の方が優れています。セッションがその領域に落ち着くと、逆が真になります。

Related MCP server: Prizmad

エージェントは自分でサインアップできる

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"}'
# -> { "id": "cs_...", "checkout_url": "https://checkout.stripe.com/...", "claim_token": "hsc_..." }

# 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のホスト型ページなので、ChromeのClaudeやそのようなクライアントは、今日、無人で完了できます。他のすべてはワンクリックのハンドオフです：checkout_url をカードを持つ人に送信します。同じ形状は、後で実行中になったときにもカバーします：buy_credits と upgrade_plan は、追加クレジットまたはより大きなプランへの支払い可能なリンクを作成し、billing_status はいつでも残高を読み取ります。

エージェントパスは有料プランを必要とします。 どれでも。無料プランはapp.hermoso.aiでサインアップする人のためのもので、ここで要求するとその旨の拒否が返されます。支払いが完了するまで何も作成されないため、未払いのサインアップはアカウントを残さず、料金も発生しません。

1つだけ、人間が必要なものがあります。それは事前に知っておく価値があります。 ソーシャルまたは広告アカウントの接続はOAuth同意画面を意味し、同意画面はどのプラットフォームでもヘッドレスで完了できません。list_connectors は、何がすでに接続されていて、何が接続されていないかを示します。他のすべてはブラウザなしで実行されます：調査、生成、すでに接続されているチャンネルへの公開、キャンペーン構築、レポート。

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

インスタント：ホスト型Claude.aiコネクタ

https://app.hermoso.ai/mcp をClaude → 設定 → コネクタ → カスタムコネクタを追加 に貼り付け、Hermosoアカウントで承認するだけです — 保存されたブランドコンテキストを含む完全なツールセットが、プランに請求されます。

Claude Codeのクイックスタート（1行）

1. アカウントを取得 app.hermoso.aiで — 無料ティア含む。プランとクレジットはウェブスタジオと同じものです。または、ブラウザを完全にスキップして、エージェントに POST /v1/signup（上記）で有料プランにサインアップさせます。

2. 1行実行。 ブラウザがサインインのために一度開きます。貼り付けるものはなく、キーが .claude.json に保存されることもありません：

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

3. 必要なことを通常のプロンプトで依頼。 Claude Codeはツールに手を伸ばすか、ターミナルで hermoso コマンドを実行します。ジョブに必要な方です。あなたはどちらも入力しません。

広告キャンペーンと分析ツールは、enable_tools でオンにするまでツールリストに含まれません。これによりリストが小さく保たれます。ブラウザのないマシンでは、設定 → エージェントとAPI のキーを使って hermoso auth login --token hmk_… でサインインするか、サインインをスキップしてキーをクライアントに渡します：

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

ホスト型URLはClaude Codeでも機能しますが、そこでは劣ったパスであり、その理由を知る価値があります：claude mcp add --transport http hermoso https://app.hermoso.ai/mcp は受け入れられますが、その後 claude mcp list は ! Needs authentication と報告します。これは、クライアントが自分でOAuthフローを開始しないためです — セッションを開き、/mcp を実行し、サーバーを見つけて認証を押す必要があります。2026-08-23にClaude Code 2.1.241に対して測定。

エージェントは、ワークスペースのコンテキストを持つ完全なスタジオを利用できます：ウェブアプリで設定したブランドプロフィール、商品、ロゴ、学習されたメモリが自動的に適用されます（get_brand は保存されたものを表示。plan_ad/plan_variations で brand を省略すると使用されます）。レンダリングはHermosoクレジットに請求されます — スタジオと同じ価格です。

1. MCPサーバー（stdio）— Claude Code / Cursor / Codex

hermoso mcp は、完全なツールセットを公開するstdio MCPサーバーを実行します。公開された 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

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で画像広告を生成して。」

718ツールの対象範囲

広告スパイ / 調査 — 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（スタジオ品質パイプライン：合成テキスト、クリアな音声、音楽、ブランドエンドカード）、または 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、remix_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クリップに収まるものはモデル自身の最大値であり、固定数ではありません：ほとんどの動画モデルはクリップを15秒に制限し、最長クリップのモデルは30秒を1回の途切れないテイクで、ネイティブの同期オーディオ付きで撮影します。hermoso_capabilities はライブリスト — 期間、解像度、各ティアの正確なクレジットコスト — そしてそのモデルを model で指定することで取得できます。名前のないレンダリングは、より狭い自動プールによってルーティングされるためです。

生のモデルプレイグラウンド — 広告的な枠組みなしの完全カタログ（30以上の画像／動画／音声／文章モデル、それぞれの正確なレンダリングあたりのクレジットコスト付き）: generate_image / generate_video（useBrand:false 使用）、generate_voice、generate_text。

自分のチャンネルに公開 — 10 チャンネル: 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）。schedule_post / list_scheduled / cancel_scheduled で、まさにそのセットに対する1つのコンテンツカレンダーを利用できる。upload_file は、Hermosoのレンダリングだけでなく、外部またはローカルのメディアを取り込む。 Xへの投稿はAPI呼び出しごとにクレジットが請求される（Xはリクエストごとに課金する）; リンクを含む投稿は、含まない投稿の13倍のコストになる。 保留され、隠されるのではなく明示されているもの: Google Business Profile は構築済み（post_to_google_business、レビュー、Q&A、インサイト）だが提供されていない — GoogleはそのAPIをプロジェクトごとに許可リスト化しており、当社のものは0 QPMを読み取るため、すべての呼び出しがすべてのユーザーに対して403になる。schedule_post のチャンネルenumには含まれており、エンキュー時に拒否される。

WhatsAppで顧客にメッセージを送信 — メッセージングであり、11番目の公開チャンネルではない: 人にメッセージを送るのであって、ここでフィードに投稿することはない。list_whatsapp_accounts はビジネスアカウントとその電話番号を見つけ、list_whatsapp_templates / create_whatsapp_template / delete_whatsapp_template はMetaが審査するテンプレートを管理し、send_whatsapp_message は1通を送信する — 実際の電話番号に届き、Metaが会話に対してビジネスに請求するため、確認ゲート付き。MetaのAPIに関する恒久的な事実であり、保留中のものではない2つの制限: HermosoはWhatsAppのウェブフックを受信しないため、読み取れるメッセージ履歴はない — 受信トレイのサーフェスではなく、list_inbox はそれをカバーしない — そして顧客が最初にメッセージを送ってから開く24時間のウィンドウの外では、WhatsAppは承認済みテンプレート以外は受け付けない。

広告を運用 — 完全なキャンペーンツリー。すべて一時停止状態で構築され、何かが報告される前に読み戻され、すべての支出変更は確認ゲート付き。11 のプラットフォーム: 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）。それぞれに一覧 + レポート + 作成 + 予算／ステータスツールがある（例: list_google_ads_campaigns、google_ads_report、create_google_ads_campaign、set_google_ads_budget、set_google_ads_status）。Snapchatには他にはない追加のステップが1つある: 広告はCREATIVEを指し示す必要があり、すべてのSnapchatクリエイティブはPublic Profile idを保持しなければならない — upload_snapchat_ads_creative で構築する。

ショッピングサーフェスに供給 — Google Merchant Center は、リテールのPerformance MaxまたはShoppingキャンペーンが広告するカタログであり（create_google_ads_performance_max_campaign は merchantCenterId を受け取る）、ここから管理する: アカウントとアカウントステータス、データソース、商品のupsert / update / delete、地域別在庫、クォータ、商品レベルのパフォーマンスのための merchant_report、通知とコンバージョンソース、さらに不承認ループ — list_merchant_issues は何が問題かを示し、merchant_issue_help はGoogle自身の文書化された修正を返す。プロモーションには、Googleのプロモーションプログラムへのマーチャント自身の登録が必要; それがなければGoogleはそのサブAPIを完全に拒否する。 Microsoft Merchant Center は同じ形状（ストア、カタログ、商品、問題）でカバーされており、Bing Shopping向け。

広告が達成したことを測定 — Google Analytics 4がループを閉じる。ここにある他のすべてのコネクタは広告が かかったコスト を報告する; これだけが もたらした結果 を報告する。analytics_report はセッション、ユーザー、コンバージョン、収益をチャネル、ソース／メディア、キャンペーン、ランディングページ、国、デバイス、または日付で分類するため、Hermosoが構築したキャンペーンとそれが生み出した収益が1つの会話の中に収まる。analytics_realtime は現在サイトにいるユーザーを表示する。list_analytics_properties から始める — ツールは数値のプロパティIDを受け取り、トラッキングスニペットの G-XXXXXXXXX 測定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サーバーが使用するのと同じハンドラー、同じ引数検証、同じ確認／支出ゲートを通過する — 乖離する2番目の実装はない。tools と tools <name> はパッケージにバンドルされたレジストリを読み取るため、キー、ネットワーク、サインインは不要。

3. Claudeスキル — CLIをラップするスラッシュコマンド

skills/ には4つのインストール可能なスキルがある: hermoso-generate、hermoso-ad-from-brand、hermoso-product-photoshoot、hermoso-research。

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

次に /hermoso-ad-from-brand an ad for yourbrand.com — our hero product を呼び出す。

設定

mcp/http.mjs はホスト型リモートコネクタトランスポート（Claude.ai → ConnectorsにURLを貼り付ける）。透明性のためにこのリポジトリに同梱されており、認証済みIDなしではマウントを拒否する — 匿名での支出は決してない。

ライセンス

MIT © Hermoso