mcpField
C
convertkit-automation

convertkit-automation

github.com/composiohqマーケティング・グロース78.3k68 回インストール14 週間前に更新
リポジトリ

convertkit-automation について

Composio の Kit ツールキットと Rube MCP を通じて、Kit のメールマーケティングを自動化するスキルです。購読者の検索やタグ管理、配信の確認・管理に対応します。

主な機能

  1. 01購読者の検索と絞り込み
  2. 02購読者タグの追加と一覧表示
  3. 03購読者の配信停止
  4. 04配信と統計の確認
  5. 05配信の削除

活用シーン

  1. 01メールアドレスや状態で購読者を検索
  2. 02タグで購読者を分類
  3. 03送信済み配信の実績を確認
  4. 04購読者や配信を削除

MCP 対応

Rube MCP 経由で Composio の Kit ツールキットを利用します。ワークフローの実行前に Kit アカウントの接続が必要です。

インストール

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

$npx skills add https://github.com/composiohq/awesome-claude-skills --skill convertkit-automation

インストール後、Claude Code で/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_SUBSCRIBERSstatus, email_address, per_page
購読者へのタグ付けKIT_TAG_SUBSCRIBERtag_id, subscriber_id
タグが付いた購読者の一覧表示KIT_LIST_TAG_SUBSCRIBERStag_id
購読解除KIT_DELETE_SUBSCRIBERid
ブロードキャストの一覧表示KIT_LIST_BROADCASTSper_page, after
ブロードキャストの取得KIT_GET_BROADCASTid
ブロードキャスト統計の取得KIT_GET_BROADCAST_STATSid
ブロードキャストの削除KIT_DELETE_BROADCASTid

Composio 提供

コメント

Markdown 対応