pp-klaviyo

Klaviyo — Printing Press CLI

前提条件：CLI をインストールする

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

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

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

2. 次のコマンドで確認します：klaviyo-pp-cli --version
3. このスキルを実行するエージェント／ランタイムの $PATH に、表示されたインストール先ディレクトリが含まれていることを確認します。

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

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

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

この CLI を使う場面

エージェントが Web UI を使わずに Klaviyo を調査または操作する必要がある場合に、この CLI を使用します。特に、プロフィール、イベント、キャンペーン、フロー、セグメント、テンプレート、メトリクス、および複合的な成長ワークフローに適しています。

独自の機能

この API 用のほかのツールでは、次の機能を利用できません。

キャンペーン操作

• campaigns deploy — メールテンプレートを作成し、下書きキャンペーンを作成して、テンプレートをキャンペーンメッセージに割り当てる一連の操作を、監査可能なワークフローで実行します。

  エージェントは、3 つのエンドポイント呼び出しを手作業でつなぎ合わせずに、キャンペーンの下書きを作成できます。

  klaviyo-pp-cli campaigns deploy --template-html ./email.html --campaign-name "May offer" --list-id LIST_ID --subject "May offer" --from-email [email protected] --from-label "Marketing" --json
  

• campaigns image-swap — キャンペーンメッセージのテンプレートを見つけ、下書きのほかの部分を保持したまま、HTML 内の画像 URL を置き換えます。

  エージェントは、キャンペーン全体を作り直さずに、安全にクリエイティブを差し替えられます。

  klaviyo-pp-cli campaigns image-swap --campaign-id CAMPAIGN_ID --old-url https://cdn.example.com/old.jpg --new-url https://cdn.example.com/new.jpg --json
  

行動グラフ分析

• flow-decay — 同期済みのローカルデータを使って、直近の期間ごとに開封率またはクリック率が低下したフローを特定します。

  エージェントは、売上がさらに落ち込む前に、見直しが必要なライフサイクル自動化を見つけられます。

  klaviyo-pp-cli flow-decay --days 90 --threshold 0.15 --json
  

• cohort — 同期済みのプロフィールとイベントから、最初のイベント発生日ごとにプロフィールをグループ化し、継続率や再購入・再アクションの推移を算出します。

  エージェントは、CSV をエクスポートせずに、どの顧客獲得コホートが購入を続けているかを把握できます。

  klaviyo-pp-cli cohort --metric "Placed Order" --interval month --json --select cohort,profiles,retained
  

• attribution — 注文イベントとキャンペーンおよびフローのアトリビューションプロパティを結合し、チャネルと流入元ごとの売上を集計します。

  エージェントは、ローカルのイベントデータを根拠に、どの自動化やキャンペーンが売上を生み出したかを説明できます。

  klaviyo-pp-cli attribution --metric "Placed Order" --group-by flow --since 2026-01-01 --json
  

データの整合性

• dedup — ローカルのプロフィールミラーで、メールアドレス、電話番号、またはチャネルをまたいだ重複によって重複しているように見えるプロフィールを検出します。

  エージェントは、顧客の行動履歴や売上履歴が複数の ID に分散しているレコードを特定できます。

  klaviyo-pp-cli dedup --by email,phone --json
  

• reconcile — キャンペーンの UTM データとローカルの Klaviyo 注文イベントを比較します。利用可能な場合は、任意の Shopify 認証情報も使用します。

  エージェントは、数値を報告する前に、キャンペーンのパフォーマンスと注文データが一致しているか確認できます。

  klaviyo-pp-cli reconcile --campaign-id CAMPAIGN_ID --since 2026-01-01 --json
  

成長計画

• plan brief-to-strategy — 成長に関する概要を、Klaviyo のキャンペーン、フロー、セグメント、実験の構造化された戦略に変換します。

  エージェントは、戦略のメモを具体的な Klaviyo の実行計画に変換できます。

  klaviyo-pp-cli plan brief-to-strategy --brief ./brief.md --json
  

• plan qa-gate — リンク、オファー、日付、タイムゾーン、フォールバックトークン、配信停止リンクの配置、コンプライアンス、および配信可能性のフラグについて、ローンチ準備状況のチェックリストを実行します。

  エージェントは、曖昧なレビューコメントではなく、具体的な指摘に基づいてリスクのあるキャンペーンのローンチを止められます。

  klaviyo-pp-cli plan qa-gate --campaign-id CAMPAIGN_ID --html ./email.html --json
  

コマンドリファレンス

accounts — アカウント

• klaviyo-pp-cli accounts get — 指定したプライベート API キーに関連付けられたアカウントを取得します。配列内のアカウントオブジェクトは 1 つ返されます……。
• klaviyo-pp-cli accounts get-id — アカウント ID を指定して、単一のアカウントオブジェクトを取得します。プライベート API キーに対応するアカウントのみリクエストできます……。

back-in-stock-subscriptions — 再入荷通知のサブスクリプションを管理

• klaviyo-pp-cli back-in-stock-subscriptions — プロフィールを登録し、商品の再入荷通知を受け取れるようにします。詳しくは、[再入荷 API をご覧ください…… campaign-clone — キャンペーンの複製を管理

• klaviyo-pp-cli campaign-clone — 既存のキャンペーンを複製し、新しい ID と名前を持つ、元のキャンペーンに基づく新しいキャンペーンを返します。
  
  レート制限...

campaign-message-assign-template — キャンペーンメッセージへのテンプレートの割り当てを管理

• klaviyo-pp-cli campaign-message-assign-template — 再利用できないバージョンのテンプレートを作成し、メッセージに割り当てます。
  
  レート制限:
  バースト:...

campaign-messages — キャンペーンメッセージを管理

• klaviyo-pp-cli campaign-messages get — 必須の ID に基づいて特定のメッセージを返します。
  
  レート制限:
  バースト: 10/s
  定常: 150/m...
• klaviyo-pp-cli campaign-messages update — キャンペーンメッセージを更新します。
  
  レート制限:
  バースト: 10/s
  定常: 150/m スコープ: campaigns:write

campaign-recipient-estimation-jobs — キャンペーン受信者数の推定ジョブを管理

• klaviyo-pp-cli campaign-recipient-estimation-jobs get — Create Campaign Recipient Estimation Job で実行した受信者数推定ジョブのステータスを取得します...
• klaviyo-pp-cli campaign-recipient-estimation-jobs refresh-campaign-recipient-estimation — 指定したキャンペーン ID の推定受信者数を更新する非同期ジョブを実行します。Get... を使用してください。

campaign-recipient-estimations — キャンペーン受信者数の推定値を管理

• klaviyo-pp-cli campaign-recipient-estimations <id> — 指定したキャンペーン ID のキャンペーン受信者数の推定値を取得します。この数は、次を使用して更新できます...

campaign-send-jobs — キャンペーン送信ジョブを管理

• klaviyo-pp-cli campaign-send-jobs cancel-campaign-send — キャンペーンを完全にキャンセルしてステータスを CANCELED にするか、キャンペーンを元に戻してステータスを... に戻します。
• klaviyo-pp-cli campaign-send-jobs get — キャンペーン送信ジョブを取得します。
  
  レート制限:
  バースト: 10/s
  定常: 150/m スコープ: campaigns:read
• klaviyo-pp-cli campaign-send-jobs send-campaign — キャンペーンの非同期送信を開始します。
  
  レート制限:
  バースト: 10/s
  定常: 150/m スコープ:...

campaign-values-reports — キャンペーン値レポートを管理

• klaviyo-pp-cli campaign-values-reports — 要求されたキャンペーン分析値データを返します。
  
  レート制限:
  バースト: 1/s
  定常:...

campaigns — キャンペーン

• klaviyo-pp-cli campaigns create — 指定されたパラメーターでキャンペーンを作成し、キャンペーンを返します。
  
  レート制限:
  バースト: 10/s
  定常:...
• klaviyo-pp-cli campaigns delete — 指定されたキャンペーン ID のキャンペーンを削除します。
  
  レート制限:
  バースト: 10/s
  定常: 150/m スコープ:...
• klaviyo-pp-cli campaigns get — フィルターに基づいて一部またはすべてのキャンペーンを返します。キャンペーンの一覧表示にはチャネルフィルターが必要です。指定してください...
• klaviyo-pp-cli campaigns get-id — 必須の ID に基づいて特定のキャンペーンを返します。
  
  レート制限:
  バースト: 10/s
  定常: 150/m...
• klaviyo-pp-cli campaigns update — 指定されたキャンペーン ID のキャンペーンを更新します。
  
  レート制限:
  バースト: 10/s
  定常: 150/m スコープ:...

catalog-categories — カタログカテゴリを管理

• klaviyo-pp-cli catalog-categories create-catalog-category — 新しいカタログカテゴリを作成します。
  
  レート制限:
  バースト: 75/s
  定常: 750/m スコープ: catalogs:write
• klaviyo-pp-cli catalog-categories delete-catalog-category — 指定されたカテゴリ ID を使用してカタログカテゴリを削除します。
  
  レート制限:
  バースト: 75/s
  定常: 750/m...
• klaviyo-pp-cli catalog-categories get — アカウント内のすべてのカタログカテゴリを取得します。カタログカテゴリは以下のフィールドで昇順および...
• klaviyo-pp-cli catalog-categories get-catalog-category — 指定されたカテゴリ ID のカタログカテゴリを取得します。
  
  レート制限:
  バースト: 350/s
  定常: 3500/m...
• klaviyo-pp-cli catalog-categories update-catalog-category — 指定されたカテゴリ ID のカタログカテゴリを更新します。
  
  レート制限:
  バースト: 75/s
  定常: 750/m...

catalog-category-bulk-create-jobs — カタログカテゴリの一括作成ジョブを管理します

• klaviyo-pp-cli catalog-category-bulk-create-jobs bulk-create-catalog-categories — カタログカテゴリのバッチを作成するためのカタログカテゴリ一括作成ジョブを作成します。最大 100 件のカタログ...
• klaviyo-pp-cli catalog-category-bulk-create-jobs get-bulk-create-categories-job — 指定されたジョブ ID のカタログカテゴリ一括作成ジョブを取得します。include パラメータを指定すると...
• klaviyo-pp-cli catalog-category-bulk-create-jobs get-bulk-create-categories-jobs — すべてのカタログカテゴリ一括作成ジョブを取得します。1 リクエストあたり最大 100 件のジョブを返します。
  
  *レート...

catalog-category-bulk-delete-jobs — カタログカテゴリの一括削除ジョブを管理します

• klaviyo-pp-cli catalog-category-bulk-delete-jobs bulk-delete-catalog-categories — カタログカテゴリのバッチを削除するためのカタログカテゴリ一括削除ジョブを作成します。最大 100 件のカタログ...
• klaviyo-pp-cli catalog-category-bulk-delete-jobs get-bulk-delete-categories-job — 指定されたジョブ ID のカタログカテゴリ一括削除ジョブを取得します。
  
  レート制限:
  バースト: 350/s
  定常:...
• klaviyo-pp-cli catalog-category-bulk-delete-jobs get-bulk-delete-categories-jobs — すべてのカタログカテゴリ一括削除ジョブを取得します。1 リクエストあたり最大 100 件のジョブを返します。
  
  *レート...

catalog-category-bulk-update-jobs — カタログカテゴリの一括更新ジョブを管理します

• klaviyo-pp-cli catalog-category-bulk-update-jobs bulk-update-catalog-categories — カタログカテゴリのバッチを更新するためのカタログカテゴリ一括更新ジョブを作成します。最大 100 件のカタログ...
• klaviyo-pp-cli catalog-category-bulk-update-jobs get-bulk-update-categories-job — 指定されたジョブ ID のカタログカテゴリ一括更新ジョブを取得します。include パラメータを指定すると...
• klaviyo-pp-cli catalog-category-bulk-update-jobs get-bulk-update-categories-jobs — すべてのカタログカテゴリ一括更新ジョブを取得します。1 リクエストあたり最大 100 件のジョブを返します。
  
  *レート...

catalog-item-bulk-create-jobs — カタログアイテムの一括作成ジョブを管理します

• klaviyo-pp-cli catalog-item-bulk-create-jobs bulk-create-catalog-items — カタログアイテムのバッチを作成するためのカタログアイテム一括作成ジョブを作成します。1 回あたり最大 100 件のカタログアイテムを...
• klaviyo-pp-cli catalog-item-bulk-create-jobs get-bulk-create-catalog-items-job — 指定されたジョブ ID のカタログアイテム一括作成ジョブを取得します。include パラメータを指定すると...
• klaviyo-pp-cli catalog-item-bulk-create-jobs get-bulk-create-catalog-items-jobs — すべてのカタログアイテム一括作成ジョブを取得します。1 リクエストあたり最大 100 件のジョブを返します。
  
  レート制限:
  バースト:...

catalog-item-bulk-delete-jobs — カタログアイテムの一括削除ジョブを管理します

• klaviyo-pp-cli catalog-item-bulk-delete-jobs bulk-delete-catalog-items — カタログアイテムの一括削除ジョブを作成し、カタログアイテムのバッチを削除します。1 回につき最大 100 件のカタログアイテムを受け付けます...
• klaviyo-pp-cli catalog-item-bulk-delete-jobs get-bulk-delete-catalog-items-job — 指定されたジョブ ID のカタログアイテム一括削除ジョブを取得します。
  
  レート制限:
  バースト: 350/s
  定常:...
• klaviyo-pp-cli catalog-item-bulk-delete-jobs get-bulk-delete-catalog-items-jobs — すべてのカタログアイテム一括削除ジョブを取得します。1 リクエストにつき最大 100 件のジョブを返します。
  
  レート制限:
  バースト:...

catalog-item-bulk-update-jobs — カタログアイテムの一括更新ジョブを管理します

• klaviyo-pp-cli catalog-item-bulk-update-jobs bulk-update-catalog-items — カタログアイテムの一括更新ジョブを作成し、カタログアイテムのバッチを更新します。1 回につき最大 100 件のカタログアイテムを受け付けます...
• klaviyo-pp-cli catalog-item-bulk-update-jobs get-bulk-update-catalog-items-job — 指定されたジョブ ID のカタログアイテム一括更新ジョブを取得します。include パラメーターを指定すると、...を取得できます。
• klaviyo-pp-cli catalog-item-bulk-update-jobs get-bulk-update-catalog-items-jobs — すべてのカタログアイテム一括更新ジョブを取得します。1 リクエストにつき最大 100 件のジョブを返します。
  
  レート制限:
  バースト:...

catalog-items — カタログアイテムを管理します

• klaviyo-pp-cli catalog-items create — 新しいカタログアイテムを作成します。
  
  レート制限:
  バースト: 75/s
  定常: 750/m スコープ: catalogs:write
• klaviyo-pp-cli catalog-items delete — 指定されたアイテム ID のカタログアイテムを削除します。
  
  レート制限:
  バースト: 75/s
  定常: 750/m スコープ:...
• klaviyo-pp-cli catalog-items get — アカウント内のすべてのカタログアイテムを取得します。カタログアイテムは以下のフィールドで昇順および...で並べ替えできます。
• klaviyo-pp-cli catalog-items get-catalogitems — 指定されたアイテム ID の特定のカタログアイテムを取得します。
  
  レート制限:
  バースト: 350/s
  定常: 3500/m...
• klaviyo-pp-cli catalog-items update — 指定されたアイテム ID のカタログアイテムを更新します。
  
  レート制限:
  バースト: 75/s
  定常: 750/m スコープ:...

catalog-variant-bulk-create-jobs — カタログバリアントの一括作成ジョブを管理します

• klaviyo-pp-cli catalog-variant-bulk-create-jobs bulk-create-catalog-variants — カタログバリアントの一括作成ジョブを作成し、カタログバリアントのバッチを作成します。1 回につき最大 100 件のカタログバリアントを受け付けます...
• klaviyo-pp-cli catalog-variant-bulk-create-jobs get-bulk-create-variants-job — 指定されたジョブ ID のカタログバリアント一括作成ジョブを取得します。include パラメーターを指定すると、...を取得できます。
• klaviyo-pp-cli catalog-variant-bulk-create-jobs get-bulk-create-variants-jobs — すべてのカタログバリアント一括作成ジョブを取得します。1 リクエストにつき最大 100 件のジョブを返します。
  
  レート制限:
  バースト:...

catalog-variant-bulk-delete-jobs — カタログバリアントの一括削除ジョブを管理します

• klaviyo-pp-cli catalog-variant-bulk-delete-jobs bulk-delete-catalog-variants — カタログバリアントの一括削除ジョブを作成し、カタログバリアントのバッチを削除します。1 回につき最大 100 件のカタログバリアントを受け付けます...
• klaviyo-pp-cli catalog-variant-bulk-delete-jobs get-bulk-delete-variants-job — 指定されたジョブ ID のカタログバリアント一括削除ジョブを取得します。
  
  レート制限:
  バースト: 350/s
  定常:...
• klaviyo-pp-cli catalog-variant-bulk-delete-jobs get-bulk-delete-variants-jobs — すべてのカタログバリアント一括削除ジョブを取得します。1 リクエストにつき最大 100 件のジョブを返します。
  
  レート制限:
  バースト:...

catalog-variant-bulk-update-jobs — カタログバリアントの一括更新ジョブを管理します

• klaviyo-pp-cli catalog-variant-bulk-update-jobs bulk-update-catalog-variants — カタログバリアントの一括更新ジョブを作成し、カタログバリアントのバッチを更新します。最大100件のカタログバリアントを受け付けます...
• klaviyo-pp-cli catalog-variant-bulk-update-jobs get-bulk-update-variants-job — 指定したジョブ ID のカタログバリアント一括更新ジョブを取得します。include パラメーターを指定すると、...
• klaviyo-pp-cli catalog-variant-bulk-update-jobs get-bulk-update-variants-jobs — すべてのカタログバリアント一括更新ジョブを取得します。1回のリクエストにつき最大100件のジョブを返します。
  
  レート制限：
  バースト：...

catalog-variants — カタログバリアントを管理

• klaviyo-pp-cli catalog-variants create — 関連するカタログアイテムの新しいバリアントを作成します。
  
  レート制限：
  バースト：75/s
  定常：750/m...
• klaviyo-pp-cli catalog-variants delete — 指定したバリアント ID のカタログアイテムバリアントを削除します。
  
  レート制限：
  バースト：75/s
  定常：750/m...
• klaviyo-pp-cli catalog-variants get — アカウント内のすべてのバリアントを取得します。バリアントは、次のフィールドで昇順または降順に並べ替えられます：...
• klaviyo-pp-cli catalog-variants get-catalogvariants — 指定したバリアント ID のカタログアイテムバリアントを取得します。
  
  レート制限：
  バースト：350/s
  定常：3500/m...
• klaviyo-pp-cli catalog-variants update — 指定したバリアント ID のカタログアイテムバリアントを更新します。
  
  レート制限：
  バースト：75/s
  定常：750/m...

client — クライアント

• klaviyo-pp-cli client bulk-create-events — プロファイルのアクティビティを追跡する新しいイベントを作成します。このエンドポイントは、特に...から呼び出すように設計されています
• klaviyo-pp-cli client create-back-in-stock-subscription — 再入荷通知を受け取るためのプロファイルのサブスクリプションを作成します。[バックインストック API...をご覧ください
• klaviyo-pp-cli client create-event — プロファイルのアクティビティを追跡する新しいイベントを作成します。このエンドポイントは、特に...から呼び出すように設計されています
• klaviyo-pp-cli client create-profile — 関連するイベントを追跡せずに、プロファイルのプロパティを作成または更新します。このエンドポイントは、特に...
• klaviyo-pp-cli client create-push-token — プッシュトークンを作成または更新します。このエンドポイントは、特に当社のモバイル SDK から呼び出すように設計されています...
• klaviyo-pp-cli client create-review — 指定した ID でレビューを作成します。このエンドポイントはクライアント側の環境専用です。
  
  *レート...
• klaviyo-pp-cli client create-subscription — 指定された email および...に基づいて、メールおよび／または SMS チャネルのサブスクリプションと同意レコードを作成します
• klaviyo-pp-cli client get-geofences — アカウント内のすべてのジオフェンスを取得します。指定した会社のすべてのジオフェンスをページ分割したリストで返します。これは GA...
• klaviyo-pp-cli client get-review-values-reports — アカウント内のすべてのレビュー評価レポートを取得します。
  
  レート制限：
  バースト：10/s
  定常：150/m
• klaviyo-pp-cli client get-reviews — すべてのレビューを取得します。このエンドポイントはクライアント側の環境専用です。サーバー側で使用する場合は、...を参照してください
• klaviyo-pp-cli client unregister-push-token — プッシュトークンの登録を解除します。このエンドポイントは、特に当社のモバイル SDK から呼び出すように設計されています...

conversation-messages — 会話メッセージを管理

• klaviyo-pp-cli conversation-messages — 会話に送信メッセージを送信します。OAuth 認証とアカウントレベルでの有効化が必要です。リクエストするには...

coupon-code-bulk-create-jobs — クーポンコード一括作成ジョブを管理

• klaviyo-pp-cli coupon-code-bulk-create-jobs bulk-create-coupon-codes — クーポンコードのリストを一括作成するための coupon-code-bulk-create-job を作成します。1 ジョブあたりのクーポンコードの最大数は...
• klaviyo-pp-cli coupon-code-bulk-create-jobs get-bulk-create-coupon-code-jobs — すべてのクーポンコード一括作成ジョブを取得します。1 リクエストあたり最大 100 ジョブを返します。
  
  レート制限:
  バースト:...
• klaviyo-pp-cli coupon-code-bulk-create-jobs get-bulk-create-coupon-codes-job — 指定されたジョブ ID のクーポンコード一括作成ジョブを取得します。
  
  レート制限:
  バースト: 75/s
  定常: 750/m...

coupon-codes — クーポンコードを管理します

• klaviyo-pp-cli coupon-codes create — 指定されたクーポンのクーポンコードを同期的に作成します。
  
  レート制限:
  バースト: 350/s
  定常:...
• klaviyo-pp-cli coupon-codes delete — 指定された識別子のクーポンコードを同期的に削除します。プロファイルがクーポンに割り当てられている場合...
• klaviyo-pp-cli coupon-codes get — クーポンまたはプロファイルに関連付けられたクーポンコードのリストを取得します。クーポンまたは...
• klaviyo-pp-cli coupon-codes get-couponcodes — 指定された識別子のクーポンコードを返します。
  
  レート制限:
  バースト: 350/s
  定常: 3500/m...
• klaviyo-pp-cli coupon-codes update — 指定された識別子のクーポンコードを同期的に更新します。'status' および...の更新が可能です。

coupons — クーポン

• klaviyo-pp-cli coupons create — 新しいクーポンを作成します。
  
  レート制限:
  バースト: 3/s
  定常: 60/m スコープ: coupons:write
• klaviyo-pp-cli coupons delete — 指定されたクーポン ID のクーポンを削除します。
  
  レート制限:
  バースト: 3/s
  定常: 60/m スコープ:...
• klaviyo-pp-cli coupons get — アカウント内のすべてのクーポンを取得します。詳細については、[Coupons API...
• klaviyo-pp-cli coupons get-id — 指定されたクーポン ID の特定のクーポンを取得します。
  
  レート制限:
  バースト: 75/s
  定常: 750/m...
• klaviyo-pp-cli coupons update — レート制限:
  バースト: 3/s
  定常: 60/m スコープ: coupons:write

custom-metrics — カスタムメトリクスを管理します

• klaviyo-pp-cli custom-metrics create — 新しいカスタムメトリクスを作成します。カスタムメトリクスオブジェクトには name と definition を含める必要があります。
  
  *レート...
• klaviyo-pp-cli custom-metrics delete — 指定されたカスタムメトリクス ID のカスタムメトリクスを削除します。
  
  レート制限:
  バースト: 3/s
  定常: 60/m...
• klaviyo-pp-cli custom-metrics get — アカウント内のすべてのカスタムメトリクスを取得します。
  
  レート制限:
  バースト: 3/s
  定常: 60/m スコープ: metrics:read
• klaviyo-pp-cli custom-metrics get-custommetrics — 指定されたカスタムメトリクス ID のカスタムメトリクスを取得します。
  
  レート制限:
  バースト: 3/s
  定常: 60/m...
• klaviyo-pp-cli custom-metrics update — 指定されたカスタムメトリクス ID のカスタムメトリクスを更新します。
  
  レート制限:
  バースト: 1/s
  定常:...

data-privacy-deletion-jobs — データプライバシー削除ジョブを管理します

• klaviyo-pp-cli data-privacy-deletion-jobs — email、phone_number、または...のいずれかの識別子に対応するプロファイルの削除をリクエストします。

data-source-record-bulk-create-jobs — データソースレコード一括作成ジョブを管理します

• klaviyo-pp-cli data-source-record-bulk-create-jobs — レコードのバッチを作成するための一括データソースレコードインポートジョブを作成します。1 リクエストあたり最大 500 レコードを受け付けます。...

data-source-record-create-jobs — データソースレコード作成ジョブを管理します

• klaviyo-pp-cli data-source-record-create-jobs — 単一のレコードを作成するためのデータソースレコードインポートジョブを作成します。レコードあたりの最大許容ペイロードサイズは...

data-sources — データソースを管理します

• klaviyo-pp-cli data-sources create — アカウントに新しいデータソースを作成します
  
  レート制限:
  バースト: 3/s
  通常: 60/m スコープ:...
• klaviyo-pp-cli data-sources delete — アカウントのデータソースを削除します。
  
  レート制限:
  バースト: 3/s
  通常: 60/m スコープ:...
• klaviyo-pp-cli data-sources get — アカウントのすべてのデータソースを取得します。
  
  レート制限:
  バースト: 3/s
  通常: 60/m スコープ:...
• klaviyo-pp-cli data-sources get-datasources — アカウントのデータソースを取得します。
  
  レート制限:
  バースト: 3/s
  通常: 60/m スコープ:...

event-bulk-create-jobs — イベント一括作成ジョブを管理します

• klaviyo-pp-cli event-bulk-create-jobs — 1つ以上のプロファイルのイベントを一括作成します。このエンドポイントでは、新しいプロファイルを作成することもできます...

events — イベント

• klaviyo-pp-cli events create — プロファイルのアクティビティを追跡する新しいイベントを作成します。このエンドポイントでは、新しいプロファイルを作成することもできます...
• klaviyo-pp-cli events get — アカウントのすべてのイベントを取得します。リクエストは次のフィールドで並べ替えることができます: datetime、timestamp [カスタム...
• klaviyo-pp-cli events get-id — 指定したイベント ID のイベントを取得します。
  
  レート制限:
  バースト: 10/s
  通常: 150/m スコープ:...

flow-actions — フローアクションを管理します

• klaviyo-pp-cli flow-actions get — 指定したフローアクション ID を持つフローアクションを取得します。
  
  レート制限:
  バースト: 3/s
  通常: 60/m...
• klaviyo-pp-cli flow-actions update — フローアクションを更新します。
  
  レート制限:
  バースト: 3/s
  通常: 60/m スコープ: flows:write

flow-messages — フローメッセージを管理します

• klaviyo-pp-cli flow-messages <id> — 指定したフローメッセージ ID を持つフローのメッセージを取得します。
  
  レート制限:
  バースト: 3/s
  通常:...

flow-series-reports — フローの系列レポートを管理します

• klaviyo-pp-cli flow-series-reports — リクエストされたフロー分析の系列データを返します
  
  レート制限:
  バースト: 1/s
  通常: 2/m
  日次:...

flow-values-reports — フローの値レポートを管理します

• klaviyo-pp-cli flow-values-reports — リクエストされたフロー分析の値データを返します
  
  レート制限:
  バースト: 1/s
  通常: 2/m
  日次:...

flows — フロー

• klaviyo-pp-cli flows create — エンコードされたフロー定義を使用して新しいフローを作成します。アクションなど、フロー定義内の新しいオブジェクトは...
• klaviyo-pp-cli flows delete — 指定したフロー ID のフローを削除します。
  
  レート制限:
  バースト: 3/s
  通常: 60/m スコープ: flows:write
• klaviyo-pp-cli flows get — アカウントのすべてのフローを取得します。リクエストごとに最大50件のフローを返します。カーソルベースの...でページネーションできます
• klaviyo-pp-cli flows get-id — 指定したフロー ID のフローを取得します。
  
  レート制限:
  バースト: 3/s
  通常: 60/m スコープ: flows:read
• klaviyo-pp-cli flows update — 指定したフロー ID のフローと、そのフロー内のすべてのアクションのステータスを更新します。
  
  レート制限:
  バースト:...

form-series-reports — フォームの系列レポートを管理します

• klaviyo-pp-cli form-series-reports — リクエストされたフォーム分析の系列データを返します。
  
  レート制限:
  バースト: 1/s
  通常: 2/m
  日次:...

form-values-reports — フォームの値レポートを管理します

• klaviyo-pp-cli form-values-reports — リクエストされたフォーム分析の値データを返します。
  
  レート制限:
  バースト: 1/s
  通常: 2/m
  日次:...

form-versions — フォームのバージョンを管理します

• klaviyo-pp-cli form-versions <id> — 指定した ID のフォームバージョンを取得します。
  
  レート制限:
  バースト: 3/s
  通常: 60/m スコープ: forms:read

forms — フォーム

• klaviyo-pp-cli forms create — 新しいフォームを作成します。
  
  レート制限:
  バースト: 3/s
  定常: 60/m スコープ: forms:write
• klaviyo-pp-cli forms delete — 指定したフォームを削除します。
  
  レート制限:
  バースト: 3/s
  定常: 60/m スコープ: forms:write
• klaviyo-pp-cli forms get — アカウント内のすべてのフォームを取得します。
  
  レート制限:
  バースト: 3/s
  定常: 60/m スコープ: forms:read
• klaviyo-pp-cli forms get-id — 指定した ID のフォームを取得します。
  
  レート制限:
  バースト: 3/s
  定常: 60/m スコープ: forms:read

image-upload — 画像アップロードを管理

• klaviyo-pp-cli image-upload — ファイルから画像をアップロードします。既存の URL またはデータ URI から画像をインポートする場合は、Upload Image... を使用してください。

images — images

• klaviyo-pp-cli images get — アカウント内のすべての画像を取得します。
  
  レート制限:
  バースト: 10/s
  定常: 150/m スコープ: images:read
• klaviyo-pp-cli images get-id — 指定した画像 ID の画像を取得します。
  
  レート制限:
  バースト: 10/s
  定常: 150/m スコープ:...
• klaviyo-pp-cli images update — 指定した画像 ID の画像を更新します。
  
  レート制限:
  バースト: 10/s
  定常: 150/m スコープ:...
• klaviyo-pp-cli images upload-from-url — URL またはデータ URI から画像をインポートします。ファイルから画像をアップロードする場合は、Upload Image From File... を使用してください。

lists — lists

• klaviyo-pp-cli lists create — 新しいリストを作成します。
  
  レート制限:
  バースト: 10/s
  定常: 150/m
  1 日あたり: 150/d スコープ: lists:write
• klaviyo-pp-cli lists delete — 指定したリスト ID のリストを削除します。
  
  レート制限:
  バースト: 10/s
  定常: 150/m スコープ:...
• klaviyo-pp-cli lists get — アカウント内のすべてのリストを取得します。フィルターを適用してすべてのリストのサブセットをリクエストできます。リストは id、name... でフィルタリングできます。
• klaviyo-pp-cli lists get-id — 指定したリスト ID のリストを取得します。
  
  レート制限:
  バースト: 75/s
  定常: 750/m
  
  次の場合のレート制限...
• klaviyo-pp-cli lists update — 指定したリスト ID のリストの名前を更新します。
  
  レート制限:
  バースト: 10/s
  定常: 150/m...

mapped-metrics — マップされたメトリクスを管理

• klaviyo-pp-cli mapped-metrics get — アカウント内のすべてのマップされたメトリクスを取得します。
  
  レート制限:
  バースト: 3/s
  定常: 60/m スコープ: metrics:read
• klaviyo-pp-cli mapped-metrics get-mappedmetrics — 指定した ID のマップされたメトリクスを取得します。
  
  レート制限:
  バースト: 3/s
  定常: 60/m スコープ:...
• klaviyo-pp-cli mapped-metrics update — 指定した ID のマップされたメトリクスを更新します。
  
  レート制限:
  バースト: 1/s
  定常: 15/m
  1 日あたり: 30/d...

metric-aggregates — メトリクス集計を管理

• klaviyo-pp-cli metric-aggregates — ネイティブの Klaviyo メトリクスや統合固有のメトリクスを含む、メトリクスに関連付けられたイベントデータをクエリして集計します...

metric-properties — メトリクスプロパティを管理

• klaviyo-pp-cli metric-properties <id> — 指定したメトリクスプロパティ ID のメトリクスプロパティを取得します。
  
  レート制限:
  バースト: 1/s
  定常: 15/m...

metrics — metrics

• klaviyo-pp-cli metrics get — アカウント内のすべてのメトリクスを取得します。リクエストは次のフィールドでフィルタリングできます: 統合 name、統合...
• klaviyo-pp-cli metrics get-id — 指定したメトリクス ID のメトリクスを取得します。
  
  レート制限:
  バースト: 10/s
  定常: 150/m スコープ:...

profile-bulk-import-jobs — プロファイル一括インポートジョブを管理

• klaviyo-pp-cli profile-bulk-import-jobs bulk-import-profiles — プロファイルの一括インポートジョブを作成し、プロファイルのバッチを作成または更新します。1 リクエストあたり最大 10,000 件のプロファイルを受け付けます。...
• klaviyo-pp-cli profile-bulk-import-jobs get-bulk-import-profiles-job — 指定されたジョブ ID のプロファイル一括インポートジョブを取得します。
  
  レート制限:
  バースト: 10/s
  定常: 150/m...
• klaviyo-pp-cli profile-bulk-import-jobs get-bulk-import-profiles-jobs — すべてのプロファイル一括インポートジョブを取得します。1 リクエストあたり最大 100 件のジョブを返します。
  
  レート制限:
  バースト:...

profile-import — プロファイルインポートを管理

• klaviyo-pp-cli profile-import — 一連のプロファイル属性と、任意で ID を指定して、プロファイルを作成または更新します。新しいプロファイルが作成された場合は 201 を返します。...

profile-merge — プロファイルマージを管理

• klaviyo-pp-cli profile-merge — 指定された関連プロファイルを、指定されたプロファイル ID のプロファイルにマージします。relationships の下に指定されたプロファイルは...

profile-subscription-bulk-create-jobs — プロファイルサブスクリプション一括作成ジョブを管理

• klaviyo-pp-cli profile-subscription-bulk-create-jobs — 1 つ以上のプロファイルをメールマーケティング、SMS マーケティング、WhatsApp、またはプッシュに登録します。指定されたリストがダブル...

profile-subscription-bulk-delete-jobs — プロファイルサブスクリプション一括削除ジョブを管理

• klaviyo-pp-cli profile-subscription-bulk-delete-jobs — > 🚧 > > 指定されたリストに含まれていないプロファイルはグローバルに配信停止されます。常にプロファイルのリストメンバーシップを確認してください...

profile-suppression-bulk-create-jobs — プロファイル抑制一括作成ジョブを管理

• klaviyo-pp-cli profile-suppression-bulk-create-jobs bulk-suppress-profiles — メールアドレスでプロファイルを手動で抑制するか、セグメント/リスト ID を指定してそのすべての現在のメンバーを抑制します...
• klaviyo-pp-cli profile-suppression-bulk-create-jobs get-bulk-suppress-profiles-job — 指定されたジョブ ID のプロファイル一括抑制ジョブを取得します。
  
  レート制限:
  バースト: 75/s
  定常: 750/m...
• klaviyo-pp-cli profile-suppression-bulk-create-jobs get-bulk-suppress-profiles-jobs — すべてのプロファイル一括抑制ジョブのステータスを取得します。
  
  レート制限:
  バースト: 75/s
  定常: 750/m...

profile-suppression-bulk-delete-jobs — プロファイル抑制一括削除ジョブを管理

• klaviyo-pp-cli profile-suppression-bulk-delete-jobs bulk-unsuppress-profiles — メールアドレスでプロファイルの抑制を手動で解除するか、セグメント/リスト ID を指定してそのすべての現在のメンバーの抑制を解除します...
• klaviyo-pp-cli profile-suppression-bulk-delete-jobs get-bulk-unsuppress-profiles-job — 指定されたジョブ ID のプロファイル一括抑制解除ジョブを取得します。
  
  レート制限:
  バースト: 75/s
  定常:...
• klaviyo-pp-cli profile-suppression-bulk-delete-jobs get-bulk-unsuppress-profiles-jobs — すべてのプロファイル一括抑制解除ジョブを取得します。
  
  レート制限:
  バースト: 75/s
  定常: 750/m スコープ:...

profiles — profiles

• klaviyo-pp-cli profiles create — 新しいプロファイルを作成します。additional-fields パラメータを使用して、サブスクリプションと予測分析データを含めます...
• klaviyo-pp-cli profiles get — アカウント内のすべてのプロファイルを取得します。プロファイルは次のフィールドで昇順および降順に並べ替えることができます:...
• klaviyo-pp-cli profiles get-id — 指定されたプロファイル ID のプロファイルを取得します。additional-fields パラメータを使用して、サブスクリプションと...
• klaviyo-pp-cli profiles update — 指定されたプロファイル ID のプロファイルを更新します。additional-fields パラメータを使用して、サブスクリプションと...

push-tokens — プッシュトークンを管理

• klaviyo-pp-cli push-tokens create — プッシュトークンを作成または更新します。このエンドポイントを使用して、別のプラットフォームから Klaviyo にプッシュトークンを移行できます。....
• klaviyo-pp-cli push-tokens delete — ID に基づいて特定のプッシュトークンを削除します。
  
  レート制限:
  バースト: 3/s
  通常: 60/m スコープ:...
• klaviyo-pp-cli push-tokens get — 企業に関連付けられたプッシュトークンを返します。
  
  レート制限:
  バースト: 10/s
  通常: 150/m スコープ:...
• klaviyo-pp-cli push-tokens get-pushtokens — ID に基づいて特定のプッシュトークンを返します。
  
  レート制限:
  バースト: 10/s
  通常: 150/m スコープ:...

レビュー — レビュー

• klaviyo-pp-cli reviews get — すべてのレビューを取得します。
  
  レート制限:
  バースト: 10/s
  通常: 150/m スコープ: reviews:read
• klaviyo-pp-cli reviews get-id — 指定された ID のレビューを取得します。
  
  レート制限:
  バースト: 10/s
  通常: 150/m スコープ: reviews:read
• klaviyo-pp-cli reviews update — レビューを更新します。
  
  レート制限:
  バースト: 10/s
  通常: 150/m スコープ: reviews:write

segment-series-reports — セグメント系列レポートを管理します

• klaviyo-pp-cli segment-series-reports — リクエストされたセグメント分析の系列データを返します。
  
  レート制限:
  バースト: 1/s
  通常:...

segment-values-reports — セグメント値レポートを管理します

• klaviyo-pp-cli segment-values-reports — リクエストされたセグメント分析の値データを返します。
  
  レート制限:
  バースト: 1/s
  通常:...

セグメント — セグメント

• klaviyo-pp-cli segments create — セグメントを作成します。
  
  レート制限:
  バースト: 1/s
  通常: 15/m
  日次: 100/d スコープ: segments:write
• klaviyo-pp-cli segments delete — 指定されたセグメント ID のセグメントを削除します。
  
  レート制限:
  バースト: 3/s
  通常: 60/m スコープ:...
• klaviyo-pp-cli segments get — アカウント内のすべてのセグメントを取得します。フィルターを使用して、すべてのセグメントから一部を絞り込んでリクエストできます。セグメントは name で絞り込めます。...
• klaviyo-pp-cli segments get-id — 指定されたセグメント ID のセグメントを取得します。
  
  レート制限:
  バースト: 75/s
  通常: 750/m
  
  レート...
• klaviyo-pp-cli segments update — 指定されたセグメント ID のセグメントを更新します。
  
  レート制限:
  バースト: 1/s
  通常: 15/m
  日次:...

tag-groups — タググループを管理します

• klaviyo-pp-cli tag-groups create — タググループを作成します。1 つのアカウントに作成できる固有のタググループは 50 個までです。exclusive が指定されていない場合...
• klaviyo-pp-cli tag-groups delete — 指定されたタググループ ID のタググループを削除します。そのタググループ内のすべてのタグと、それらの間の関連付けも...
• klaviyo-pp-cli tag-groups get — アカウント内のすべてのタググループを一覧表示します。すべてのアカウントにはデフォルトのタググループが 1 つあります。タググループは name で絞り込めます。...
• klaviyo-pp-cli tag-groups get-taggroups — 指定されたタググループ ID のタググループを取得します。
  
  レート制限:
  バースト: 3/s
  通常: 60/m...
• klaviyo-pp-cli tag-groups update — 指定されたタググループ ID のタググループを更新します。変更できるのはタググループの name のみです。タググループの...

タグ — タグ

• klaviyo-pp-cli tags create — タグを作成します。1 つのアカウントに作成できる固有のタグは 500 個までです。タグは 1 つのタググループに属します。...
• klaviyo-pp-cli tags delete — 指定されたタグ ID のタグを削除します。そのタグと他のリソース間の関連付けも...
• klaviyo-pp-cli tags get — アカウント内のすべてのタグを一覧表示します。タグは name で絞り込めます。また、name または id で昇順または降順に並べ替えられます。...
• klaviyo-pp-cli tags get-id — 指定されたタグ ID のタグを取得します。
  
  レート制限:
  バースト: 3/s
  通常: 60/m スコープ: tags:read
• klaviyo-pp-cli tags update — 指定されたタグ ID のタグを更新します。変更できるのはタグの name のみです。タグを別のタググループに移動することはできません。...

template-clone — テンプレートの複製を管理します

• klaviyo-pp-cli template-clone — 指定したテンプレート ID のテンプレートを複製します。アカウント内のテンプレートが 1,000 個以上の場合、複製は...

template-render — テンプレートのレンダリングを管理

• klaviyo-pp-cli template-render — 指定したテンプレート ID とコンテキスト属性を使ってテンプレートをレンダリングします。AMP、HTML、プレーンテキストの各バージョンを返します...

template-universal-content — テンプレートのユニバーサルコンテンツを管理

• klaviyo-pp-cli template-universal-content create-universal-content — ユニバーサルコンテンツを作成します。現在サポートされているブロックタイプは、button、drop_shadow、horizontal_rule、html、...
• klaviyo-pp-cli template-universal-content delete-universal-content — 指定した ID のユニバーサルコンテンツを削除します。
  
  レート制限：
  バースト：75/s
  定常：750/m...
• klaviyo-pp-cli template-universal-content get-all-universal-content — アカウント内のすべてのユニバーサルコンテンツを取得します。
  
  レート制限：
  バースト：75/s
  定常：750/m スコープ：...
• klaviyo-pp-cli template-universal-content get-universal-content — 指定した ID のユニバーサルコンテンツを取得します。
  
  レート制限：
  バースト：75/s
  定常：750/m スコープ：...
• klaviyo-pp-cli template-universal-content update-universal-content — ユニバーサルコンテンツを更新します。現時点で、definition フィールドを更新できるのは次のブロックタイプのみです：...

templates — テンプレート

• klaviyo-pp-cli templates create — 新しい HTML またはドラッグ＆ドロップテンプレートを作成します。アカウント内のテンプレートが 1,000 個以上の場合、作成は失敗します...
• klaviyo-pp-cli templates delete — 指定したテンプレート ID のテンプレートを削除します。
  
  レート制限：
  バースト：75/s
  定常：750/m スコープ：...
• klaviyo-pp-cli templates get — アカウント内のすべてのテンプレートを取得します。additional-fields[template]=definition を使用すると、テンプレート全体を含められます...
• klaviyo-pp-cli templates get-id — 指定したテンプレート ID のテンプレートを取得します。
  
  レート制限：
  バースト：75/s
  定常：750/m スコープ：...
• klaviyo-pp-cli templates update — 指定したテンプレート ID のテンプレートを更新します。
  
  レート制限：
  バースト：75/s
  定常：750/m スコープ：...

tracking-settings — トラッキング設定

• klaviyo-pp-cli tracking-settings get — アカウント内のすべての UTM トラッキング設定を取得します。単一のトラッキング設定を含む配列を返します。詳細については...
• klaviyo-pp-cli tracking-settings get-trackingsettings — 指定したアカウント ID の UTM トラッキング設定を取得します。UTM トラッキング設定の詳細については...
• klaviyo-pp-cli tracking-settings update — 指定したアカウント ID の UTM トラッキング設定を更新します。UTM トラッキング設定の詳細については...

web-feeds — ウェブフィード

• klaviyo-pp-cli web-feeds create — ウェブフィードを作成します。
  
  レート制限：
  バースト：1/s
  定常：15/m スコープ： web-feeds:write
• klaviyo-pp-cli web-feeds delete — 指定した ID のウェブフィードを削除します。
  
  レート制限：
  バースト：1/s
  定常：15/m スコープ：...
• klaviyo-pp-cli web-feeds get — アカウントのすべてのウェブフィードを取得します。
  
  レート制限：
  バースト：1/s
  定常：15/m スコープ： web-feeds:read
• klaviyo-pp-cli web-feeds get-webfeeds — 指定した ID のウェブフィードを取得します。
  
  レート制限：
  バースト：1/s
  定常：15/m スコープ： web-feeds:read
• klaviyo-pp-cli web-feeds update — 指定した ID のウェブフィードを更新します。
  
  レート制限：
  バースト：1/s
  定常：15/m スコープ：...

webhook-topics — Webhook トピックを管理

• klaviyo-pp-cli webhook-topics get — Klaviyo アカウント内のすべての Webhook トピックを取得します。
  
  レート制限：
  バースト：1/s
  定常：15/m スコープ：...
• klaviyo-pp-cli webhook-topics get-webhooktopics — 指定した ID の Webhook トピックを取得します。
  
  レート制限：
  バースト：1/s
  定常：15/m スコープ：...

webhooks — Webhook

• klaviyo-pp-cli webhooks create — 新しい Webhook を作成します。
  
  レート制限:
  バースト: 1/s
  定常: 15/m スコープ: webhooks:write
• klaviyo-pp-cli webhooks delete — 指定された ID の Webhook を削除します。
  
  レート制限:
  バースト: 1/s
  定常: 15/m スコープ: webhooks:write
• klaviyo-pp-cli webhooks get — アカウント内のすべての Webhook を取得します。
  
  レート制限:
  バースト: 1/s
  定常: 15/m スコープ: webhooks:read
• klaviyo-pp-cli webhooks get-id — 指定された ID の Webhook を取得します。
  
  レート制限:
  バースト: 1/s
  定常: 15/m スコープ: webhooks:read
• klaviyo-pp-cli webhooks update — 指定された ID の Webhook を更新します。
  
  レート制限:
  バースト: 1/s
  定常: 15/m スコープ:...

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

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

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

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

レシピ

プロフィールをコンパクトに検査する

klaviyo-pp-cli profiles list --limit 1 --json --select data.id,data.email,data.first_name

1 つのプロフィールを取得し、エージェントが必要とするフィールドだけを選択します。

収益指標を見つける

klaviyo-pp-cli metrics list --json --select data.id,data.name | jq '.data[] | select(.name=="Placed Order")'

アトリビューションやコホートの作業の前に、Placed Order 指標を特定します。

ローンチ QA ゲートを実行する

klaviyo-pp-cli plan qa-gate --campaign-id CAMPAIGN_ID --html ./email.html --json

ローンチ前に、オファー、リンク、配信停止、コンプライアンス、日付、配信到達性に関する検出事項を確認します。配信停止タグが欠落しているか壊れている場合、ゲートは失敗し、campaigns deploy はテンプレートを作成する前に同じチェックを適用します。{% unsubscribe %} は単独のテキストとして、{% unsubscribe_link %} は href 内で使用してください。

認証のセットアップ

KLAVIYO_API_KEY にプライベートな Klaviyo API キーを設定します。リクエストは Authorization: Klaviyo-API-Key を送信し、生成された OpenAPI 仕様で固定されたリビジョンを使用します。

セットアップを確認するには klaviyo-pp-cli doctor を実行してください。

エージェントモード

任意のコマンドに --agent を追加します。次のように展開されます: --json --compact --no-input --no-color --yes。

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

• フィルタ可能 — --select はフィールドのサブセットを保持します。ドット区切りのパスはネストされた構造へ降りていき、配列は要素ごとにたどります。冗長な API でコンテキストを小さく保つために重要です:

  klaviyo-pp-cli accounts get --agent --select id,name,status
  

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

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

• 非対話型 — 決してプロンプトを出さず、すべての入力はフラグです

レスポンスエンベロープ

ローカルストアまたは API から読み取るコマンドは、出力を来歴エンベロープでラップします:

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

データには .results を、それがライブかローカルかを知るには .meta.source を解析します。人間が読める N results (live) のサマリーは、stdout がターミナルの場合にのみ stderr に出力されます。パイプやエージェントのコンシューマーは、stdout で純粋な JSON を受け取ります。

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

あなた（またはエージェント）がこの CLI について何かおかしいと気づいたら、それを記録してください:

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

エントリはローカルの ~/.klaviyo-pp-cli/feedback.jsonl に保存されます。KLAVIYO_FEEDBACK_ENDPOINT が設定されており、かつ --send が渡されるか KLAVIYO_FEEDBACK_AUTO_SEND=true の場合を除き、決して POST されません。デフォルトの動作はローカルのみです。

バグレポートではなく、あなたが驚いたことを書いてください。短く、具体的に、1 行で。それが積み重なる部分です。

出力の配信

すべてのコマンドは --deliver <sink> を受け付けます。出力は stdout に加えて（またはそれに代えて）指定されたシンクに送られるため、エージェントは手動でパイプすることなくコマンドの結果をルーティングできます。3 つのシンクがサポートされています:

シンク	効果
stdout	デフォルト。stdout にのみ書き込みます
file:<path>	出力を <path> にアトミックに書き込みます（tmp + rename）
webhook:<url>	出力ボディを URL に POST します（--compact の場合は application/json または application/x-ndjson）

不明なスキームは、サポートされているセットを示す構造化エラーとともに拒否されます。Webhook の失敗は非ゼロを返し、URL と HTTP ステータスを stderr にログ出力します。

名前付きプロファイル

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

klaviyo-pp-cli profile save briefing --json
klaviyo-pp-cli --profile briefing accounts get
klaviyo-pp-cli profile list --json
klaviyo-pp-cli profile show briefing
klaviyo-pp-cli profile delete briefing --yes

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

終了コード

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

引数の解析

$ARGUMENTS を解析します：

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

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

1. MCP サーバーをインストールします：

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

2. Claude Code に登録します：

   claude mcp add klaviyo-pp-mcp -- klaviyo-pp-mcp
   

3. 確認します：claude mcp list

直接使用

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

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

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