Enrich Waterfall

enrich-waterfall

When To Use

Use when the caller has a partial identifier — an email, a name + company, a domain, or a LinkedIn URL — and wants a fuller person and/or company profile, with contact details (email + phone), tech stack, company signals (funding / news / hiring), and social presence.

The defining behavior is cheapest-first with escalation: spend sub-cent calls to resolve identity, anchor the company, and fan out to enrichment slices; only reach for the premium reveals (Clado contacts, Clado natural-language people search) when the cheap tiers leave a gap; verify the email last.

Do not use this for crypto/market price lookups (see market-snapshot, allium-price) or for a single one-off enrichment call (call that merchant directly).

Workflow

1. Install: selat skill install enrich-waterfall
2. Run: selat skill run enrich-waterfall [--email ...] [--name ...] [--firstName ...] [--lastName ...] [--domain ...] [--company ...] [--linkedinUrl ...] [--organizationId ...]
3. The CLI compiles each manifest step into a selat-pay call, runs the steps in order, and prints a per-step status + cost summary. Every step is via the SELAT Router through the SELAT Router (MPP) except the SELAT-native X/Twitter profile step, which is a x402 via Circle Gateway Circle x402 call (Circle Gateway-batched).

The waterfall (cheapest-first, with stop/escalation conditions)

Steps in manifest.json are ordered cheapest-first by tier (and cheapest-first within each tier, using live prices probe-verified 2026-07-10). Walk them in order and stop climbing a branch the moment you have what you need:

1. resolve ($0.0084–$0.024) — Apollo people-enrichment (one call takes email, name+company, domain and LinkedIn URL together), Hunter email-enrichment / combined-enrichment by email, Clado linkedin-profile by LinkedIn URL. Goal: turn the input into a person record + company handle (domain, LinkedIn). Stop condition: once a resolve call returns a confident match with a domain and a LinkedIn URL, you do not need the remaining resolve calls.

2. anchor ($0.0053–$0.014) — pin the company: Apollo org-search by name (the no-domain fallback), Abstract Company Enrichment lookup and Apollo org-enrichment by domain, Hunter company-enrichment, plus Hunter email-finder to derive the canonical address from domain + name. Tech stack (technology_names), headcount and industry/SIC now ride along with these anchor calls — there is no separate tech tier. Capture the Apollo organization_id from org-enrichment/org-search: the job-postings signals step needs it. Stop condition: one good firmographic record + one candidate email is enough to move on.

3. social / signals ($0.0004–$0.063) — enrichment fan-out, run only the slices the caller asked for:

   • social — SELAT-native X/Twitter profile (x402 via Circle Gateway, $0.001), Clado scrape for LinkedIn person/company posts, StableSocial Instagram/TikTok profiles by handle.
   • signals — Apollo job-postings (needs organizationId from the anchor tier), Brave news search for company news and funding rounds, Diffbot KG enhance for the organization record (funding rounds, investors and business connections all come back in that one call).

4. escalate ($0.045–$0.32) — premium reveals, run only on gaps: if the cheap tiers did not surface a usable email or a phone, climb to Clado contacts (contact enrichment incl. phone, from a LinkedIn URL) or Clado search (synchronous natural-language people search — e.g. resolving a person from an X/Twitter handle). Escalation condition: a missing-or-low-confidence email/phone after tiers 1–3. If you already have a verified work email and no phone was requested, skip this tier entirely.

5. verify ($0.0084) — last: Hunter email-verifier confirms the chosen email is deliverable before shipping it.

Per-step caps come from each step's maxAmount (~10x each live price, $0.10–$1.00); the manifest top-level fallback maxAmount is $1.00. Live prices for all 20 steps sum to ≈ $0.74, and running every branch is rarely necessary — a typical resolve + anchor + one escalate + verify is well under ten cents.

Inputs And Outputs

All params are optional, but at least one identifier must be supplied — supply the strongest you have (email > LinkedIn URL > domain + name > company). Each step only fires usefully when its required ${...} placeholders are filled; pass empty strings for the rest.

Outputs: per-step JSON from each merchant (person record, firmographics, contact points, tech list, signal arrays, social profiles) plus the CLI's per-step status/cost summary. Treat the highest-confidence email + phone across the tiers as the canonical result, and ship only an email that passed the verify tier.

Gotchas

• All via the SELAT Router — SELAT_ROUTER_URL must be set and the router reachable for the 19 SELAT Router steps; the SELAT-native X/Twitter step also settles through the SELAT Router, like the other x402 call and settles via Circle Gateway.
• Don't run all 20 steps. The manifest is a menu ordered cheapest-first; the agent walks it and stops per the stop/escalation conditions above. Blindly running every branch wastes money (≈ $0.74 for everything) even within the per-step caps.
• organizationId is a chained input — Apollo job-postings takes an organization id, not a domain; pull it from the Apollo org-enrichment/org-search response before firing the hiring-signals step.
• Deliberate near-duplicates — the two Brave news-search steps hit the same endpoint with different queries ("${company} news" vs "${company} funding round"); they are separate on purpose. The Diffbot KG enhance call covers funding rounds, investors and connections in one response — do not call it once per slice.
• Escalate is expensive — Clado search ($0.32) and Clado contacts ($0.045) dominate the cost; gate them behind a real gap.
• Verify last, not first — verifying an email you're about to discard wastes the call.

Validation

--chain base in the probe commands below is only the flag selat-pay requires today — a probe reads a free, chain-independent quote and never settles. A real paid run resolves the settlement chain from your funded Circle Gateway balance, not the manifest.

• Probe any step for free with selat-pay's --probe-only (sends the 402 preflight, pays nothing):
  • selat-pay POST "https://hunter.mpp.paywithlocus.com/hunter/email-enrichment" --body '{"email":"test@stripe.com"}' --chain base --probe-only
  • selat-pay POST "https://apollo.mpp.paywithlocus.com/apollo/org-enrichment" --body '{"domain":"stripe.com"}' --chain base --probe-only
  • selat-pay POST "https://clado.mpp.paywithlocus.com/clado/contacts" --body '{"linkedin_url":"https://linkedin.com/in/williamhgates"}' --chain base --probe-only
  • selat-pay GET "https://catalog.selat.ai/twitter/user/info?userName=patrickc" --chain base --probe-only
• Validate the recipe locally: python3 -c "import json; json.load(open('manifest.json'))".
• A clean run prints status=200 for the steps that fired and a per-step cost summary; the SELAT Router steps each show a SELAT Router hop.

References

• manifest.json — the machine-readable, cheapest-first payment recipe this skill runs.
• references/endpoints.md — every endpoint, price, tier, and source.
• evals/evals.json — trigger + output-quality evals.
• selat-pay — https://github.com/SELAT-AI/selat-pay