convertkit-automation

Rube MCP による ConvertKit (Kit) 自動化

Composio の Kit ツールキットを Rube MCP 経由で利用し、ConvertKit (現在は Kit として知られています) のメールマーケティング業務を自動化します。

前提条件

• Rube MCP が接続されている必要があります (RUBE_SEARCH_TOOLS が利用可能であること)
• ツールキット kit を使用した RUBE_MANAGE_CONNECTIONS による有効な Kit 接続
• 常に最初に RUBE_SEARCH_TOOLS を呼び出して、最新のツールスキーマを取得してください

セットアップ

Rube MCP の取得: クライアント設定で https://rube.app/mcp を MCP サーバーとして追加します。API キーは不要です — エンドポイントを追加するだけで動作します。

1. RUBE_SEARCH_TOOLS が応答することを確認して、Rube MCP が利用可能であることを検証します
2. ツールキット kit を指定して RUBE_MANAGE_CONNECTIONS を呼び出します
3. 接続が ACTIVE でない場合は、返された認証リンクに従って Kit の認証を完了します
4. ワークフローを実行する前に、接続ステータスが ACTIVE であることを確認します

主要なワークフロー

1. 購読者の一覧表示と検索

使用する場面: ユーザーがメール購読者を閲覧、検索、または絞り込みたい場合

ツールの順序:

1. KIT_LIST_SUBSCRIBERS - フィルターとページネーションを使用して購読者を一覧表示します [必須]

主なパラメータ:

• status: ステータスで絞り込みます ('active' または 'inactive')
• email_address: 検索する完全一致のメールアドレス
• created_after/created_before: 日付範囲フィルター (YYYY-MM-DD)
• updated_after/updated_before: 日付範囲フィルター (YYYY-MM-DD)
• sort_field: 'id'、'cancelled_at'、または 'updated_at' で並べ替えます
• sort_order: 'asc' または 'desc'
• per_page: 1 ページあたりの結果件数 (最小 1)
• after/before: ページネーション用のカーソル文字列
• include_total_count: 購読者の総件数を取得するには 'true' に設定します

注意点:

• sort_field が 'cancelled_at' の場合、status は 'cancelled' に設定する必要があります
• 日付フィルターは YYYY-MM-DD 形式を使用します (時刻要素はありません)
• email_address は完全一致です。部分一致のメール検索はサポートされていません
• ページネーションは after/before カーソル文字列を使用するカーソルベースの方式です
• include_total_count は文字列 'true' であり、ブール値ではありません

2. 購読者タグの管理

使用する場面: ユーザーがセグメント化のために購読者にタグを付けたい場合

ツールの順序:

1. KIT_LIST_SUBSCRIBERS - メールアドレスから購読者 ID を検索します [前提条件]
2. KIT_TAG_SUBSCRIBER - 購読者をタグに関連付けます [必須]
3. KIT_LIST_TAG_SUBSCRIBERS - 特定のタグの購読者を一覧表示します [任意]

タグ付けの主なパラメータ:

• tag_id: 数値のタグ ID (必須)
• subscriber_id: 数値の購読者 ID (必須)

注意点:

• tag_id と subscriber_id はどちらも正の整数である必要があります
• タグ ID は既存のタグを参照する必要があります。タグは Kit の Web UI で作成します
• すでにタグ付けされた購読者へのタグ付けは冪等です (エラーになりません)
• 購読者 ID は LIST_SUBSCRIBERS から返されます。特定の購読者を検索するには email_address フィルターを使用してください

3. 購読者の配信停止

使用する場面: ユーザーが購読者をすべての通信から配信停止にしたい場合

ツールの順序:

1. KIT_LIST_SUBSCRIBERS - 購読者 ID を検索します [前提条件]
2. KIT_DELETE_SUBSCRIBER - 購読者を配信停止にします [必須]

主なパラメータ:

• id: 購読者 ID (必須、正の整数)

注意点:

• これは購読者をすべてのメール通信から永久に配信停止にします
• 購読者の履歴データは保持されますが、メールを受信しなくなります
• 操作は冪等です。すでに配信停止済みの購読者を配信停止にしてもエラーなく成功します
• 成功時は空のレスポンス (HTTP 204 No Content) を返します
• 購読者 ID は存在している必要があります。存在しない ID は 404 を返します

4. ブロードキャストの一覧表示と表示

使用するタイミング: ユーザーがメールブロードキャストを閲覧したい、または特定のブロードキャストの詳細を取得したい場合

ツールの順序:

1. KIT_LIST_BROADCASTS - ページネーションを使用してすべてのブロードキャストを一覧表示します [必須]
2. KIT_GET_BROADCAST - 特定のブロードキャストの詳細情報を取得します [任意]
3. KIT_GET_BROADCAST_STATS - ブロードキャストのパフォーマンス統計を取得します [任意]

一覧表示の主なパラメータ:

• per_page: 1 ページあたりの結果数 (1〜500)
• after/before: ページネーション用のカーソル文字列
• include_total_count: 合計件数を取得するには 'true' に設定します

詳細の主なパラメータ:

• id: ブロードキャスト ID (必須、正の整数)

注意点:

• ブロードキャストの per_page の最大値は 500 です
• ブロードキャストの統計は送信済みのブロードキャストでのみ利用可能です
• 下書きのブロードキャストには統計がありません
• ブロードキャスト ID は数値の整数です

5. ブロードキャストの削除

使用するタイミング: ユーザーがブロードキャストを完全に削除したい場合

ツールの順序:

1. KIT_LIST_BROADCASTS - 削除するブロードキャストを検索します [前提条件]
2. KIT_GET_BROADCAST - 正しいブロードキャストであることを確認します [任意]
3. KIT_DELETE_BROADCAST - ブロードキャストを完全に削除します [必須]

主なパラメータ:

• id: ブロードキャスト ID (必須)

注意点:

• 削除は完全であり、元に戻すことはできません
• 送信済みのブロードキャストを削除するとブロードキャストは削除されますが、メールの送信は取り消されません
• 削除する前にブロードキャスト ID を確認してください

一般的なパターン

メールアドレスによる購読者の検索

1. Call KIT_LIST_SUBSCRIBERS with email_address='[email protected]'
2. Extract subscriber ID from the response
3. Use ID for tagging, unsubscribing, or other operations

ページネーション

Kit はカーソルベースのページネーションを使用します:

• レスポンスで after カーソルの値を確認します
• 次のリクエストでカーソルを after パラメータとして渡します
• カーソルが返されなくなるまで続けます
• 進捗を追跡するには include_total_count: 'true' を使用します

タグベースのセグメンテーション

1. Create tags in Kit web UI
2. Use KIT_TAG_SUBSCRIBER to assign tags to subscribers
3. Use KIT_LIST_TAG_SUBSCRIBERS to view subscribers per tag

既知の注意点

ID の形式:

• 購読者 ID: 正の整数 (例: 3887204736)
• タグ ID: 正の整数
• ブロードキャスト ID: 正の整数
• すべての ID は数値であり、文字列ではありません

ステータス値:

• 購読者のステータス: 'active'、'inactive'、'cancelled'
• 一部の操作はステータスによって制限されます (例: cancelled_at による並べ替えには status='cancelled' が必要です)

文字列パラメータとブール値パラメータ:

• include_total_count は文字列の 'true' であり、ブール値の true ではありません
• sort_order は文字列の列挙型です: 'asc' または 'desc'

レート制限:

• Kit API にはアカウントごとのレート制限があります
• 429 レスポンスに対してはバックオフを実装してください
• 一括操作は適切にペース配分する必要があります

レスポンスの解析:

• レスポンスデータは data または data.data の下にネストされている場合があります
• フォールバックパターンを使用して防御的に解析してください
• カーソルの値は不透明な文字列です。返されたとおりに正確に使用してください

クイックリファレンス

タスク	ツールスラッグ	主なパラメータ
購読者の一覧表示	KIT_LIST_SUBSCRIBERS	status, email_address, per_page
購読者へのタグ付け	KIT_TAG_SUBSCRIBER	tag_id, subscriber_id
タグ購読者の一覧表示	KIT_LIST_TAG_SUBSCRIBERS	tag_id
購読解除	KIT_DELETE_SUBSCRIBER	id
ブロードキャストの一覧表示	KIT_LIST_BROADCASTS	per_page, after
ブロードキャストの取得	KIT_GET_BROADCAST	id
ブロードキャスト統計の取得	KIT_GET_BROADCAST_STATS	id
ブロードキャストの削除	KIT_DELETE_BROADCAST	id

使用するタイミング

このスキルは、概要に記載されているワークフローまたはアクションを実行する場合に適用されます。

制限事項

• タスクが上記の範囲に明確に一致する場合にのみ、このスキルを使用してください。
• 出力を環境固有の検証、テスト、または専門家によるレビューの代替として扱わないでください。
• 必要な入力、権限、安全上の境界、または成功基準が欠けている場合は、停止して確認を求めてください。