Made by@gtmengineerEnrichment waterfall planner
@gtmengineer/enrichment-waterfall-planner
Plan an enrichment waterfall with real math. Give it your providers with cost, match rate, and accuracy (or a sample test run), and it tries every order to find the cheapest setup that hits your fill target, with cost per usable record, the marginal cost of each step, and where to stop. Vendor-neutral.
- Activity
- New: be the first to try it
- Installs
- 0 installs
- Likes
- 0 likes
- Clones
- 0 clones
- 1# Enrichment waterfall planner
- 3Works out the best order for your enrichment providers and where to stop. It tries every order, models per-lookup vs per-match pricing, accuracy, and verification, and tells you the cost per usable record and what each extra provider really adds.
- 5## Who it is for
- 7GTM engineers, RevOps, and growth teams enriching contacts or accounts with several data providers, who want to hit a fill target without overpaying. Vendor-neutral: you name the providers.
- 9## Example
- 11Input: `examples/providers.json` (four providers, verified work email, 10,000 records, 70% target) and `examples/sample.csv` (a 10-record test run).
- 13Output (`out/waterfall.md`):
- 15```text
- 16Recommended order: provider-c > provider-a > provider-b: 77.1% usable fill,
- 17total 1591.9, 0.206 per usable record.
- 18Best by number of providers: 1 = 58.2%, 2 = 78.9%, 3 = 88.4%, 4 = 89.3% fill.
- 19```
- 21With per-step lookups, found, usable, cost, and the marginal cost of each extra usable record.
- 23## What it can access
- 25- Runs `node scripts/waterfall.mjs` (Node built-ins only, no network, no provider APIs).
- 26- Reads `data/` (plus the kit's own `examples/`), writes `data/` and `out/`.
- 28## Setup
- 30None. Put your providers' prices and rates in `data/providers.json`, ideally with a sample test run in `data/sample.csv`.