pp-mailchimp

Mailchimp — Printing Press CLI

前提条件：CLI のインストール

このスキルは mailchimp-pp-cli バイナリを使用します。**このスキルのコマンドを実行する前に、CLI がインストールされていることを必ず確認してください。**インストールされていない場合は、先にインストールしてください。

1. Printing Press インストーラーを使用してインストールします。バイナリの既定のインストール先は、macOS/Linux では $HOME/.local/bin、Windows では %LOCALAPPDATA%\Programs\PrintingPress\bin です。

   npx -y @mvanhorn/printing-press-library install mailchimp --cli-only
   

2. 確認します：mailchimp-pp-cli --version
3. スキルを実行するエージェント／ランタイムから、表示されたインストール先ディレクトリに $PATH を通してください。

npx によるインストールに失敗した場合（Node がない、オフラインなど）は、Go を直接インストールしてください（Go 1.26.6 以降が必要です）。

go install github.com/mvanhorn/printing-press-library/library/marketing/mailchimp/cmd/mailchimp-pp-cli@latest

インストール後に --version で「command not found」と表示される場合、ランタイムからバイナリのディレクトリに $PATH が通っていません。確認が成功するまで、スキルのコマンドを実行しないでください。

この CLI を使用する場面

ターミナルまたはエージェントから Mailchimp を操作し、複数のエンドポイントにまたがるワークフローが必要な場合にこの CLI を使用します。たとえば、タグを付けて連絡先を登録する、バッチエンドポイント経由で CSV をインポートする、キャンペーンの効果を測定する、セグメントの健全性を監査するといった場面です。ローカルの SQLite キャッシュを使うと、オーディエンスを SQL でクエリできます。これはダッシュボードや SDK では不可能です。MCP のインターフェースでは、約 1K トークンで 291 個のエンドポイントをコードでオーケストレーションできるため、ツールリストを膨らませることなく、エージェントからあらゆる Mailchimp エンドポイントにアクセスできます。

独自の機能

この API に対して、ほかのツールでは利用できない機能です。

ワークフローの構成

• subscribe — メールアドレスでメンバーをアップサートし、1 つのコマンドでタグを適用します。MD5 サブスクライバーハッシュを自動計算するため、ハッシュを意識する必要はありません。

  エージェントがタグ付きで連絡先を追加する場合、MD5 ハッシュの計算を挟んだ 3 回の呼び出しではなく、1 回の呼び出しで済みます。

  mailchimp-pp-cli subscribe [email protected] --list a1b2c3d4e5 --tags vip,onboarding --merge FNAME=Alice
  

• bulk-subscribe — CSV を読み込み、Mailchimp の /batches エンドポイント（公式の同時接続数 10 の制限を回避する手段）経由で処理を分散し、完了するまでポーリングします。10 分間のレスポンス URL の有効期間内に、JSONL の結果を含む tar.gz をデコードし、行ごとの結果を出力します。

  エージェントが一度に約 50 件を超える連絡先を登録する場合、レート制限を守り、行ごとの実用的な結果を返す安全な方法はこれだけです。

  mailchimp-pp-cli bulk-subscribe --csv contacts.csv --list a1b2c3d4e5 --tags newsletter --watch
  

ローカル結合で広がる分析

• digest — 単一キャンペーンモード（digest ）では、レポート、メールアクティビティ、eコマースの商品アクティビティを結合し、開封数／クリック数／バウンス数／売上に加えて、クリック数の多いリンクとコンバージョン数の多い商品を含むサマリーを作成します。ロールアップモード（digest --last N または --week）では、集計統計を含む複数キャンペーンのサマリーテーブルを作成します。--md を指定すると、どちらのモードもそのまま貼り付けられる Markdown で出力します。

  キャンペーンごとの分析には digest 、週次のロールアップには digest --last N を使用します。どちらのペルソナにも必要な、ドキュメントに貼り付けられる形式は --md で出力できます。

  mailchimp-pp-cli digest --last 5 --md
  

• segments audit — 空のセグメント、90 日間増加していないセグメント、最近のキャンペーンで参照されていないセグメントを見つけます。セグメントエンドポイントを読み込み、ローカルの SQLite ストアにあるメンバー数と結合します。

  オーディエンスを整理するときや、セグメンテーションの状態を監査するときに、不要になったものを 1 回の呼び出しで明らかにします。

  mailchimp-pp-cli segments audit --list a1b2c3d4e5 --json
  

• attribution — キャンペーンの eコマース商品アクティビティレポートと同期済みのストア注文を結合し、アトリビューション対象の売上、アトリビューション対象売上が多い商品、コンバージョン率（注文数を開封数で割った値）を算出します。

  キャンペーンが売上につながったかを測定するときに使う、唯一のコマンドです。

  mailchimp-pp-cli attribution 7f8a9b0c1d --store mystore --json
  

• deliverability — 直近 N 件のキャンペーンについて、ドメインパフォーマンスレポートを集計します。ドメイン（gmail.com、yahoo.com、outlook.com）ごとのバウンス率、迷惑メール率、開封率、クリック率を表示します。アカウント平均を下回るドメインを強調表示します。

  到達率の低下を調査するとき、レポートページを 10 件個別に開かなくても、どの受信プロバイダーのパフォーマンスが悪化しているかがわかります。

  mailchimp-pp-cli deliverability --last 10 --json
  

• compare — 2 件のキャンペーンの指標を並べて比較します。両方のキャンペーンのレポートとメールアクティビティを並列で取得し、開封率／CTR／クリック・開封率／バウンス数／配信停止数／売上について、指標ごとの勝者を表示して差分を算出し、件名、送信時刻、オーディエンスの規模など、主な違いを示します。--md を指定すると、そのまま貼り付けられる Markdown で出力します。

  「どちらのキャンペーンが成果を上げたか」「変更の効果はあったか」と確認するときに使う、唯一のコマンドです。--md モードなら、週次レビューのドキュメントに貼り付けられます。

  mailchimp-pp-cli compare 7f8a9b0c1d 8c9d0e1f2a --md
  

運用上の安全性

• send-checked — 送信前に公式の送信チェックリストを実行します。type=error の項目があるか、is_ready=false の場合は、該当項目を表示して終了コード 2 で終了します。それ以外の場合は送信します。

  パイプラインからキャンペーンを送信する場合の安全なデフォルトです。不備のあるキャンペーンが気付かれないまま配信されることはありません。

  mailchimp-pp-cli send-checked 7f8a9b0c1d
  

コマンドリファレンス

account-exports — アカウントのエクスポートを管理します

• mailchimp-pp-cli account-exports get — 指定したアカウントのエクスポート一覧を取得します。
• mailchimp-pp-cli account-exports get-id — 特定のアカウントエクスポートに関する情報を取得します。
• mailchimp-pp-cli account-exports post — Mailchimp アカウントに新しいアカウントエクスポートを作成します。

activity-feed — アクティビティフィードを管理します

• mailchimp-pp-cli activity-feed — このアカウントの Chimp Chatter を、最新のものから順に返します。

audiences — オーディエンスを管理します

• mailchimp-pp-cli audiences get-contacts — アカウント内のすべてのオーディエンスに関する情報を取得します。
• mailchimp-pp-cli audiences get-id — 特定のオーディエンスに関する情報を取得します。

authorized-apps — 認証済みアプリを管理します

• mailchimp-pp-cli authorized-apps get — アカウントに登録され、接続されているアプリケーションの一覧を取得します。
• mailchimp-pp-cli authorized-apps get-id — 特定の認証済みアプリケーションに関する情報を取得します。

automations — オートメーションを管理します

• mailchimp-pp-cli automations get — アカウントのクラシックオートメーションの概要を取得します。
• mailchimp-pp-cli automations get-id — 個々のクラシックオートメーションワークフローの設定とコンテンツの概要を取得します。trigger_settings オブジェクト...
• mailchimp-pp-cli automations post — Mailchimp アカウントに新しいクラシックオートメーションを作成します。

batch-webhooks — バッチ Webhook を管理します

• mailchimp-pp-cli batch-webhooks delete-id — バッチ Webhook を削除します。指定した URL への Webhook は送信されなくなります。
• mailchimp-pp-cli batch-webhooks get — バッチ用に設定されたすべての Webhook を取得します。
• mailchimp-pp-cli batch-webhooks get-batchwebhooks — 特定のバッチ Webhook に関する情報を取得します。
• mailchimp-pp-cli batch-webhooks patch — バッチリクエストの処理が完了するたびに実行される Webhook を更新します。
• mailchimp-pp-cli batch-webhooks post — バッチリクエストの処理が完了するたびに実行される Webhook を設定します。最大で...

batches — バッチを管理

• mailchimp-pp-cli batches delete-id — バッチリクエストの実行を停止します。一度に実行されるバッチリクエストは 1 つだけなので、長時間かかる...
• mailchimp-pp-cli batches get — これまでに行われたバッチリクエストの概要を取得します。
• mailchimp-pp-cli batches get-id — バッチリクエストのステータスを取得します。
• mailchimp-pp-cli batches post — バッチ操作リクエストの処理を開始します。

campaign-folders — キャンペーンフォルダーを管理

• mailchimp-pp-cli campaign-folders delete-id — 特定のキャンペーンフォルダーを削除し、フォルダー内のすべてのキャンペーンを「未分類」にします。
• mailchimp-pp-cli campaign-folders get — キャンペーンの整理に使用されているすべてのフォルダーを取得します。
• mailchimp-pp-cli campaign-folders get-id — キャンペーンの整理に使用されている特定のフォルダーに関する情報を取得します。
• mailchimp-pp-cli campaign-folders patch-id — キャンペーンの整理に使用されている特定のフォルダーを更新します。
• mailchimp-pp-cli campaign-folders post — 新しいキャンペーンフォルダーを作成します。

campaigns — キャンペーンを管理

• mailchimp-pp-cli campaigns delete-id — Mailchimp アカウントからキャンペーンを削除します。
• mailchimp-pp-cli campaigns get — アカウント内のすべてのキャンペーンを取得します。
• mailchimp-pp-cli campaigns get-id — 特定のキャンペーンに関する情報を取得します。
• mailchimp-pp-cli campaigns patch-id — 特定のキャンペーンの設定の一部またはすべてを更新します。
• mailchimp-pp-cli campaigns post — 新しい Mailchimp キャンペーンを作成します。

connected-sites — 接続済みサイトを管理

• mailchimp-pp-cli connected-sites delete-id — Mailchimp アカウントから接続済みサイトを削除します。
• mailchimp-pp-cli connected-sites get — アカウント内のすべての接続済みサイトを取得します。
• mailchimp-pp-cli connected-sites get-id — 特定の接続済みサイトに関する情報を取得します。
• mailchimp-pp-cli connected-sites post — 新しい Mailchimp 接続済みサイトを作成します。

conversations — 会話を管理

• mailchimp-pp-cli conversations get — アカウントの会話一覧を取得します。Conversations は非推奨となり、Inbox が後継となっています。これらのエンドポイント...
• mailchimp-pp-cli conversations get-id — 個々の会話の詳細を取得します。Conversations は非推奨となり、Inbox が後継となっています。これらの...

customer-journeys — カスタマージャーニーを管理

• mailchimp-pp-cli customer-journeys <journey_id> <step_id> — Automation フローのステップトリガーです。使用するには、Automation フロービルダーで開始点またはステップを作成します...

ecommerce — E コマースを管理

• mailchimp-pp-cli ecommerce delete-stores-id — ストアを削除します。ストアを削除すると、顧客や注文など、関連するサブリソースもすべて削除されます……

• mailchimp-pp-cli ecommerce delete-stores-id-carts-id — カートを削除します。

• mailchimp-pp-cli ecommerce delete-stores-id-carts-lines-id — 特定のカートの明細項目を削除します。

• mailchimp-pp-cli ecommerce delete-stores-id-customers-id — ストアから顧客を削除します。

• mailchimp-pp-cli ecommerce delete-stores-id-orders-id — 注文を削除します。

• mailchimp-pp-cli ecommerce delete-stores-id-orders-id-lines-id — 特定の注文の明細項目を削除します。

• mailchimp-pp-cli ecommerce delete-stores-id-products-id — 商品を削除します。

• mailchimp-pp-cli ecommerce delete-stores-id-products-id-images-id — 商品画像を削除します。

• mailchimp-pp-cli ecommerce delete-stores-id-products-id-variants-id — 商品バリエーションを削除します。

• mailchimp-pp-cli ecommerce delete-stores-id-promocodes-id — ストアからプロモーションコードを削除します。

• mailchimp-pp-cli ecommerce delete-stores-id-promorules-id — ストアからプロモーションルールを削除します。

• mailchimp-pp-cli ecommerce get-orders — アカウントの注文に関する情報を取得します。

• mailchimp-pp-cli ecommerce get-stores — アカウント内のすべてのストアに関する情報を取得します。

• mailchimp-pp-cli ecommerce get-stores-id — 特定のストアに関する情報を取得します。

• mailchimp-pp-cli ecommerce get-stores-id-carts — ストアのカートに関する情報を取得します。

• mailchimp-pp-cli ecommerce get-stores-id-carts-id — 特定のカートに関する情報を取得します。

• mailchimp-pp-cli ecommerce get-stores-id-carts-id-lines — カートの明細項目に関する情報を取得します。

• mailchimp-pp-cli ecommerce get-stores-id-carts-id-lines-id — 特定のカートの明細項目に関する情報を取得します。

• mailchimp-pp-cli ecommerce get-stores-id-customers — ストアの顧客に関する情報を取得します。

• mailchimp-pp-cli ecommerce get-stores-id-customers-id — 特定の顧客に関する情報を取得します。

• mailchimp-pp-cli ecommerce get-stores-id-orders — ストアの注文に関する情報を取得します。

• mailchimp-pp-cli ecommerce get-stores-id-orders-id — 特定の注文に関する情報を取得します。

• mailchimp-pp-cli ecommerce get-stores-id-orders-id-lines — 注文の明細項目に関する情報を取得します。

• mailchimp-pp-cli ecommerce get-stores-id-orders-id-lines-id — 特定の注文の明細項目に関する情報を取得します。

• mailchimp-pp-cli ecommerce get-stores-id-products — ストアの商品に関する情報を取得します。

• mailchimp-pp-cli ecommerce get-stores-id-products-id — 特定の商品に関する情報を取得します。

• mailchimp-pp-cli ecommerce get-stores-id-products-id-images — 商品画像に関する情報を取得します。

• mailchimp-pp-cli ecommerce get-stores-id-products-id-images-id — 特定の商品画像に関する情報を取得します。

• mailchimp-pp-cli ecommerce get-stores-id-products-id-variants — 商品のバリエーションに関する情報を取得します。

• mailchimp-pp-cli ecommerce get-stores-id-products-id-variants-id — 特定の商品バリエーションに関する情報を取得します。

• mailchimp-pp-cli ecommerce get-stores-id-promocodes — ストアのプロモーションコードに関する情報を取得します。

• mailchimp-pp-cli ecommerce get-stores-id-promocodes-id — 特定のプロモーションコードに関する情報を取得します。

• mailchimp-pp-cli ecommerce get-stores-id-promorules — ストアのプロモーションルールに関する情報を取得します。

• mailchimp-pp-cli ecommerce get-stores-id-promorules-id — 特定のプロモーションルールに関する情報を取得します。

• mailchimp-pp-cli ecommerce patch-stores-id — ストアを更新します。

• mailchimp-pp-cli ecommerce patch-stores-id-carts-id — 特定のカートを更新します。

• mailchimp-pp-cli ecommerce patch-stores-id-carts-id-lines-id — 特定のカートの明細項目を更新します。

• mailchimp-pp-cli ecommerce patch-stores-id-customers-id — 顧客を更新します。

• mailchimp-pp-cli ecommerce patch-stores-id-orders-id — 特定の注文を更新します。

• mailchimp-pp-cli ecommerce patch-stores-id-orders-id-lines-id — 特定の注文の明細項目を更新します。

• mailchimp-pp-cli ecommerce patch-stores-id-products-id — 特定の商品を更新します。

• mailchimp-pp-cli ecommerce patch-stores-id-products-id-images-id — 商品画像を更新します。

• mailchimp-pp-cli ecommerce patch-stores-id-products-id-variants-id — 商品バリエーションを更新します。

• mailchimp-pp-cli ecommerce patch-stores-id-promocodes-id — プロモーションコードを更新します。

• mailchimp-pp-cli ecommerce patch-stores-id-promorules-id — プロモーションルールを更新します。

• mailchimp-pp-cli ecommerce post-stores — Mailchimp アカウントに新しいストアを追加します。

• mailchimp-pp-cli ecommerce post-stores-id-carts — ストアに新しいカートを追加します。

• mailchimp-pp-cli ecommerce post-stores-id-carts-id-lines — 既存のカートに新しい明細項目を追加します。

• mailchimp-pp-cli ecommerce post-stores-id-customers — ストアに新しい顧客を追加します。

• mailchimp-pp-cli ecommerce post-stores-id-orders — ストアに新しい注文を追加します。

• mailchimp-pp-cli ecommerce post-stores-id-orders-id-lines — 既存の注文に新しい明細項目を追加します。

• mailchimp-pp-cli ecommerce post-stores-id-products — ストアに新しい商品を追加します。

• mailchimp-pp-cli ecommerce post-stores-id-products-id-images — 商品に新しい画像を追加します。

• mailchimp-pp-cli ecommerce post-stores-id-products-id-variants — 商品に新しいバリエーションを追加します。

• mailchimp-pp-cli ecommerce post-stores-id-promocodes — ストアに新しいプロモーションコードを追加します。

• mailchimp-pp-cli ecommerce post-stores-id-promorules — ストアに新しいプロモーションルールを追加します。

• mailchimp-pp-cli ecommerce put-stores-id-customers-id — 顧客を追加または更新します。

• mailchimp-pp-cli ecommerce put-stores-id-orders-id — 注文を追加または更新します。

• mailchimp-pp-cli ecommerce put-stores-id-products-id — 特定の商品を更新します。

• mailchimp-pp-cli ecommerce put-stores-id-products-id-variants-id — 商品バリエーションを追加または更新します。 facebook-ads — Facebook 広告を管理

• mailchimp-pp-cli facebook-ads get-all — Facebook 広告の一覧を取得します。

• mailchimp-pp-cli facebook-ads get-id — Facebook 広告の詳細を取得します。

file-manager — ファイルマネージャーを管理

• mailchimp-pp-cli file-manager delete-files-id — ファイルマネージャーから特定のファイルを削除します。
• mailchimp-pp-cli file-manager delete-folders-id — ファイルマネージャー内の特定のフォルダーを削除します。
• mailchimp-pp-cli file-manager get-files — アカウントのファイルマネージャーに保存されている画像とファイルの一覧を取得します。
• mailchimp-pp-cli file-manager get-files-id — ファイルマネージャー内の特定のファイルに関する情報を取得します。
• mailchimp-pp-cli file-manager get-folders — ファイルマネージャー内のすべてのフォルダーの一覧を取得します。
• mailchimp-pp-cli file-manager get-folders-files — このフォルダーに保存されている画像とファイルの一覧を取得します。
• mailchimp-pp-cli file-manager get-folders-id — ファイルマネージャー内の特定のフォルダーに関する情報を取得します。
• mailchimp-pp-cli file-manager patch-files-id — ファイルマネージャー内のファイルを更新します。
• mailchimp-pp-cli file-manager patch-folders-id — ファイルマネージャー内の特定のフォルダーを更新します。
• mailchimp-pp-cli file-manager post-files — ファイルマネージャーに新しい画像またはファイルをアップロードします。
• mailchimp-pp-cli file-manager post-folders — ファイルマネージャーに新しいフォルダーを作成します。

landing-pages — ランディングページを管理

• mailchimp-pp-cli landing-pages delete-id — ランディングページを削除します。
• mailchimp-pp-cli landing-pages get-all — すべてのランディングページを取得します。
• mailchimp-pp-cli landing-pages get-id — 特定のページに関する情報を取得します。
• mailchimp-pp-cli landing-pages patch-id — ランディングページを更新します。
• mailchimp-pp-cli landing-pages post-all — 未公開でコンテンツのない Mailchimp ランディングページを作成します。

lists — リストを管理

• mailchimp-pp-cli lists delete-id — Mailchimp アカウントからリストを削除します。リストを削除すると、購読者を含むリストの履歴が失われます...
• mailchimp-pp-cli lists get — アカウント内のすべてのリストに関する情報を取得します。
• mailchimp-pp-cli lists get-id — Mailchimp アカウント内の特定のリストに関する情報を取得します。結果には、登録済みのリストメンバーが含まれますが...
• mailchimp-pp-cli lists patch-id — 特定のリストの設定を更新します。
• mailchimp-pp-cli lists post — Mailchimp アカウントに新しいリストを作成します。
• mailchimp-pp-cli lists post-id — リストメンバーを一括で購読または購読解除します。

ping — ping を管理

• mailchimp-pp-cli ping — アカウント固有の情報を返さない、API のヘルスチェックです。

reporting — レポート機能を管理

• mailchimp-pp-cli reporting get-facebook-ads — Facebook 広告のレポートを取得します。
• mailchimp-pp-cli reporting get-facebook-ads-id — Facebook 広告のレポートを取得します。
• mailchimp-pp-cli reporting get-facebook-ads-id-ecommerce-product-activity — アウトリーチの商品アクティビティの内訳を取得します。
• mailchimp-pp-cli reporting get-landing-pages — ランディングページのレポートを取得します。
• mailchimp-pp-cli reporting get-landing-pages-id — ランディングページのレポートを取得します。
• mailchimp-pp-cli reporting get-surveys — アンケートのレポートを取得します。
• mailchimp-pp-cli reporting get-surveys-id — アンケートのレポートを取得します。
• mailchimp-pp-cli reporting get-surveys-id-questions — アンケートの質問に関するレポートを取得します。
• mailchimp-pp-cli reporting get-surveys-id-questions-id — アンケートの質問に関するレポートを取得します。
• mailchimp-pp-cli reporting get-surveys-id-questions-id-answers — アンケートの質問に対する回答を取得します。
• mailchimp-pp-cli reporting get-surveys-id-responses — アンケートへの回答を取得します。
• mailchimp-pp-cli reporting get-surveys-id-responses-id — アンケートの個別の回答を取得します。

reports — レポートを管理

• mailchimp-pp-cli reports get — キャンペーンのレポートを取得します。
• mailchimp-pp-cli reports get-id — 特定の送信済みキャンペーンのレポート詳細を取得します。

search-campaigns — 検索キャンペーンを管理

• mailchimp-pp-cli search-campaigns — 指定した検索語で全会キャンペーンを検索します。

search-members — 検索メンバーを管理します

• mailchimp-pp-cli search-members — リストメンバーを検索します。この検索は特定のリストに限定することも、すべてのリストを横断して検索することもできます...

sms-campaigns — SMS キャンペーンを管理します

• mailchimp-pp-cli sms-campaigns delete-id — Mailchimp アカウントから SMS キャンペーンを削除します。
• mailchimp-pp-cli sms-campaigns get — アカウント内のすべての SMS キャンペーンを取得します。
• mailchimp-pp-cli sms-campaigns get-id — 特定の SMS キャンペーンに関する情報を取得します。
• mailchimp-pp-cli sms-campaigns patch-id — 特定の SMS キャンペーンの設定の一部またはすべてを更新します。
• mailchimp-pp-cli sms-campaigns post — 新しい SMS キャンペーンを作成します。

template-folders — テンプレートフォルダーを管理します

• mailchimp-pp-cli template-folders delete-id — 特定のテンプレートフォルダーを削除し、そのフォルダー内のすべてのテンプレートを「未分類」にします。
• mailchimp-pp-cli template-folders get — テンプレートを整理するために使用されるすべてのフォルダーを取得します。
• mailchimp-pp-cli template-folders get-id — テンプレートを整理するために使用される特定のフォルダーに関する情報を取得します。
• mailchimp-pp-cli template-folders patch-id — テンプレートを整理するために使用される特定のフォルダーを更新します。
• mailchimp-pp-cli template-folders post — 新しいテンプレートフォルダーを作成します。

templates — テンプレートを管理します

• mailchimp-pp-cli templates delete-id — 特定のテンプレートを削除します。
• mailchimp-pp-cli templates get — アカウントで利用可能なテンプレートの一覧を取得します。
• mailchimp-pp-cli templates get-id — 特定のテンプレートに関する情報を取得します。
• mailchimp-pp-cli templates patch-id — 既存のテンプレートの名前、HTML、または folder_id を更新します。
• mailchimp-pp-cli templates post — アカウント用の新しいテンプレートを作成します。サポートされるのはクラシックテンプレートのみです。

verified-domains — 検証済みドメインを管理します

• mailchimp-pp-cli verified-domains create — アカウントにドメインを追加します。
• mailchimp-pp-cli verified-domains delete — アカウントから検証済みドメインを削除します。
• mailchimp-pp-cli verified-domains get — アカウント上のすべての送信ドメインを取得します。
• mailchimp-pp-cli verified-domains get-verifieddomains — アカウント上の単一ドメインの詳細を取得します。

適切なコマンドを見つける

やりたいことはわかっているが、どのコマンドがそれを行うかわからない場合は、CLI に直接尋ねてください:

mailchimp-pp-cli which "<capability in your own words>"

which は自然言語による機能のクエリを、この CLI の厳選された機能インデックスから最も一致するコマンドに解決します。終了コード 0 は少なくとも 1 件の一致を意味し、終了コード 2 は確実な一致がないことを意味します — --help に頼るか、より絞り込んだクエリを使用してください。

レシピ

タグ付きの購読者を 1 回の呼び出しで追加する

mailchimp-pp-cli subscribe [email protected] --list LIST_ID --tags vip,onboarding --merge FNAME=Alice --merge LNAME=Smith

PUT /lists/{id}/members/{md5} と POST /lists/{id}/members/{md5}/tags を、MD5 ハッシュを自動計算して組み合わせます。

バッチエンドポイント経由で CSV から 5,000 件の連絡先をインポートする

mailchimp-pp-cli bulk-subscribe --csv contacts.csv --list LIST_ID --tags newsletter --watch

/batches に POST し、完了するまでポーリングし、10 分で期限切れになる URL の有効期限内に tar.gz 内の JSONL を解凍し、行ごとの結果を返します。

キャンペーンが成功したかどうかを確認する

mailchimp-pp-cli digest CAMPAIGN_ID --json --select campaign_id,open_rate,click_rate,top_links,top_products

4 つのレポートエンドポイントを結合し、--select のドット区切りパスで、エージェントが実際に必要とするフィールドだけにレスポンスを絞り込めます (Mailchimp のレポートはそれぞれ 10KB を超えます)。

クリーンアップすべき古いセグメントを見つける

mailchimp-pp-cli segments audit --list LIST_ID --json

空のセグメント、90 日間メンバーの増加がないセグメント、最近のどのキャンペーンでも使用されていないセグメントを明らかにします。

公式チェックリストでキャンペーンの送信をゲートする

mailchimp-pp-cli send-checked CAMPAIGN_ID

まず /send-checklist を実行します。type=error の項目が 1 つでもある場合は、失敗した項目を出力して終了コード 2 で終了し、送信しません。壊れたキャンペーンが気付かれずに配信されるのを防ぐために CI で使用してください。

月曜日のレビュー資料のために 2 つのキャンペーンを直接比較する

mailchimp-pp-cli compare CAMPAIGN_A CAMPAIGN_B --md

開封率、CTR、収益、配信停止の並列比較を、指標ごとの勝者とともに表示します。--md 出力は Notion や Slack に貼り付けられます。

創業者レビュー向けの週間キャンペーン集計

mailchimp-pp-cli digest --last 5 --md

複数のキャンペーンをまとめた統計情報付きのサマリーテーブルを表示します。Marcus の月曜日の創業者向けドキュメントの形式です。

認証の設定

Mailchimp は API キーの末尾にデータセンターをエンコードします。キーが 'abc...xyz-us6' の場合、CLI はリクエストを 'us6.api.mailchimp.com.' に送信します。MAILCHIMP_API_KEY を設定すると、CLI は起動時に末尾を解析します。OAuth トークン（データセンターのサフィックスが埋め込まれていないもの）の場合は、MAILCHIMP_DC=us1 を明示的に設定するか、'mailchimp auth dc-lookup' でメタデータエンドポイントから解決します。

mailchimp-pp-cli doctor を実行して設定を確認します。

エージェントモード

任意のコマンドに --agent を追加します。次のオプションに展開されます：--json --compact --no-input --no-color --yes。

• パイプ可能 — JSON は stdout に、エラーは stderr に出力されます

• フィルター可能 — --select でフィールドを絞り込めます。ドット区切りのパスはネストされた構造をたどり、配列では各要素を走査します。詳細な出力を返す API でコンテキストを小さく保つために重要です：

  mailchimp-pp-cli account-exports get --agent --select id,name,status
  

• プレビュー可能 — --dry-run でリクエストを送信せずに表示します

• オフライン対応 — 同期／検索コマンドは、利用可能な場合にローカルの SQLite ストアを使用できます

• 非対話型 — プロンプトは表示されず、すべての入力はフラグで指定します

• 明示的な再試行 — すでに存在する項目の作成を成功として扱う場合にのみ --idempotent を使い、削除対象が存在しない場合に成功として扱う場合にのみ --ignore-missing を使います

レスポンスエンベロープ

ローカルストアまたは API からデータを読み取るコマンドは、出力をデータの出所を示すエンベロープでラップします：

{
  "meta": {"source": "live" | "local", "synced_at": "...", "reason": "..."},
  "results": <data>
}

データには .results を解析し、ライブデータかローカルデータかを確認するには .meta.source を参照します。人が読める N results (live) という概要が stderr に出力されるのは、stdout が端末で、かつ機械可読形式のフラグ（--json、--csv、--compact、--quiet、--plain、--select）が設定されていない場合のみです。パイプ接続されたエージェントや明示的に形式を指定した実行では、stdout に JSON のみが出力されます。

エージェントからのフィードバック

この CLI について気になる点があれば、あなた（またはエージェント）が記録してください：

mailchimp-pp-cli feedback "the --since flag is inclusive but docs say exclusive"
mailchimp-pp-cli feedback --stdin < notes.txt
mailchimp-pp-cli feedback list --json --limit 10

記録はローカルの ~/.mailchimp-pp-cli/feedback.jsonl に保存されます。MAILCHIMP_FEEDBACK_ENDPOINT が設定され、かつ --send が渡されている場合、または MAILCHIMP_FEEDBACK_AUTO_SEND=true の場合を除き、POST されることはありません。デフォルトの動作ではローカルにのみ保存されます。

バグ報告ではなく、意外だったことを書いてください。短く、具体的に、1 行で。それが積み重なっていく要素です。

出力の送信先

すべてのコマンドで --deliver <sink> を指定できます。出力は指定した送信先に（stdout に加えて、または stdout の代わりに）送られるため、エージェントはコマンド結果を手動でパイプ接続せずに転送できます。送信先は 3 種類あります：

送信先	動作
stdout	デフォルト。stdout のみに書き込みます
file:<path>	出力を <path> にアトミックに書き込みます（一時ファイルを作成してリネーム）
webhook:<url>	出力本文を URL に POST します（--compact の場合は application/json または application/x-ndjson）

不明なスキームは、サポートされているスキームを示す構造化エラーとともに拒否されます。Webhook の失敗時はゼロ以外の終了コードが返され、URL と HTTP ステータスが stderr に記録されます。

名前付きプロファイル

プロファイルとは、保存したフラグ値のセットで、複数回の実行で再利用できます。スケジュールされたエージェントが毎回同じ設定で同じコマンドを実行する場合に使用します。HeyGen の「Beacon」パターンです。

mailchimp-pp-cli profile save briefing --json
mailchimp-pp-cli --profile briefing account-exports get
mailchimp-pp-cli profile list --json
mailchimp-pp-cli profile show briefing
mailchimp-pp-cli profile delete briefing --yes

明示的に指定したフラグは常にプロファイルの値より優先され、プロファイルの値はデフォルトより優先されます。agent-context は利用可能なすべてのプロファイルを available_profiles の下に一覧表示するため、実行時に情報を調べるエージェントがプロファイルを検出できます。

終了コード

コード	意味
0	成功
2	使用エラー（引数が不正）
3	リソースが見つかりません
4	認証が必要です
5	API エラー（上流の問題）
7	レート制限中（待機して再試行）
10	設定エラー

引数の解析

$ARGUMENTS を解析します：

1. 空、help、または --help → mailchimp-pp-cli --help の出力を表示
2. install で始まる → mcp で終わる場合は MCP のインストール、それ以外の場合は上記の前提条件を参照
3. それ以外 → 直接使用（--agent を付けて CLI コマンドとして実行）

MCP サーバーのインストール

この CLI の公開ライブラリエントリーまたはビルド済みリリースから MCP バイナリをインストールし、登録します。

claude mcp add mailchimp-pp-mcp -- mailchimp-pp-mcp

確認：claude mcp list

直接使用する

1. インストールされているか確認します：which mailchimp-pp-cli 見つからない場合は、インストールを提案します（このスキルの冒頭にある前提条件を参照）。
2. ユーザーのクエリに最適なコマンドを、上記の独自の機能とコマンドリファレンスから選びます。
3. --agent フラグを付けて実行します：

   mailchimp-pp-cli <command> [subcommand] [args] --agent
   

4. あいまいな場合は、サブコマンドのヘルプを確認します：mailchimp-pp-cli <command> --help。