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

customerio-cost-tuning — скилл для Claude Code

Скилл customerio-cost-tuning ищет переплату в Customer.io: лишние профили, неактивные аккаунты, дубли событий. Показывает, что можно убрать, не тронув доставку.

MIT 1 установок ★ 2 935 обновлён 2026-10-29

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add jeremylongshore/tons-of-skills-marketplace --skill customerio-cost-tuning -a claude-code
Открыть на GitHub

Что делает customerio-cost-tuning

Логика простая: Customer.io берёт деньги за число идентифицированных профилей и за объём писем с SMS. Профили — главная статья, поэтому аудит ищет лишних: людей без email, тестовые аккаунты с префиксами test-, ci-, dev-, анонимов старше 90 дней и тех, кто не открывал письма дольше 180 дней.

Дальше два TypeScript-скрипта на customerio-node. Первый подавляет профиль, а потом удаляет его, с паузой 20 мс между вызовами на массовых прогонах. Второй хеширует событие и отбрасывает повторы в окне минуты, чтобы дубли не доезжали до API.

В окружении нужны CUSTOMERIO_SITE_ID и CUSTOMERIO_TRACK_API_KEY, иначе скрипты не запустятся. Удаление стартует в dry run, так что первый прогон только печатает список целей. Ещё скилл ждёт согласованного владельца расходов, базовый замер биллинга и политику хранения сообщений: если правка задевает доставку или согласия, её не применяют без одобрения ответственного.

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

  • найти профили, за которые платишь впустую
  • вычистить неактивных, не остановив рассылки
  • убрать дубли событий до отправки в API
  • оценить расход на кампанию в staging
  • согласовать сокращение бюджета и порог откатa

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

  • Посчитай, во сколько нам обходится Customer.io: сколько профилей и сколько отправок.
  • Почисти Customer.io от неактивных: сначала покажи список в dry run.
  • Проверь трекинг Customer.io на дубли событий и предложи идемпотентную отправку.

Как установить customerio-cost-tuning

1Через Skills CLI (Vercel)

npx skills add jeremylongshore/tons-of-skills-marketplace --skill customerio-cost-tuning -a claude-code

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

~/.claude/skills/customerio-cost-tuning/SKILL.md

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

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

Вопросы о customerio-cost-tuning

Как установить customerio-cost-tuning в Claude Code?

Выполните npx skills add jeremylongshore/tons-of-skills-marketplace --skill customerio-cost-tuning -a claude-code. Скилл окажется по пути ~/.claude/skills/customerio-cost-tuning/SKILL.md.

Что делает customerio-cost-tuning?

Разбирает счёт Customer.io по профилям и отправкам, находит неактивные аккаунты и дубли событий. Скрипты удаляют лишние профили и режут повторную отправку.

Что нужно подготовить до запуска чистки?

Ключи CUSTOMERIO_SITE_ID и CUSTOMERIO_TRACK_API_KEY, базовый замер биллинга и владельца расходов. Без замера не с чем сравнивать результат, а спорную правку не одобрят.

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

SKILL.md · MIT
---
name: customerio-cost-tuning
description: 'Optimize Customer.io costs and usage efficiency.

  Use when reducing profile count, cleaning inactive users,

  deduplicating events, or right-sizing your plan.

  Trigger: "customer.io cost", "reduce customer.io spend",

  "customer.io billing", "customer.io pricing", "customer.io cleanup".

  '
allowed-tools: Read, Write, Edit, Bash(npm:*), Bash(npx:*), Glob, Grep
version: 1.14.0
license: MIT
author: Jeremy Longshore <[email protected]>
tags:
- saas
- customer-io
- cost-optimization
- billing
compatibility: Designed for Claude Code
---
# Customer.io Cost Tuning

## Prerequisites

- An approved cost owner, billing/usage baseline, message/event retention policy, and delivery SLO.
- Aggregate reporting that does not require exporting customer payloads or individual message content.

## Output

- A measured cost optimization with owner, delivery/consent guardrails, and rollback threshold.
- An aggregate usage receipt supporting the decision without exposing recipient data.

## Error Handling

| Condition | Safe response |
|---|---|
| Spend rises unexpectedly | Verify configuration, rate, and authorized campaigns; pause unsafe scale changes and investigate aggregate signals. |
| Optimization risks delivery or consent | Do not apply it until the service/data owner approves a safe test. |
| Data is missing or misallocated | Repair attribution before making a budget decision. |

## Examples

Compare aggregate event volume and message spend for a development/staging campaign, reduce unnecessary duplicate events through an idempotency fix, and observe the agreed window. Revert if delivery errors, latency, or consent checks regress; do not suppress customer messages solely to make a dashboard look cheaper.

## Overview

Optimize Customer.io costs by managing profile count (the primary billing driver), suppressing/deleting inactive users, deduplicating events, reducing unnecessary API calls, and monitoring usage trends.

## How Customer.io Pricing Works

Customer.io bills based on **profile count** (number of identified people in your workspace) and **email/SMS volume**. Key cost drivers:

| Factor | Impact | Optimization Strategy |
|--------|--------|----------------------|
| Total profiles | Primary cost driver | Delete inactive profiles |
| Email sends | Per-email cost above tier | Suppress unengaged users |
| SMS sends | Per-SMS cost | Only send to opt-in users |
| Overidentification | Creates unnecessary profiles | Don't identify users who'll never receive messages |
| Event volume | Can increase processing costs | Deduplicate and sample |

## Instructions

### Step 1: Profile Audit

```typescript
// scripts/cio-profile-audit.ts
// Audit your Customer.io integration for cost optimization opportunities

import { TrackClient, RegionUS } from "customerio-node";

const cio = new TrackClient(
  process.env.CUSTOMERIO_SITE_ID!,
  process.env.CUSTOMERIO_TRACK_API_KEY!,
  { region: RegionUS }
);

// Check: Are you identifying users who'll never receive messages?
const AUDIT_RULES = {
  // Users without email can't receive email campaigns
  noEmail: "Don't identify users without email unless using push/SMS",

  // Test users should be cleaned up
  testUsers: "Suppress and delete test-*, ci-*, dev-* prefixed users",

  // Anonymous users that never convert inflate profile count
  staleAnonymous: "Delete anonymous profiles older than 90 days without conversion",

  // Inactive users who haven't opened email in 6+ months
  unengaged: "Suppress users with no email opens in 180+ days",
};

console.log("=== Customer.io Cost Audit Rules ===\n");
for (const [rule, action] of Object.entries(AUDIT_RULES)) {
  console.log(`${rule}: ${action}`);
}
console.log("\nRun these checks in Customer.io dashboard:");
console.log("1. People > Segments > Create 'Inactive 90 days' segment");
console.log("2. People > Segments > Create 'No email attribute' segment");
console.log("3. People > Filter by created_at < 90 days ago AND email_opened = 0");
```

### Step 2: Suppress and Delete Inactive Users

```typescript
// scripts/cio-cleanup-inactive.ts
import { TrackClient, RegionUS } from "customerio-node";

const cio = new TrackClient(
  process.env.CUSTOMERIO_SITE_ID!,
  process.env.CUSTOMERIO_TRACK_API_KEY!,
  { region: RegionUS }
);

interface CleanupTarget {
  userId: string;
  reason: string;
}

async function cleanupInactiveUsers(
  targets: CleanupTarget[],
  dryRun: boolean = true
): Promise<void> {
  let suppressed = 0;
  let deleted = 0;
  let errors = 0;

  for (const target of targets) {
    if (dryRun) {
      console.log(`[DRY RUN] Would suppress+delete: ${target.userId} (${target.reason})`);
      continue;
    }

    try {
      // Step 1: Suppress — stops all messaging immediately
      await cio.suppress(target.userId);
      suppressed++;

      // Step 2: Destroy — removes from billing
      await cio.destroy(target.userId);
      deleted++;

      // Rate limit to 50/sec for bulk operations
      await new Promise((r) => setTimeout(r, 20));
    } catch (err: any) {
      errors++;
      console.error(`Failed ${target.userId}: ${err.message}`);
    }

    if ((suppressed + errors) % 100 === 0) {
      console.log(`Progress: ${suppressed} deleted, ${errors} errors`);
    }
  }

  console.log(`\nResult: ${suppressed} suppressed, ${deleted} deleted, ${errors} errors`);
}

// Usage: Build target list from your database
// const inactiveUsers = await db.query(`
//   SELECT id FROM users
//   WHERE last_login_at < NOW() - INTERVAL '180 days'
//   AND email_verified = false
// `);
```

### Step 3: Event Deduplication

```typescript
// lib/customerio-dedup-events.ts
// Prevent sending duplicate events that inflate volume

import { createHash } from "crypto";
import { TrackClient, RegionUS } from "customerio-node";

const cio = new TrackClient(
  process.env.CUSTOMERIO_SITE_ID!,
  process.env.CUSTOMERIO_TRACK_API_KEY!,
  { region: RegionUS }
);

// Simple LRU dedup (use Redis in production)
const recentEvents = new Map<string, number>();
const MAX_CACHE = 50_000;
const DEDUP_WINDOW_MS = 60 * 1000;  // 1 minute window

function isDuplicate(userId: string, eventName: string, data?: any): boolean {
  const hash = createHash("sha256")
    .update(`${userId}:${eventName}:${JSON.stringify(data ?? {})}`)
    .digest("hex")
    .substring(0, 12);

  const last = recentEvents.get(hash);
  if (last && Date.now() - last < DEDUP_WINDOW_MS) {
    return true;
  }

  recentEvents.set(hash, Date.now());

  // Prevent unbounded growth
  if (recentEvents.size > MAX_CACHE) {
    const cutoff = Date.now() - DEDUP_WINDOW_MS;
    for (const [key, time] of recentEvents) {
      if (time < cutoff) recentEvents.delete(key);
    }
  }

  return false;
}

export async function trackDeduped(
  userId: string,
  name: string,
  data?: Record<string, any>
): Promise<void> {
  if (isDuplicate(userId, name, data)) {
    return; // Skip duplicate
  }
  await cio.track(userId, { name, data });
}
```

### Step 4: Event Sampling for High-Volume Events

```typescript
// lib/customerio-sampling.ts
// Sample high-volume events to reduce API calls

const EVENT_SAMPLE_RATES: Record<string, number> = {
  page_viewed: 0.1,          // Sample 10% of page views
  button_clicked: 0.25,      // Sample 25% of clicks
  search_performed: 0.5,     // Sample 50% of searches
  signed_up: 1.0,            // Always track signups
  checkout_completed: 1.0,   // Always track purchases
  subscription_cancelled: 1.0, // Always track cancellations
};

export function shouldTrack(eventName: string): boolean {
  const rate = EVENT_SAMPLE_RATES[eventName] ?? 1.0;
  return Math.random() < rate;
}

// Usage
if (shouldTrack("page_viewed")) {
  await cio.track(userId, {
    name: "page_viewed",
    data: { url: "/pricing", sampled: true },
  });
}
```

### Step 5: Usage Monitoring

```typescript
// scripts/cio-usage-monitor.ts
// Track your Customer.io usage trends

interface UsageMetrics {
  identifyCalls: number;
  trackCalls: number;
  transactionalSends: number;
  broadcastTriggers: number;
  webhooksReceived: number;
}

class UsageMonitor {
  private metrics: UsageMetrics = {
    identifyCalls: 0,
    trackCalls: 0,
    transactionalSends: 0,
    broadcastTriggers: 0,
    webhooksReceived: 0,
  };

  increment(metric: keyof UsageMetrics): void {
    this.metrics[metric]++;
  }

  report(): void {
    console.log("\n=== Customer.io Usage Report ===");
    console.log(`Period: ${new Date().toISOString()}`);
    for (const [key, value] of Object.entries(this.metrics)) {
      console.log(`  ${key}: ${value.toLocaleString()}`);
    }
    const total = Object.values(this.metrics).reduce((a, b) => a + b, 0);
    console.log(`  TOTAL API calls: ${total.toLocaleString()}`);
  }

  reset(): void {
    for (const key of Object.keys(this.metrics)) {
      this.metrics[key as keyof UsageMetrics] = 0;
    }
  }
}

export const usageMonitor = new UsageMonitor();
```

## Cost Savings Estimates

| Optimization | Typical Savings | Implementation Effort |
|--------------|-----------------|----------------------|
| Delete inactive profiles (180+ days) | 15-30% profile cost | Low |
| Event deduplication | 5-15% event volume | Low |
| Event sampling (analytics events) | 50-80% event volume for sampled events | Low |
| Suppress bounced emails | 2-5% email cost | Low |
| Don't identify email-less users | 5-20% profile cost | Medium |
| Annual billing | 10-20% total cost | None |

## Monthly Cost Review Checklist

- [ ] Review profile count trend (People > Overview)
- [ ] Identify and delete stale test profiles
- [ ] Review segment for users with no email attribute
- [ ] Check bounce rate and suppress chronic bouncers
- [ ] Review event volume by type (optimize high-volume/low-value events)
- [ ] Compare plan tier vs actual usage

## Resources

- [Customer.io Pricing](https://customer.io/pricing/)
- [Track API - Suppress/Destroy](https://docs.customer.io/integrations/api/track/)

## Next Steps

After cost optimization, proceed to `customerio-reference-architecture` for enterprise patterns.

© Jeremy Longshore · MIT · jeremylongshore/tons-of-skills-marketplace

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

Все скиллы по теме «Маркетинг и контент» →
aws-billing-and-cost-management aws Скилл aws-billing-and-cost-management анализирует расходы в AWS, ищет резервы экономии и настраивает бюджеты. Помогает проверить аномалии цен, оценить Savings Plans и снизить затраты на инфраструктуру. CX Codex +1 10 300установок AWS Billing and Cost Management awslabs MCP-сервер, через который агент читает данные AWS Billing and Cost Management: расходы, бюджеты, аномалии, обязательства по скидкам и счета. CX Codex +1 ★ 9 939звёзд репо az-cost-optimize официальный github Скилл az-cost-optimize анализирует Azure-ресурсы и IaC, ищет варианты снижения затрат и создаёт GitHub issues после подтверждения. Нужен при ревизии расходов проекта в Azure. CX Codex +1 8 700установок cost-optimization rampstackco Скилл cost-optimization для Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode, который проводит аудит облачных и SaaS-расходов по пяти рычагам. CX Codex +1 283установок aws-cost-optimization ahmedasmar Скилл aws-cost-optimization помогает разбирать расходы AWS: искать неиспользуемые ресурсы, проверять рекомендации по размерам и анализировать варианты RI и Savings Plans. CX Codex +1 222установок cost-audit runpod Скилл cost-audit разбирает расходы аккаунта Runpod по ресурсам и находит причины списаний за простаивающие Pod или serverless-воркеры. Он пригодится, когда нужно понять, за что начисляется плата. CX Codex +1 3 700установок

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

Весь набор →
retention-calculator Скилл помогает разбирать задачи retention calculator в аналитике данных, готовит код и конфигурации. Активируется по запросу о retention. CX Codex +1 1установок metric-calculator Автоактивируемый скилл для задач Data Analytics. Включается по фразам «metric calculator» и «metric», помогает с SQL-запросами, визуализацией и статистикой. CX Codex +1 1установок klingai-usage-analytics Скилл klingai-usage-analytics настраивает учёт генераций видео в Kling AI, считая потраченные кредиты и ошибки по логам JSONL. Помогает следить за расходами на видео. CX Codex +1 1установок cursor-usage-analytics Скилл cursor-usage-analytics для Cursor анализирует запросы, модели, расходы и вовлечённость команды. Собирает отчёты и помогает контролировать квоты. CX Codex +1 1установок apollo-core-workflow-a Скилл apollo-core-workflow-a настраивает пайплайн лидогенерации через Apollo.io: ищет компании и контакты, а затем обогащает выбранные лиды телефонами и почтой. CX Codex +1 1установок firecrawl-migration-deep-dive Скилл firecrawl-migration-deep-dive помогает заменить Puppeteer, Playwright, Cheerio или другой скрейпер на Firecrawl v2 с проверкой паритета, политик, стоимости и отката. CX Codex +1 1установок vercel-webhooks-events Скилл vercel-webhooks-events для Claude Code, Codex, Cursor и других платформ обрабатывает события развёртывания Vercel с проверкой подписи HMAC. CX Codex +1 1установок vercel-reference-architecture Скилл vercel-reference-architecture разворачивает эталонную архитектуру для Next.js на Vercel. Помогает настроить слои edge и serverless, структурировать API и защитить роуты. CX Codex +1 1установок

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

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