clay-load-scale

name	clay-load-scale
description	Scale Clay enrichment pipelines for high-volume processing (10K-100K+ leads/month). Use when planning capacity for large enrichment runs, optimizing batch processing, or designing high-volume Clay architectures. Trigger with phrases like "clay scale", "clay high volume", "clay large batch", "clay capacity planning", "clay 100k leads", "clay bulk enrichment".
allowed-tools	Read, Write, Edit, Bash(curl:*), Bash(node:*)
version	1.14.0
license	MIT
author	Jeremy Longshore <[e-mail]>
tags	["saas","clay","testing","performance","scaling"]
compatibility	Designed for Claude Code, also compatible with Codex and OpenClaw

Clay Load & Scale

Overview

Strategies for processing 10K-100K+ leads through Clay monthly. Clay is a hosted platform -- you can't add servers. Scaling focuses on: table partitioning, webhook management, batch submission pacing, credit budgeting at scale, and multi-table architectures.

Prerequisites

• Clay Growth or Enterprise plan
• Understanding of Clay's credit model (Data Credits + Actions)
• Queue infrastructure for batch processing (Redis, SQS, or BullMQ)
• Monitoring for credit consumption

Instructions

Step 1: Capacity Planning

// src/clay/capacity-planner.ts
interface CapacityPlan {
  monthlyLeads: number;
  creditsPerLead: number;
  totalCreditsNeeded: number;
  planRequired: string;
  estimatedMonthlyCost: number;
  webhooksNeeded: number;        // Each webhook has 50K lifetime limit
  tablesRecommended: number;
}

function planCapacity(monthlyLeads: number, creditsPerLead = 6): CapacityPlan {
  const totalCredits = monthlyLeads * creditsPerLead;

  // Determine plan
  let plan: string, cost: number;
  if (totalCredits <= 2500) {
    plan = 'Launch ($185/mo)';
    cost = 185;
  } else if (totalCredits <= ) {
    plan = ;
    cost = ;
  }  {
    plan = ;
    cost =  + .((totalCredits - ) / ) * ; 
  }

  
  .();
  .();

   {
    monthlyLeads,
    creditsPerLead,
    : totalCredits,
    : plan,
    : cost,
    : .(monthlyLeads /  * ), 
    : .(monthlyLeads / ), 
  };
}


 plan = ();
.(plan);