К основному содержанию
скилл CX Codex

convertkit-automation — скилл для Claude Code

Скилл convertkit-automation автоматизирует работу с ConvertKit (Kit) через Rube MCP: поиск и фильтрацию подписчиков, присвоение тегов, отправку рассылок и сбор статистики. Нужен подключённый Rube MCP и активное подключение к Kit.

MIT 123 установок ★ 3 785 обновлён 2026-10-25

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add davepoon/buildwithclaude --skill convertkit-automation -a claude-code
Открыть на GitHub

Что делает convertkit-automation

Скилл работает через Rube MCP и инструментарий Composio Kit, позволяя управлять подписчиками по статусу, дате, поиску по почте, присваивать теги для сегментации и просматривать истории рассылок. Перед каждой операцией нужно вызвать RUBE_SEARCH_TOOLS, чтобы получить актуальные схемы инструментов — API может измениться.

Основные операции: поиск подписчиков с фильтрацией и пагинацией, присвоение и удаление тегов, удаление подписчиков (отписка), просмотр черновиков и отправленных рассылок со статистикой. Для работы требуется Rube MCP (просто добавьте https://rube.app/mcp в конфиг) и активное подключение к Kit через RUBE_MANAGE_CONNECTIONS — ключей API не нужно.

Осторожнее с параметрами: include_total_count — это строка 'true', а не булево значение, email_address ищет точное совпадение (частичный поиск не работает), сортировка по cancelled_at требует status='cancelled'. Удаление подписчика постоянно, а удаление рассылки не отменяет уже отправленные письма.

Какие задачи решает

  • Найти подписчика по адресу электронной почты и вывести его данные
  • Присвоить группу подписчиков к тегу для сегментации по интересам
  • Отписать подписчика от всех рассылок
  • Получить список отправленных рассылок и статистику открытий
  • Удалить черновик или отправленную рассылку

Примеры запросов агенту

  • Найди подписчика с адресом [email protected] и покажи его ID и статус
  • Добавь всех подписчиков со статусом active к тегу с ID 42
  • Отпиши подписчика с ID 3887204736 от всех рассылок

Как установить convertkit-automation

1Через Skills CLI (Vercel)

npx skills add davepoon/buildwithclaude --skill convertkit-automation -a claude-code

2Вручную: положить файлы

~/.claude/skills/convertkit-automation/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/convertkit-automation/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о convertkit-automation

Как установить convertkit-automation в Claude Code?

Выполните команду npx skills add davepoon/buildwithclaude --skill convertkit-automation -a claude-code, затем откройте ~/.claude/skills/convertkit-automation/SKILL.md. Для других платформ используйте соответствующий флаг: -a codex для Codex, -a cursor для Cursor, -a gemini-cli для Gemini CLI.

Что такое convertkit-automation?

Это скилл для управления ConvertKit (Kit) прямо из AI-редактора через Rube MCP. Позволяет искать подписчиков, присваивать теги, отписывать людей и просматривать статистику рассылок без ручного входа на сайт Kit.

Какие есть требования для работы?

Нужны: Rube MCP (добавьте https://rube.app/mcp в конфиг клиента), активное подключение к Kit через RUBE_MANAGE_CONNECTIONS, и вызов RUBE_SEARCH_TOOLS перед каждой операцией. Ключей API не требуется.

Исходный текст

SKILL.md · MIT
---
name: convertkit-automation
description: "Automate ConvertKit (Kit) tasks via Rube MCP (Composio): manage subscribers, tags, broadcasts, and broadcast stats. Always search tools first for current schemas."
requires:
  mcp: [rube]
category: email
---

# ConvertKit (Kit) Automation via Rube MCP

Automate ConvertKit (now known as Kit) email marketing operations through Composio's Kit toolkit via Rube MCP.

**Toolkit docs**: [composio.dev/toolkits/kit](https://composio.dev/toolkits/kit)

## Prerequisites

- Rube MCP must be connected (RUBE_SEARCH_TOOLS available)
- Active Kit connection via `RUBE_MANAGE_CONNECTIONS` with toolkit `kit`
- Always call `RUBE_SEARCH_TOOLS` first to get current tool schemas

## Setup

**Get Rube MCP**: Add `https://rube.app/mcp` as an MCP server in your client configuration. No API keys needed — just add the endpoint and it works.


1. Verify Rube MCP is available by confirming `RUBE_SEARCH_TOOLS` responds
2. Call `RUBE_MANAGE_CONNECTIONS` with toolkit `kit`
3. If connection is not ACTIVE, follow the returned auth link to complete Kit authentication
4. Confirm connection status shows ACTIVE before running any workflows

## Core Workflows

### 1. List and Search Subscribers

**When to use**: User wants to browse, search, or filter email subscribers

**Tool sequence**:
1. `KIT_LIST_SUBSCRIBERS` - List subscribers with filters and pagination [Required]

**Key parameters**:
- `status`: Filter by status ('active' or 'inactive')
- `email_address`: Exact email to search for
- `created_after`/`created_before`: Date range filter (YYYY-MM-DD)
- `updated_after`/`updated_before`: Date range filter (YYYY-MM-DD)
- `sort_field`: Sort by 'id', 'cancelled_at', or 'updated_at'
- `sort_order`: 'asc' or 'desc'
- `per_page`: Results per page (min 1)
- `after`/`before`: Cursor strings for pagination
- `include_total_count`: Set to 'true' to get total subscriber count

**Pitfalls**:
- If `sort_field` is 'cancelled_at', the `status` must be set to 'cancelled'
- Date filters use YYYY-MM-DD format (no time component)
- `email_address` is an exact match; partial email search is not supported
- Pagination uses cursor-based approach with `after`/`before` cursor strings
- `include_total_count` is a string 'true', not a boolean

### 2. Manage Subscriber Tags

**When to use**: User wants to tag subscribers for segmentation

**Tool sequence**:
1. `KIT_LIST_SUBSCRIBERS` - Find subscriber ID by email [Prerequisite]
2. `KIT_TAG_SUBSCRIBER` - Associate a subscriber with a tag [Required]
3. `KIT_LIST_TAG_SUBSCRIBERS` - List subscribers for a specific tag [Optional]

**Key parameters for tagging**:
- `tag_id`: Numeric tag ID (required)
- `subscriber_id`: Numeric subscriber ID (required)

**Pitfalls**:
- Both `tag_id` and `subscriber_id` must be positive integers
- Tag IDs must reference existing tags; tags are created via the Kit web UI
- Tagging an already-tagged subscriber is idempotent (no error)
- Subscriber IDs are returned from LIST_SUBSCRIBERS; use `email_address` filter to find specific subscribers

### 3. Unsubscribe a Subscriber

**When to use**: User wants to unsubscribe a subscriber from all communications

**Tool sequence**:
1. `KIT_LIST_SUBSCRIBERS` - Find subscriber ID [Prerequisite]
2. `KIT_DELETE_SUBSCRIBER` - Unsubscribe the subscriber [Required]

**Key parameters**:
- `id`: Subscriber ID (required, positive integer)

**Pitfalls**:
- This permanently unsubscribes the subscriber from ALL email communications
- The subscriber's historical data is retained but they will no longer receive emails
- Operation is idempotent; unsubscribing an already-unsubscribed subscriber succeeds without error
- Returns empty response (HTTP 204 No Content) on success
- Subscriber ID must exist; non-existent IDs return 404

### 4. List and View Broadcasts

**When to use**: User wants to browse email broadcasts or get details of a specific one

**Tool sequence**:
1. `KIT_LIST_BROADCASTS` - List all broadcasts with pagination [Required]
2. `KIT_GET_BROADCAST` - Get detailed information for a specific broadcast [Optional]
3. `KIT_GET_BROADCAST_STATS` - Get performance statistics for a broadcast [Optional]

**Key parameters for listing**:
- `per_page`: Results per page (1-500)
- `after`/`before`: Cursor strings for pagination
- `include_total_count`: Set to 'true' for total count

**Key parameters for details**:
- `id`: Broadcast ID (required, positive integer)

**Pitfalls**:
- `per_page` max is 500 for broadcasts
- Broadcast stats are only available for sent broadcasts
- Draft broadcasts will not have stats
- Broadcast IDs are numeric integers

### 5. Delete a Broadcast

**When to use**: User wants to permanently remove a broadcast

**Tool sequence**:
1. `KIT_LIST_BROADCASTS` - Find the broadcast to delete [Prerequisite]
2. `KIT_GET_BROADCAST` - Verify it is the correct broadcast [Optional]
3. `KIT_DELETE_BROADCAST` - Permanently delete the broadcast [Required]

**Key parameters**:
- `id`: Broadcast ID (required)

**Pitfalls**:
- Deletion is permanent and cannot be undone
- Deleting a sent broadcast removes it but does not unsend the emails
- Confirm the broadcast ID before deleting

## Common Patterns

### Subscriber Lookup by Email

```
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
```

### Pagination

Kit uses cursor-based pagination:
- Check response for `after` cursor value
- Pass cursor as `after` parameter in next request
- Continue until no more cursor is returned
- Use `include_total_count: 'true'` to track progress

### Tag-Based Segmentation

```
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
```

## Known Pitfalls

**ID Formats**:
- Subscriber IDs: positive integers (e.g., 3887204736)
- Tag IDs: positive integers
- Broadcast IDs: positive integers
- All IDs are numeric, not strings

**Status Values**:
- Subscriber statuses: 'active', 'inactive', 'cancelled'
- Some operations are restricted by status (e.g., sorting by cancelled_at requires status='cancelled')

**String vs Boolean Parameters**:
- `include_total_count` is a string 'true', not a boolean true
- `sort_order` is a string enum: 'asc' or 'desc'

**Rate Limits**:
- Kit API has per-account rate limits
- Implement backoff on 429 responses
- Bulk operations should be paced appropriately

**Response Parsing**:
- Response data may be nested under `data` or `data.data`
- Parse defensively with fallback patterns
- Cursor values are opaque strings; use exactly as returned

## Quick Reference

| Task | Tool Slug | Key Params |
|------|-----------|------------|
| List subscribers | KIT_LIST_SUBSCRIBERS | status, email_address, per_page |
| Tag subscriber | KIT_TAG_SUBSCRIBER | tag_id, subscriber_id |
| List tag subscribers | KIT_LIST_TAG_SUBSCRIBERS | tag_id |
| Unsubscribe | KIT_DELETE_SUBSCRIBER | id |
| List broadcasts | KIT_LIST_BROADCASTS | per_page, after |
| Get broadcast | KIT_GET_BROADCAST | id |
| Get broadcast stats | KIT_GET_BROADCAST_STATS | id |
| Delete broadcast | KIT_DELETE_BROADCAST | id |

---
*Powered by [Composio](https://composio.dev)*

© davepoon · MIT · davepoon/buildwithclaude

Похожие скиллы

Все скиллы по теме «Маркетинг и контент» →
customer-sales-automation Seth Hobson Плагин customer-sales-automation для Claude Code автоматизирует работу с клиентами: поддержку, воронку продаж, рассылки и связку с CRM. Агент ведёт переписку и сделки. CX Codex ★ 42 780звёзд репо codex-oauth-automation-extension reason-machines Скилл codex-oauth-automation-extension ставит Chrome-расширение, которое само проходит регистрацию и вход в OpenAI OAuth: письма с кодом, подтверждение callback, пакетный прогон по кругу. CX Codex +1 512установок Mailchimp Automation Claude Office Skills Скилл Mailchimp Automation для автоматизации рассылок Mailchimp: собирает кампании, сегментирует подписчиков, настраивает цепочки писем и разбирает отчёты. CX Codex +1 4 800установок marketing-content-pipeline-automation reason-machines Скилл marketing-content-pipeline-automation для Claude Code собирает контент-пайплайн: исследует тренды, генерирует статью и рендерит ролик для Reels, TikTok или Shorts по одному ключу. CX Codex +1 783установок marketing-automation akillness Скилл marketing-automation разбирает расплывчатый маркетинговый запрос на один режим работы, одну дисциплину и один готовый бриф с владельцем и доказательствами. CX Codex +1 381установок reddit-automation flowkit-labs Скилл reddit-automation находит треды на Reddit, где людям нужен ваш продукт, и пишет короткие полезные ответы с раскрытием, что вы связаны с продуктом. CX Codex +1 1 500 000установок

Из того же набора235

Весь набор →
helpdesk-automation Скилл helpdesk-automation автоматизирует чтение тикетов, сохранённых представлений и шаблонов HelpDesk через Rube MCP и Composio. Пригодится поддержке для обзора очереди. CX Codex +1 124установок sentry-automation Скилл sentry-automation для автоматизации задач в Sentry через Rube MCP. Управляйте инцидентами, настраивайте алерты, отслеживайте релизы и мониторьте проекты прямо из IDE. CX Codex +1 123установок cal-com-automation Скилл cal-com-automation для Claude Code и Codex управляет бронированиями, расписанием встреч и вебхуками в Cal.com через Rube MCP. Согласовывает слоты и работает с командными календарями в диалоге с агентом. CX Codex +1 123установок segment-automation Скилл segment-automation для Claude Code связывает агента с Segment через Rube MCP и отправляет события, профили и группы. Задачи: серверная аналитика и пакетная загрузка данных. CX Codex +1 123установок miro-automation Скилл miro-automation управляет досками Miro через Rube MCP: создаёт стикеры, фреймы и связи, ищет элементы и настраивает доступ для коллег. CX Codex +1 123установок vercel-automation Скилл vercel-automation управляет проектами Vercel через Rube MCP: помогает разбирать деплои, настраивать переменные окружения и работать с доменами и DNS. CX Codex +1 123установок close-automation Скилл close-automation автоматизирует рутину в Close CRM через Rube MCP: заводит лидов, регистрирует звонки и SMS, ставит задачи и находит заметки. CX Codex +1 122установок circleci-automation Скилл circleci-automation для Claude Code управляет CircleCI через Rube MCP: запускает пайплайны, проверяет статусы воркфлоу и джобов, скачивает артефакты и результаты тестов. Требует активной авторизации CircleCI через Composio. CX Codex +1 122установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой