pp-kit

Kit — Printing Press CLI

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

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

1. Printing Press インストーラーを使ってインストールします。デフォルトでは、macOS/Linux では $HOME/.local/bin に、Windows では %LOCALAPPDATA%\Programs\PrintingPress\bin にバイナリがインストールされます。

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

2. 確認します：kit-pp-cli --version
3. このスキルを実行するエージェント／ランタイムから参照できるよう、報告されたインストールディレクトリが $PATH に含まれていることを確認します。

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

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

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

エージェント型 Kit ワークフロー

ユーザーが計画、診断、監査、サポート、またはアカウントのコンテキストを求めている場合は、生のエンドポイントミラーより先に、以下の読み取り専用ワークフローを使用してください。

• kit-pp-cli workflow creator-snapshot --agent — アカウント、成長、オーディエンス、コンテンツ、Webhook、ブロードキャストの統計をまとめた運用スナップショットです。
• kit-pp-cli workflow audience-health --agent — 購読者のステータス別件数、成長統計、購読者数が多いタグです。
• kit-pp-cli workflow content-inventory --agent — コンテンツ計画用のシーケンス、シーケンスメール、スニペット、フォーム、メールテンプレート、最近のブロードキャスト統計です。
• kit-pp-cli workflow subscriber-lookup --email <email> --agent — カスタムフィールド、タグ、アトリビューション、メール統計を含む、1 人の購読者プロフィールです。

特定の CRUD 操作、エンドポイントとの厳密な同等性、ワークフローの上限を超えるページネーション、または書き込み操作が必要な場合は、生のエンドポイントコマンドを使用してください。これらのワークフローは実際の Kit v4 エンドポイントを呼び出します。キャッシュされた要約やモックのペイロードではありません。

独自の機能

この API に対して、他のどのツールでも利用できない機能です。

クリエイター向け操作

• workflow creator-snapshot — Kit アカウント、成長、オーディエンス、コンテンツ、Webhook、ブロードキャスト統計をまとめて取得する、読み取り専用の運用スナップショットです。

  エージェントがエンドポイントミラーを手動で複数呼び出しせずに、クリエイターアカウントの最新状況を把握する必要がある場合は、まずこれを使用してください。

  kit-pp-cli workflow creator-snapshot --agent
  

オーディエンスインテリジェンス

• workflow audience-health — 購読者のステータス別件数、最近の成長統計、購読者数が多いタグを取得する読み取り専用ワークフローです。

  リストのクリーニング、セグメント化、キャンペーン計画の前にこれを使用し、購読者やタグに関する複数の不安定な呼び出しを避けてください。

  kit-pp-cli workflow audience-health --agent
  

• workflow subscriber-lookup — メールアドレスまたは ID から、プロフィール、カスタムフィールド、タグ、アトリビューション、メール統計を含む購読者の詳細情報を読み取り専用で取得します。

  サポート、セグメント化の確認、パーソナライズのデバッグでは、生の購読者エンドポイントを呼び出す前にこれを使用してください。

コンテンツ計画

• workflow content-inventory — シーケンス、シーケンスメール、スニペット、フォーム、テンプレート、最近のブロードキャスト統計の読み取り専用インベントリです。

  Kit のコンテンツを個別に一覧表示する代わりに、コンテンツ監査や計画に使用してください。

  kit-pp-cli workflow content-inventory --agent
  

トレンドとランキング

• growth-trends — 指定期間のアカウント成長統計とブロードキャストのパフォーマンスを関連付けます。必要に応じて、型付きの UpsertBroadcastsStats 書き込みパスを使って結果をキャッシュできます。
• tag-performance — 購読者数と全体に占める割合でタグをランキングします。任意の --subscriber-query を指定すると、SearchSubscribers を使ってセグメントを絞り込めます。

MCP インテントツール

4 つのファーストクラスの MCP インテントツールは、型付き入力スキーマと読み取り専用アノテーションを備えたワークフローコマンドを公開します。エージェントホストが型付きパラメーターと明示的な安全性のヒントを必要とする場合は、MCP サーバー（kit-pp-mcp）経由で使用してください。

• intent_workflow_creator_snapshot
• intent_workflow_audience_health
• intent_workflow_content_inventory
• intent_workflow_subscriber_lookup

MCP サーバーは、stdio とストリーム可能な HTTP トランスポート（--transport http --addr :7777 または PP_MCP_TRANSPORT=http）の両方に対応しています。

コマンドリファレンス

workflow — エージェント向けのKit固有の複合ワークフロー

• kit-pp-cli workflow creator-snapshot — アカウント、オーディエンス、コンテンツ、ブロードキャストの健全性を要約します
• kit-pp-cli workflow audience-health — 購読者のステータス、最近の成長、最も多く付与されているタグを要約します
• kit-pp-cli workflow content-inventory — シーケンス、メール、スニペット、フォーム、テンプレート、ブロードキャストを一覧化します
• kit-pp-cli workflow subscriber-lookup — タグ、カスタムフィールド、アトリビューション、メール統計とともに、1人の購読者の情報を取得します

account — アカウントを管理します

• kit-pp-cli account list — 現在のアカウントを取得します
• kit-pp-cli account list-colors — 色を一覧表示します
• kit-pp-cli account list-creatorprofile —クリエイタープロフィールを取得します
• kit-pp-cli account list-emailstats — メール統計を取得します
• kit-pp-cli account list-growthstats — 指定した期間の成長統計を取得します。デフォルトは過去90日間です。
  
  注：統計情報は...
• kit-pp-cli account update — 色を更新します

broadcasts — ブロードキャストを管理します

• kit-pp-cli broadcasts create — すべての購読者、または一部の購読者にブロードキャストを送信するための下書き作成または送信予約を行います。
  
  下書きを保存するには、...を設定します
• kit-pp-cli broadcasts delete — ブロードキャストを削除します
• kit-pp-cli broadcasts get — ブロードキャストを取得します
• kit-pp-cli broadcasts list — ブロードキャストを一覧表示します
• kit-pp-cli broadcasts list-stats — ブロードキャストのリストの統計を取得します
• kit-pp-cli broadcasts update — 既存のブロードキャストを更新します。すべての購読者、または一部の購読者にブロードキャストを送信するための下書き作成または送信予約を続けます...

bulk — 一括操作を管理します

• kit-pp-cli bulk create — 詳細については、「一括処理と非同期処理」をご覧ください。
• kit-pp-cli bulk create-customfields — 購読者のカスタムフィールド値を一括更新します
• kit-pp-cli bulk create-forms — ダブルオプトインフォームに購読者を追加すると、インセンティブメールが送信されます。すでに追加されている購読者は...
• kit-pp-cli bulk create-subscribers — 詳細については、「一括処理と非同期処理」をご覧ください。
• kit-pp-cli bulk create-tags — 詳細については、「一括処理と非同期処理」をご覧ください。
• kit-pp-cli bulk create-tags-2 — タグを付与する購読者は、すでに存在している必要があります。購読者は「[一括作成...
• kit-pp-cli bulk delete — 詳細については、「一括処理と非同期処理」をご覧ください。

custom-fields — カスタムフィールドを管理します

• kit-pp-cli custom-fields create — アカウントにカスタムフィールドを作成します。ラベルフィールドはアカウント内で一意である必要があります。空白文字は削除され...
• kit-pp-cli custom-fields delete — このフィールドのデータは、購読者からすべて削除されます。
• kit-pp-cli custom-fields list — カスタムフィールドを使うと、名やメールアドレスなどの標準フィールド以外の購読者情報を収集できます...
• kit-pp-cli custom-fields update — カスタムフィールドのラベルを更新します（詳細はカスタムフィールドを作成するを参照...

email-templates — メールテンプレートを管理します

• kit-pp-cli email-templates — メールテンプレートを一覧表示します

forms — フォームを管理します

• kit-pp-cli forms — フォームを一覧表示します

posts — 投稿を管理します

• kit-pp-cli posts get — 投稿を取得します
• kit-pp-cli posts list — 投稿を一覧表示します

purchases — 購入を管理します

• kit-pp-cli purchases create — 購入を作成します
• kit-pp-cli purchases get — 購入を取得します
• kit-pp-cli purchases list — 購入を一覧表示します

segments — セグメントを管理します

• kit-pp-cli segments — セグメントを一覧表示します

sequences — シーケンスを管理します

• kit-pp-cli sequences create — 空のシーケンス（シーケンスメールを格納するコンテナー）を作成します。シェルを作成した後、[Create a...
• kit-pp-cli sequences delete — シーケンスを論理削除します。シーケンスはすぐにアクティブな配信から除外され、関連する状態のクリーンアップが...
• kit-pp-cli sequences get — id で単一のシーケンスを取得します。現在のスケジュールや、active / repeat / hold...
• kit-pp-cli sequences list — アカウントのすべてのシーケンスを返します。シーケンスは自動メールの自己完結型セットです。購読者は参加し、...
• kit-pp-cli sequences update — シーケンスの各種設定（name、email_address、スケジュール（send_days、send_hour、time_zone）など）を更新します。...

snippets — スニペットを管理します

• kit-pp-cli snippets create — スニペットは、Liquid を使ってブロードキャストメールやシーケンスメールに挿入できる、再利用可能なメールコンテンツです：`{{...
• kit-pp-cli snippets get — id で単一のスニペットを取得します。スニペットの一覧表示とは異なり、このエンドポイント...
• kit-pp-cli snippets list — アカウントのすべてのスニペットを返します。各スニペットの key は、Liquid で使用する識別子です — {{ snippet.key }}...
• kit-pp-cli snippets update — スニペットの名前変更、本文の置き換え、アーカイブ／復元を行います。更新は、対象となるメールの次回送信時に適用されます...

subscribers — 購読者を管理します

• kit-pp-cli subscribers create — アップサートとして動作します。指定したメールアドレスの購読者が存在しない場合は、...で新規作成します
• kit-pp-cli subscribers create-filter — エンゲージメントに基づいて購読者をフィルタリングします
• kit-pp-cli subscribers get — 購読者を取得します
• kit-pp-cli subscribers list — 購読者を一覧表示します
• kit-pp-cli subscribers update — アカウントに存在しないカスタムフィールドキーを指定すると、リクエストはエラーを返します。[List...

tags — タグを管理します

• kit-pp-cli tags create — タグを作成します
• kit-pp-cli tags list — タグを一覧表示します
• kit-pp-cli tags update — タグ名を更新します

webhooks — Webhook を管理します

• kit-pp-cli webhooks create — 利用可能なイベントタイプ：
  - subscriber.subscriber_activate
  - subscriber.subscriber_unsubscribe
  -...
• kit-pp-cli webhooks delete — Webhook を削除します
• kit-pp-cli webhooks list — Webhook は、購読者イベントが発生したとき（たとえば、...のとき）に購読者データを受け取るオートメーションです

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

実行したいことは分かっていても、どのコマンドを使えばよいか分からない場合は、CLI に直接尋ねてください：

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

which は自然言語による機能の問い合わせを、この CLI の厳選された機能インデックスから最も適したコマンドに対応付けます。終了コード 0 は一致する項目が1つ以上あることを示し、終了コード 2 は確度の高い一致がないことを示します。その場合は --help を使うか、より具体的な問い合わせに切り替えてください。

認証の設定

kit-pp-cli auth setup を実行すると、キーの取得に必要な URL と手順が表示されます（URL を開くには --launch を追加します）。次に、以下を設定します：

export KIT_API_KEY="<your-key>"

または、~/.config/kit-pp-cli/config.toml に保存します。

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

エージェントモード

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

• パイプ可能 — stdout に JSON、stderr にエラーを出力します

• フィルタリング可能 — --select でフィールドを絞り込みます。ドット区切りのパスはネストした構造をたどり、配列は要素ごとに処理します。冗長な API でコンテキストを小さく保つために重要です：

  kit-pp-cli account list --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) の概要は、標準出力がターミナルで、かつ機械可読形式のフラグ（--json、--csv、--compact、--quiet、--plain、--select）が設定されていない場合に限り、標準エラー出力にのみ表示されます。パイプ経由やエージェントからの利用、および形式を明示した実行では、標準出力には JSON のみが出力されます。

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

あなた（またはエージェント）がこの CLI に気になる点を見つけたら、記録してください。

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

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

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

出力の配信

すべてのコマンドで --deliver <sink> を指定できます。エージェントがコマンド結果を手動でパイプ処理せずに振り分けられるよう、出力は標準出力に加えて（または標準出力の代わりに）指定したシンクへ送られます。対応しているシンクは 3 種類です。

シンク	効果
stdout	デフォルト。標準出力のみに書き込みます
file:<path>	出力を <path> にアトミックに書き込みます（一時ファイル＋リネーム）
webhook:<url>	出力本文を URL に POST します（--compact の場合は application/json または application/x-ndjson）

不明なスキームは、対応しているスキームの一覧を示す構造化エラーとともに拒否されます。Webhook の失敗時はゼロ以外の終了コードが返され、URL と HTTP ステータスが標準エラー出力に記録されます。

名前付きプロファイル

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

kit-pp-cli profile save briefing --json
kit-pp-cli --profile briefing account list
kit-pp-cli profile list --json
kit-pp-cli profile show briefing
kit-pp-cli profile delete briefing --yes

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

終了コード

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

引数の解析

$ARGUMENTS を解析します。

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

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

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

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

2. Claude Code に登録します。

   claude mcp add kit-pp-mcp -- kit-pp-mcp
   

3. 確認します：claude mcp list

直接使用

1. インストール済みか確認します：which kit-pp-cli 見つからない場合は、インストールを提案します（このスキルの冒頭にある「前提条件」を参照してください）。
2. アカウント、オーディエンス、コンテンツ、購読者コンテキストに関する幅広いリクエストには、上記の Agentic Kit ワークフローを優先してください。
3. より限定的なユーザークエリには、上記のコマンドリファレンスから最適なコマンドを選んでください。
4. --agent フラグを付けて実行します。

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

5. あいまいな場合は、サブコマンドのヘルプを確認してください：kit-pp-cli <command> --help。