Hermoso はマーケティング用の MCP サーバーです。922+ のツールを一つの OAuth 対応エンドポイントで提供し、エージェントが市場で既に配信されている広告をリサーチし、完成した画像と動画の広告を生成し、それらを投稿し、その背後にある有料キャンペーンを作れるようにします。Cursor は一つの接続からこれらすべてを使えます。このページでは、その中の一部を扱います。Cursor が Pinterest で実際に何をできて、Pinterest が何をさせないかです。
Hermoso を Cursor に接続する
- インストールとサインイン。
ブラウザが1回開きます。作成も貼り付けも不要です。認証情報は所有者のみが読める形でnpm install -g hermoso && hermoso auth login~/.hermoso/config.jsonに保存されます。ブラウザのないマシンでは、MCP & CLI → Terminal & API keys で作成したキーをhermoso auth login --token hmk_…で渡してください。 ~/.cursor/mcp.jsonに追加(またはプロジェクトの.cursor/mcp.json)。hermoso mcpは上で行ったサインインを読み込むため、ファイルにキーは書きません:{ "mcpServers": { "hermoso": { "command": "npx", "args": ["-y", "hermoso", "mcp"] } } }- またはワンクリックインストールは MCP のページから行えます。このディープリンクは、ホストされた URL をインストールし、認証は Cursor 自身の OAuth フローに任せます。どちらも使えますが、前提条件が異なります。
- Cursor に何かを頼みます。「競合上位3社の、最も長く配信されている広告を取得して、一番良いフックを9:16の動画にリミックスして」、または「このレンダリングをチャンネルに投稿して」。エージェントがツールを選び、支出はあなたが承認します。
上のブロックは、公開済みの hermoso npm パッケージをマシン上で実行します。そのためキーを貼り付ける必要はなく、ツールを呼び出すまではツール一覧のコストもかかりません。代わりにディープリンクを使う場合は、Cursor が認可サーバーに対して動的クライアント登録を行うため、やはりキーを持つ必要はありません。
その後、Hermoso の 設定 → コネクタ で Pinterest 自体を一度接続してください。これはブラウザでの OAuth 同意画面なので、唯一ブラウザが必要な手順です。そのあとはすべてツール呼び出しです。
Cursor が使える 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 するのは公開上のミスになるため、当社が勝手に選ぶことはありません。」 |
Cursor で試す
普通の言葉で頼んでください。これは DSL ではなく、普通の文章です。
「このリポジトリの製品ページごとに、縦型のピン画像、100 文字以内のタイトル、800 文字以内の説明文を生成し、./out/pins.json に書き出してください。」
これは list_pinterest_boards → plan_ad → generate_image → post_to_pinterest の流れです。Cursor は各ツール呼び出しを、実行前にコンポーザーに表示します。そのため、投稿は偶然起きる副作用ではなく、クリック1回の操作になります。
Pinterest での Cursor：要注意の点
トライアルアクセスのアプリでは、本番環境でピン作成がブロックされている間、全体をデータとして準備しておくのが生産的な進め方です。クリエイティブ、コピー、リンク先の準備という時間のかかる部分は、今でも進められます。ボードの一覧取得と作成はトライアルでも動くため、計画だけでなく実際のボード構成を作れます。
特定のブランドに常に紐づけたいリポジトリでは、ホームディレクトリではなくプロジェクトの .cursor/mcp.json に設定を置いてください。そうしないと、hermoso auth login が使うワークスペースが固定されません。
投稿の前に Pinterest をリサーチする
Pinterest の広告ライブラリはないため、Hermoso は Pinterest での競合リサーチをうたっていません。そこで配信するクリエイティブは、スタジオの残りの機能でカバーできます。make_template_ad と画像モデルは、このチャネルで評価されやすい、縦長でテキスト重視の静止画を作ります。
有料の側
Pinterest 広告のツール（キャンペーン、広告グループ、既存の Pin を宣伝する広告）はあります。Pinterest の広告 API には削除の操作がないため、削除ではなくアーカイブで対応します。オーガニックの Pin とボードは delete_pinterest_pin と delete_pinterest_board で削除できますが、有料の項目はアーカイブしかできません。ただし、Pin の作成をブロックするのと同じ Trial アクセスのティアでは広告アカウントが提供されないため、Standard アクセスが利用可能になるまで広告の書き込みは使えません。これが正直な現状です。締め切り直前に気づくより、ここで一文で伝えるほうがよいでしょう。
Cursor だけではできないこと
予算を持ったエージェントは、被害の範囲が限られていて初めて役に立つので、囲いはプロンプトではなくサーバー側にあります。すべての広告キャンペーン、広告セット、広告グループ、広告は一時停止の状態で作成され、実際のお金を動かす支出の切り替えは、明示的な確認フラグなしでは実行されません。すべてのレンダリングは、まず見積もられます（hermoso_capabilities が、支出の前に各モデルの正確なクレジット費用を公開します）。クレジットは最初のプロバイダー呼び出しの前に確保され、後で正確な費用で精算されるので、送信に失敗しても、何も得られないのに請求されることはありません。削除も確認が必要で、エージェントが何を作ったかを伝える前に、すべてのキャンペーンのツリーは広告プラットフォームから読み戻されます。
あえて完全なヘッドレスにしていない手順が一つあります。アカウントの接続は OAuth の同意画面なので、ブラウザでチャンネルを一度接続します。そのあとはすべてツール呼び出しです。
その他のマトリクス
Cursor からの投稿先: Facebook · Instagram · Threads · TikTok · YouTube · X · LinkedIn · Bluesky · Telegram。または Cursor から投稿できるすべての先をご覧ください。
Pinterest への投稿元: Claude · ChatGPT · Claude Code · Codex · Cline · OpenClaw · Grok Bot · Hermes · Gemini CLI · Perplexity · Le Chat · Claude Cowork · Perplexity Computer · Paperclip
よくある質問
Cursor から Pinterest に投稿できますか？
はい、Hermoso の MCP サーバー経由で可能です。npm install -g hermoso && hermoso auth login を実行し、~/.cursor/mcp.json が npx -y hermoso mcp を指すようにします。ブラウザでサインインすると認証情報が保存されるため、ファイルにキーは書かれません。その後、Cursor では 922 以上のツールが使えます。Pinterest に投稿するツールや、市場で配信中の広告を調べるツール、クリエイティブを作成するツールも含まれます。
Pinterest を Cursor に接続するには？
手順は2つ、それぞれ一度だけです。npm install -g hermoso && hermoso auth login を実行し、~/.cursor/mcp.json が npx -y hermoso mcp を指すようにします。ブラウザでサインインすると認証情報が保存されるため、ファイルにキーは書かれません。次に Hermoso の 設定 → コネクタ で Pinterest を接続します。ブラウザ上の OAuth 同意画面です。以降、Cursor は通常のツール呼び出しとして Pinterest に投稿します。
Cursor から Pinterest に非公開や下書きで投稿できますか？
Pinterest の公開範囲は Pin ではなくボードで決まります。Pin はボードの公開・非公開の状態を引き継ぐため、ボードは既定値ではなく必須の引数になっています。Hermoso は、Pinterest が対応できない公開範囲を指定された場合、より弱い形で黙って公開するのではなく、その場で拒否します。
Cursor で、投稿だけでなく Pinterest 広告も運用できますか？
Pinterest 広告のツール（キャンペーン、広告グループ、Pin を宣伝する広告）はありますが、Pin の作成をブロックするのと同じ Trial アクセスのティアでは広告アカウントが提供されないため、Standard アクセスが利用可能になるまで広告の書き込みは使えません。
Cursor から投稿するときの Pinterest の文字数上限は？
Pin の説明は800文字、タイトルは100文字が上限です。Hermoso は投稿の作成またはキューへの追加時に適用するため、Cursor にはすぐに伝わります。誰も見ていないときに後から失敗することはありません。
Cursor は、投稿の前に Pinterest をリサーチできますか？
Pinterest の広告ライブラリはなく、Hermoso はそこでの競合リサーチをうたいません。リサーチ機能のそのほかの部分はそのまま使えます。Meta、Google、LinkedIn の広告ライブラリや、オーガニックの TikTok、Instagram、YouTube、Reddit、Threads です。