Hermoso はマーケティング用の MCP サーバーです。922+ のツールを一つの OAuth 対応エンドポイントで提供し、エージェントが市場で既に配信されている広告をリサーチし、完成した画像と動画の広告を生成し、それらを投稿し、その背後にある有料キャンペーンを作れるようにします。Claude Code は一つの接続からこれらすべてを使えます。このページでは、その中の一部を扱います。Claude Code が Pinterest で実際に何をできて、Pinterest が何をさせないかです。
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 の 設定 → コネクタ で Pinterest 自体を一度接続してください。これはブラウザでの OAuth 同意画面なので、唯一ブラウザが必要な手順です。そのあとはすべてツール呼び出しです。
Claude Code が使える Pinterest のツール
list_pinterest_boards: アカウントのボードを、非公開のボードも含めて ID とともに表示します。create_pinterest_board: 新しいボードを作成します。post_to_pinterest: 指定したボードに、画像または動画の Pin を作成します。タイトル、説明、遷移先リンク、代替テキストを付けられます。schedule_post:boardIdを付けて Pin をキューに入れます。list_pinterest_ads_campaigns / pinterest_ads_report: 有料側のデータを読み取ります。
Pinterest のワークフローを計画する前に知っておくべき制限：このアプリは Trial アクセスを持っており、Pinterest は Trial では本番環境での Pin の作成を拒否します。最初の実際の Pin で確認された Pinterest 側の文言は次のとおりです。「Trial アクセスを持つアプリは、本番環境で Pin を作成できない場合があります。」ボードと読み取りは Trial でも動作します（ボードの一覧、ボードの作成、Pin の読み取り）。Hermoso のエラーは、再接続を促すのではなくアクセスのティアを明示します。再接続では解決しないためです。Pin の作成を可能にするのは Standard アクセスへのアップグレードで、現在審査中です。同じティアの制限は有料側にも及びます。Trial では、Pinterest は広告アカウントをまったく提供しません。
自動化の前に知っておくべき Pinterest の上限
| テキスト | Pin の説明は800文字、タイトルは100文字が上限です。投稿の作成またはキューへの追加時に適用されるため、文字数オーバーの投稿は、送信途中で黙って切られるのではなく、あなたがその場で修正できるうちに拒否されます。 |
|---|---|
| 公開範囲 | 公開範囲はボードで決まり、Pin ごとではありません。Pin はボードの公開・非公開の状態を引き継ぐため、「非公開にしたい」場合は非公開のボードを選びます。そのため、ボードは既定値ではなく必須の引数になっています。 |
| カルーセル | 2〜5枚の画像のみ。上限と下限はどちらも Pinterest 自身の v5 OpenAPI から直接取っています（minItems: 2、maxItems: 5）。これは Pinterest が公開している唯一の機械可読な情報源です（開発者サイトはクライアント側で描画されるアプリで、取得しても何も返しません）。複数動画のソースはないため、動画のスライドは黙って落とされるのではなく、拒否されます。 |
| どのアカウントか | boardId です。これは、公開時ではなくキューへの追加時に拒否される唯一の投稿元フィールドです。省略すると何も予約されません。「間違ったボードに Pin するのは公開上のミスになるため、当社が勝手に選ぶことはありません。」 |
Claude Code で試す
普通の言葉で頼んでください。これは DSL ではなく、普通の文章です。
「製品ラインごとにボードを作成し、それぞれに縦型ピンを5枚、タイトルと説明付きで生成して、計画全体を投稿可能な状態で ./out/pinterest.json に書き出してください。」
これは list_pinterest_boards → plan_ad → generate_image → post_to_pinterest の流れです。Claude Code はツールを実行する前に確認を求め、やり取りはターミナルに残るため、投稿の手順は y を押す前に目で確認できます。
Pinterest での Claude Code：要注意の点
今の段階では、ピンの直前までをスクリプトで準備して止めるのが適切な形です。ボードの読み書きはトライアルアクセスで可能ですが、本番環境では Pinterest 自身がピン作成を拒否します。また boardId は、Hermoso が投稿時ではなくキュー登録時に拒否する唯一の識別項目です。「間違ったボードへのピンは公開上の誤りになるため、こちらで選ぶことはしない」という考えによります。
プラグインにはツールのマニフェストがありません。これは、長時間の無人実行で特に重要です。エージェントは工程ごとに hermoso コマンドをシェルから呼び出し、どのコマンドにも付けられる --json によって、検証可能な機械向けの出力を得ます。
投稿の前に Pinterest をリサーチする
Pinterest の広告ライブラリはないため、Hermoso は Pinterest での競合リサーチをうたっていません。そこで配信するクリエイティブは、スタジオの残りの機能でカバーできます。make_template_ad と画像モデルは、このチャネルで評価されやすい、縦長でテキスト重視の静止画を作ります。
有料の側
Pinterest 広告のツール（キャンペーン、広告グループ、既存の Pin を宣伝する広告）はあります。Pinterest の広告 API には削除の操作がないため、削除ではなくアーカイブで対応します。オーガニックの Pin とボードは delete_pinterest_pin と delete_pinterest_board で削除できますが、有料の項目はアーカイブしかできません。ただし、Pin の作成をブロックするのと同じ Trial アクセスのティアでは広告アカウントが提供されないため、Standard アクセスが利用可能になるまで広告の書き込みは使えません。これが正直な現状です。締め切り直前に気づくより、ここで一文で伝えるほうがよいでしょう。
Claude Code だけではできないこと
予算を持ったエージェントは、被害の範囲が限られていて初めて役に立つので、囲いはプロンプトではなくサーバー側にあります。すべての広告キャンペーン、広告セット、広告グループ、広告は一時停止の状態で作成され、実際のお金を動かす支出の切り替えは、明示的な確認フラグなしでは実行されません。すべてのレンダリングは、まず見積もられます（hermoso_capabilities が、支出の前に各モデルの正確なクレジット費用を公開します）。クレジットは最初のプロバイダー呼び出しの前に確保され、後で正確な費用で精算されるので、送信に失敗しても、何も得られないのに請求されることはありません。削除も確認が必要で、エージェントが何を作ったかを伝える前に、すべてのキャンペーンのツリーは広告プラットフォームから読み戻されます。
あえて完全なヘッドレスにしていない手順が一つあります。アカウントの接続は OAuth の同意画面なので、ブラウザでチャンネルを一度接続します。そのあとはすべてツール呼び出しです。
その他のマトリクス
Claude Code から投稿できる先: Facebook · Instagram · Threads · TikTok · YouTube · X · LinkedIn · Bluesky · Telegram。または Claude Code から投稿できるすべての先をご覧ください。
Pinterest への投稿元: Claude · ChatGPT · Cursor · Codex · Cline · OpenClaw · Grok Bot · Hermes · Gemini CLI · Perplexity · Le Chat · Claude Cowork · Perplexity Computer · Paperclip · Claude Code マーケティング
よくある質問
Claude Code から Pinterest に投稿できますか？
はい。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+ 個のツールを使えるようになります。Pinterest に投稿するツールのほか、市場で配信中の広告をリサーチするツールや、そもそもクリエイティブを生成するツールも含まれます。
Pinterest を 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 で Pinterest を接続します。ブラウザで OAuth の同意画面が開きます。その後は、Claude Code が通常のツール呼び出しとして Pinterest に投稿します。
Claude Code で Pinterest にカルーセルを投稿できますか？
原則としては可能です。2〜5枚の画像のみで、Pinterest 自身の v5 OpenAPI に基づきます。実際には、このアプリが Trial アクセスを持つ間は、本番環境で Pin の作成そのものがブロックされています。Claude Code はどちらの場合も同じ公開ツールを呼び出し、カルーセルを扱えないチャネルには、その理由を添えて拒否されます。
Claude Code で Pinterest の投稿を後から予約できますか？
はい。schedule_post は、他のすべてのチャンネルと共有する一つのカレンダーに投稿を入れます。キャプションを変えたい場合は、チャンネルごとに付けられます。list_scheduled と cancel_scheduled で読み取りと取り消しができます。Pinterest は、キューに入る十一チャンネルの一つです。
Claude Code に Pinterest のパスワードを渡す必要がありますか？
いいえ。Pinterest は、ブラウザでの OAuth 同意画面を通して一度だけ Hermoso に接続します。その後、Claude Code はツール呼び出しとしてそれを使います。アカウントの接続は唯一ヘッドレスではない手順で、それ以降はパスワードは不要で、認証情報がモデルに渡されることは一切ありません。
Claude Code から Pinterest に投稿するのにコストはかかりますか？
Pinterest は API 呼び出しごとの料金がないため、公開にクレジットはかかりません。クレジットを使うのは Pin のクリエイティブを生成するときです。プランは月額 $29、$69、$149 で、それぞれ 1,200、3,000、7,000 クレジットです。すべての機能は Free プランを含む全プランで使えます。例外はエンタープライズ SSO だけです。