mcpField
S
sequenzy-email-marketing

sequenzy-email-marketing

github.com/davepoonマーケティング・グロース3.7k45 回インストール今日更新
リポジトリ

sequenzy-email-marketing について

Sequenzy の CLI または MCP ツールでメールマーケティングを運用する Agent 向けのスキルです。実装済み機能の確認や変更前の調査を重視し、未対応の操作を明示します。

主な機能

  1. 01対応済み CLI ワークフローの案内
  2. 02購読者、キャンペーン、シーケンスの操作
  3. 03メールコンテンツの生成と送信
  4. 04認証とダッシュボード URL の処理
  5. 05未実装の操作の確認

活用シーン

  1. 01購読者、リスト、会社、キャンペーン統計の確認
  2. 02キャンペーンやシーケンスの作成と予約
  3. 03メール、シーケンス、件名の生成
  4. 04操作が実装済みかどうかの確認

MCP 対応

MCP を使う場合は Sequenzy の MCP ソースで利用可能なツールを確認するよう案内します。テンプレート、キャンペーン、購読者、アプリ URL の MCP 操作について説明しています。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/davepoon/buildwithclaude --skill sequenzy-email-marketing

インストール後、Claude Code で/sequenzy-email-marketingを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

agents/
openai.yaml
references/
command-reference.md
use-cases.md

詳細

Sequenzy メールマーケティング

概要

このスキルは、Sequenzy のソースコードを変更するのではなく、Sequenzy を操作するタスクで使用してください。サポートされているワークフローでは sequenzy CLI を優先してください。MCP ツールを使用するタスクでは、packages/mcp/src/tools/index.ts を MCP の信頼できる情報源として扱い、現在の実装に組み込まれていないワークフローが要求された場合は、その旨を明示してください。

基本ルール

  1. 実際に組み込まれているコマンドを確認するには、packages/cli/src/index.tsx を信頼できる情報源として扱ってください。
  2. CLI の動作、ペイロードの形式、API ルートを確認するには、packages/cli/src/commands/ と packages/cli/src/api.ts を信頼できる情報源として扱ってください。
  3. MCP ツール名、引数、事前検証を確認するには、packages/mcp/src/tools/index.ts を信頼できる情報源として扱ってください。
  4. ドキュメントや --help のテキストに記載されているだけで、実装が伴っていないコマンドやツールのサポートを約束しないでください。
  5. 対話型認証には sequenzy login を、オートメーションには SEQUENZY_API_KEY を優先してください。
  6. ワークフローが許す場合は、変更を加える前に確認を優先してください。

サポート対象のワークフロー

重要な操作を実行する前に、references/use-cases.md を読んでください。現在実装されている CLI のフローは次のとおりです。

  • ログインとログアウト
  • whoami によるローカル認証／セッションの確認
  • account によるアカウントの確認
  • companies list|get|create による会社の確認または作成
  • 統計の概要、またはキャンペーン／シーケンス ID ごとの統計
  • 購読者の list、add、get、remove。list はデフォルトですべてのページを取得し、タグ、セグメント、リストによるフィルターに対応しています
  • リストの list、create、add-subscribers と、メールアドレス、JSON、CSV、改行区切りのファイルからリストを一括登録する import エイリアス
  • タグの list
  • セグメントの list、create、count。--match any、ネストされたフィルターのルート、カスタムイベントフィルター、保存済みセグメントの構成フィルターに対応しています
  • テンプレートの list、get、create、update、delete。list はラベルフィルターに対応し、create／update はラベル、HTML の生データ、Sequenzy ブロック JSON を受け付けます
  • キャンペーンの list、get、create、ラベルと返信先の更新を含む update、schedule、test。list はラベルフィルターに対応し、create はラベルに加えて HTML の生データ、Sequenzy ブロック JSON、プロンプトから生成したコンテンツを受け付けます。update はラベルに加えて HTML の生データまたは Sequenzy ブロック JSON を受け付け、schedule はレビュー用プレビューリンクを返します
  • MCP のテンプレートおよびキャンペーンのツールは、list／create／update でラベルに対応しています。MCP の update_campaign は replyTo と replyProfileId にも対応し、MCP の schedule_campaign は下書きまたはスケジュール済みのキャンペーンをスケジュールします
  • MCP の search_subscribers は、list、listId、listName によるリストフィルターに対応しています。MCP の add_subscribers_to_list は、1 回の呼び出しで最大 500 件のメールアドレスを受け付けます
  • シーケンスの list、get、create、update、enable、disable、delete、cancel-enrollments。明示的な割引アクションステップ、購読者 ID またはイベントプロパティのフィールド値によるキャンセル、タグ、リスト、セグメント、イベント、クリックされたリンク、フィールド条件を使った update での分岐挿入に対応しています。イベントとクリックされたリンクの分岐判定では activityScope（this_sequence、previous_email、ever）を使用できます
  • generate email、generate sequence、generate subjects による AI 生成
  • CLI の urls、MCP の get_app_urls、およびキャンペーン、シーケンス、テンプレート、会社の結果に含まれる appUrls／url フィールドによるダッシュボード URL の生成
  • ウェブサイトの list、add、check、guide
  • api-keys create による API キーの作成
  • テンプレートまたは HTML の生データによるトランザクションメールの単一送信

未サポートまたはプレースホルダーのワークフロー

名詞が存在していても、対応するサブコマンドがない場合は未サポートとして扱ってください。たとえば、キャンペーンの即時送信、一時停止／キャンセルのフロー、リストの削除、タグの変更は、現在の CLI ハンドラーでは利用できません。リストの一括登録には sequenzy lists add-subscribers とその sequenzy lists import エイリアスが対応していますが、subscribers add では対応していません。

実行パターン

  1. まず sequenzy whoami を実行するか、SEQUENZY_API_KEY が設定されていることを確認して、認証状態を確認します。
  2. ユースケースに合った、最も対象を絞ったコマンドを選びます。
  3. 変更を実行する前に、ID、受信者のメールアドレス、件名、テンプレート、コンテンツの入力値を検証します。
  4. CLI の制限事項は、回避策をでっち上げず、そのまま伝えます。
  5. ワークフローが CLI でサポートされていない場合は、次善の方法が Sequenzy ダッシュボードの利用なのか、API を直接利用することなのかを伝えます。
  6. キャンペーン、シーケンス、テンプレート、会社を作成、確認、またはスケジュール設定し、ユーザーが内容を確認・編集する可能性がある場合は、ツール／CLI の出力に含まれる url、previewUrl、または appUrls のダッシュボード URL を提示します。必要に応じて、sequenzy urls または MCP get_app_urls で生成します。
  7. 運用上重要な実装上の注意点を伝えます。たとえば、whoami はローカルにキャッシュされた認証状態を使用すること、シーケンスの作成では --goal と明示的なステップモードの両方をサポートしていること、明示的な割引ステップを有効化するには事前に Stripe が必要であること、生成されるシーケンスはメール10通までであること、現在のバックエンドでは campaigns test が成功を返すスタブ経路であること、条件付きメールコンテンツには生の HTML ではなくブロック JSON が必要であることなどです。

ダッシュボード URL

SEQUENZY_APP_URL が設定されている場合は、ダッシュボードのベース URL として使用します。設定されていない場合は、https://sequenzy.com をデフォルトとして使用します。

CLI／MCP の結果に実際の URL が含まれている場合は、そちらを優先します。

  • シーケンスエディター：/dashboard/company/{companyId}/sequences/{sequenceId}
  • キャンペーンエディター：/dashboard/company/{companyId}/campaign/{campaignId}
  • キャンペーンのプレビュー／確認画面：/dashboard/company/{companyId}/campaign/{campaignId}?step=review
  • テンプレート／メールエディター：/dashboard/company/{companyId}/emails/{emailId}
  • 設定：/dashboard/company/{companyId}/settings
  • 設定タブ：/dashboard/company/{companyId}/settings?tab={tab}

便利な設定タブには、domain、tracking、localization、integrations、events、tags、goals、sync-rules、api-keys、widgets、team があります。

参考資料

コメント

Markdown 対応