convertkit-automation

Rube MCP を介した ConvertKit（Kit）の自動化

Rube MCP を介して Composio の Kit ツールキットを使用し、ConvertKit（現在の名称は Kit）のメールマーケティング業務を自動化します。

ツールキットのドキュメント：composio.dev/toolkits/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 のウェブ 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～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

---

Composio 提供