clay-local-dev-loop

# Clay Local Dev Loop ## Overview Clay is a web-based platform with no local runtime. Your local dev loop consists of: (1) scripts that push data into Clay via webhooks, (2) Clay enrichment running in the cloud, and (3) HTTP API columns pushing enriched data back to your local endpoint via ngrok. This skill sets up that feedback loop. ## Prerequisites - Completed `clay-install-auth` setup - Node.js 18+ or Python 3.10+ - ngrok installed (`npm install -g ngrok` or [ngrok.com](https://ngrok.com)) - Clay table with webhook source configured ## Instructions ### Step 1: Expose Your Local Server via ngrok Clay's HTTP API enrichment columns need a public URL to call your local endpoints. ```bash # Start ngrok tunnel to your local server ngrok http 3000 # Copy the HTTPS forwarding URL (e.g., https://abc123.ngrok-free.app) ``` ### Step 2: Create a Local Webhook Receiver ```typescript // src/clay-receiver.ts — receives enriched data from Clay HTTP API columns import express from 'express'; const app = express(); app.use(express.json()); // Clay HTTP API column calls this endpoint app.post('/api/clay/enriched', (req, res) => { const enrichedData = req.body; console.log('Enriched record received from Clay:', { email: enrichedData.email, company: enrichedData.company_name, title: enrichedData.job_title, enrichment_source: enrichedData._clay_source, }); // Process the enriched data (save to DB, trigger outreach, etc.) res.json({ status: 'received', tim...