Hermoso はマーケティング用の MCP サーバーです。922+ のツールを一つの OAuth 対応エンドポイントで提供し、エージェントが市場で既に配信されている広告をリサーチし、完成した画像と動画の広告を生成し、それらを投稿し、その背後にある有料キャンペーンを作れるようにします。Gemini CLI は一つの接続からこれらすべてを使えます。このページでは、その中の一部を扱います。Gemini CLI が Pinterest で実際に何をできて、Pinterest が何をさせないかです。
Hermoso を Gemini CLI に接続する
- 拡張機能をインストールします。
Hermoso の公開リポジトリの最新リリースをインストールします。これには 5 つのスキル(research、ad-from-brand、generate、product-photoshoot、marketing)とgemini extensions install https://github.com/hermoso-ai/hermosoGEMINI.mdコンテキストファイルが含まれます。スキルはnpxを通じてhermosoコマンドを実行するため、Gemini CLI のツール一覧には何も追加されず、コマンドが実行されるまでコンテキストも消費しません。gemini extensions listでは、スキルが Agent skills の下に表示されます。 - 一度サインインします。
ブラウザでのサインインが開き、所有者のみが読める認証情報をnpx -y hermoso auth login~/.hermoso/config.jsonに保存します。Gemini CLI は、Hermoso が初めて必要になったときに、代わりにこれを実行できます。そのマシンにブラウザがない場合は、MCP & CLI → Terminal & API keys でキーを作成し、npx -y hermoso auth login --token hmk_…を実行してください。 - 任意: MCP サーバーも追加する場合。
最初の接続が 401 を返すと、Gemini CLI は Hermoso の認可サーバーを見つけて自分自身を登録するため、gemini mcp add --scope user --transport http hermoso https://app.hermoso.ai/mcpsettings.jsonにキーを書く必要はありません。セッション内で/mcp auth hermosoを実行するとサインインできます。スキルは、これがなくてもすべてのツールに届きます。 - Gemini CLI に何かを頼みます。「競合上位3社の、最も長く配信されている広告を取得して、一番良いフックを9:16の動画にリミックスして」、または「このレンダリングをチャンネルに投稿して」。エージェントがツールを選び、支出はあなたが承認します。
上記のインストールは、2026-09-23 に、クリーンなホームディレクトリで Gemini CLI 0.60.0 を使って実行しました。hermoso-ai/hermoso の最新リリースを取得し、gemini extensions list に 5 つのスキルとコンテキストファイルが表示されました。拡張機能は独自の MCP サーバーを持ちません。これは意図的です。ツール一覧はすべてのセッションに読み込まれますが、スキルは実行されるまで何のコストもかからないからです。Hermoso は Google と提携しておらず、そのように主張することもありません。
その後、Hermoso の 設定 → コネクタ で Pinterest 自体を一度接続してください。これはブラウザでの OAuth 同意画面なので、唯一ブラウザが必要な手順です。そのあとはすべてツール呼び出しです。
Gemini CLI が使える 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 するのは公開上のミスになるため、当社が勝手に選ぶことはありません。」 |
Gemini CLI で試す
普通の言葉で頼んでください。これは DSL ではなく、普通の文章です。
“秋のラインのボードを作成し、タイトルと説明文付きの縦型 Pin 画像を 6 枚生成して、そのセットを ./out/pins.json に書き出してください。”
流れは list_pinterest_boards → plan_ad → generate_image → post_to_pinterest です。Gemini CLI はシェルコマンドを実行する前に確認を求め、スキルは hermoso コマンドを通じて動くため、公開は「はい」と答える前に読める 1 行として表示されます。MCP ツールについては、1 回だけ許可するか、そのツールを常に許可するか、サーバーを常に許可するかを選べます。
Pinterest での Gemini CLI:要注意の点
Pin は今のうちにデータとして準備しておいてください。ボードは Trial アクセスでも一覧表示と作成ができます。Pin の作成は、Pinterest 自身が本番環境で拒否しており、どの再試行もアクセス階層を変えません。Standard アクセスが開通したら、準備したファイルがそのままバッチになります。boardId は必須で、欠けていればキューに入れる時点で拒否されます。間違ったボードの Pin は、公開の誤りになるからです。
Gemini CLI で、この安全性を決める 2 つの詳細があります。gemini mcp add は、--scope user を渡さない限り、プロジェクトの .gemini/settings.json に書き込みます。1 つのリポジトリを常に 1 つのブランドで動かしたい場合は、これが役立ちます。また、Hermoso を --trust 付きで追加しないでください。サーバーに対するすべての確認をスキップしてしまい、公開の前に出る確認も含まれます。MCP ツールは mcp_hermoso_ とツール名を組み合わせた名前で届き、--exclude-tools を使えば、いくつでも完全に除外できます。
投稿の前に Pinterest をリサーチする
Pinterest の広告ライブラリはないため、Hermoso は Pinterest での競合リサーチをうたっていません。そこで配信するクリエイティブは、スタジオの残りの機能でカバーできます。make_template_ad と画像モデルは、このチャネルで評価されやすい、縦長でテキスト重視の静止画を作ります。
有料の側
Pinterest 広告のツール(キャンペーン、広告グループ、既存の Pin を宣伝する広告)はあります。Pinterest の広告 API には削除の操作がないため、削除ではなくアーカイブで対応します。オーガニックの Pin とボードは delete_pinterest_pin と delete_pinterest_board で削除できますが、有料の項目はアーカイブしかできません。ただし、Pin の作成をブロックするのと同じ Trial アクセスのティアでは広告アカウントが提供されないため、Standard アクセスが利用可能になるまで広告の書き込みは使えません。これが正直な現状です。締め切り直前に気づくより、ここで一文で伝えるほうがよいでしょう。
Gemini CLI だけではできないこと
予算を持ったエージェントは、被害の範囲が限られていて初めて役に立つので、囲いはプロンプトではなくサーバー側にあります。すべての広告キャンペーン、広告セット、広告グループ、広告は一時停止の状態で作成され、実際のお金を動かす支出の切り替えは、明示的な確認フラグなしでは実行されません。すべてのレンダリングは、まず見積もられます(hermoso_capabilities が、支出の前に各モデルの正確なクレジット費用を公開します)。クレジットは最初のプロバイダー呼び出しの前に確保され、後で正確な費用で精算されるので、送信に失敗しても、何も得られないのに請求されることはありません。削除も確認が必要で、エージェントが何を作ったかを伝える前に、すべてのキャンペーンのツリーは広告プラットフォームから読み戻されます。
あえて完全なヘッドレスにしていない手順が一つあります。アカウントの接続は OAuth の同意画面なので、ブラウザでチャンネルを一度接続します。そのあとはすべてツール呼び出しです。
その他のマトリクス
Gemini CLI から次に投稿: Facebook · Instagram · Threads · TikTok · YouTube · X · LinkedIn · Bluesky · Telegram。またはGemini CLI で投稿できるすべてをご覧ください。
次から Pinterest に投稿: Claude · ChatGPT · Claude Code · Cursor · Codex · Cline · OpenClaw · Grok Bot · Hermes · Perplexity · Le Chat · Claude Cowork · Perplexity Computer · Paperclip
よくある質問
Gemini CLI から Pinterest に投稿できますか?
はい、Hermoso の Gemini CLI 拡張機能で可能です。gemini extensions install https://github.com/hermoso-ai/hermoso を実行すると、hermoso コマンドを操作する Hermoso のスキルが 5 つ追加されます。その後、npx -y hermoso auth login で一度サインインしてください。サインインではブラウザが開き、認証情報は自動的に保存されるため、作成するキーも貼り付けるキーもありません。Gemini CLI 自身のツール一覧にも Hermoso のツールを入れたい場合は、gemini mcp add --scope user --transport http hermoso https://app.hermoso.ai/mcp で、OAuth でサインインするホスト型サーバーを追加できます。これで Gemini CLI は 922+ のツールを使えるようになります。Pinterest への投稿ツールや、市場で配信中の広告をリサーチするツール、そもそもクリエイティブをレンダリングするツールも含まれます。
Pinterest を Gemini CLI に接続するには?
2 つの手順で、それぞれ 1 回だけ行います。gemini extensions install https://github.com/hermoso-ai/hermoso を実行すると、hermoso コマンドを操作する Hermoso のスキルが 5 つ追加されます。その後、npx -y hermoso auth login で一度サインインしてください。サインインではブラウザが開き、認証情報は自動的に保存されるため、作成するキーも貼り付けるキーもありません。Gemini CLI 自身のツール一覧にも Hermoso のツールを入れたい場合は、gemini mcp add ... で OAuth でサインインするホスト型サーバーを追加できます。次に Hermoso の 設定 → コネクタ で Pinterest を接続します。これはブラウザで表示される OAuth の同意画面です。その後は、Gemini CLI が Pinterest への投稿を通常のツール呼び出しとして実行できます。
Gemini CLI から投稿するときの Pinterest の文字数上限は?
Pin の説明は800文字、タイトルは100文字が上限です。Hermoso は投稿の作成またはキューへの追加時に適用するため、Gemini CLI にはすぐに伝わります。誰も見ていないときに後から失敗することはありません。
Gemini CLI は、投稿の前に Pinterest をリサーチできますか?
Pinterest の広告ライブラリはなく、Hermoso はそこでの競合リサーチをうたいません。リサーチ機能のそのほかの部分はそのまま使えます。Meta、Google、LinkedIn の広告ライブラリや、オーガニックの TikTok、Instagram、YouTube、Reddit、Threads です。
Gemini CLI から Pinterest に非公開や下書きで投稿できますか?
Pinterest の公開範囲は Pin ではなくボードで決まります。Pin はボードの公開・非公開の状態を引き継ぐため、ボードは既定値ではなく必須の引数になっています。Hermoso は、Pinterest が対応できない公開範囲を指定された場合、より弱い形で黙って公開するのではなく、その場で拒否します。
Gemini CLI で、投稿だけでなく Pinterest 広告も運用できますか?
Pinterest 広告のツール(キャンペーン、広告グループ、Pin を宣伝する広告)はありますが、Pin の作成をブロックするのと同じ Trial アクセスのティアでは広告アカウントが提供されないため、Standard アクセスが利用可能になるまで広告の書き込みは使えません。