leads

Solid

B2B lead discovery and enrichment skill. Finds company addresses, employee emails, and phone numbers filtered by industry, geography, role, and company size. 100% free-tier: orchestrates Claude Code's native WebSearch and WebFetch plus free OSINT subprocesses (theHarvester, crt.sh, whois, GitHub API, OSM Overpass, DNS MX, bash SMTP probe). No paid API keys required — optional env vars (ZUVO_HUNTER_KEY, ZUVO_APOLLO_KEY, ZUVO_GITHUB_TOKEN) are recognized as enhancers but never required. Hybrid mode: supplying --domains triggers enrichment; --industry + --geo triggers discovery. Interactive checkpoints after Phase 1 and Phase 2. Output: CSV + JSON + Markdown in docs/leads/. Optional --gdpr-strict for EU/EEA compliance.

Code & Development 6 stars 0 forks Updated today MIT

Install

View on GitHub

Quality Score: 78/100

Stars 20%
28
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
80
License 10%
100
Description 5%
100

Skill Content

# zuvo:leads Free-tier B2B contact discovery orchestrator. Runs a 7-phase pipeline with interactive checkpoints, parallel-agent dispatch, graceful degradation when tools are missing, and atomic output writes. ## Argument Parsing | Flag | Type | Default | Purpose | |---|---|---|---| | `--industry "<term>"` | string | — | discovery-mode filter | | `--geo "<country\|city>"` | string | — | ISO 3166-1 code or city name | | `--role "<title>"` | string | — | target role | | `--seniority <level>` | enum | any | `c-level,vp,director,manager,ic` | | `--size-band <band>` | enum | any | `1-10`/`11-50`/.../`5001+` | | `--max-results N` | int | 50 | hard cap on contacts | | `--max-companies N` | int | derived | default: ceil(max-results/2) | | `--domains <file>` | path | — | triggers enrichment mode | | `--dedup-against <file>` | path | — | suppress matching records | | `--gdpr-strict` | bool | false | enable GDPR restrictions | | `--keep-phones` | bool | false | only with `--gdpr-strict`; retain all phones | | `--output <slug>` | string | derived | filename stem | | `--resume` | bool | false | continue from checkpoint | | `--no-interactive` | bool | false | auto-accept checkpoints, emit `[AUTO-CHECKPOINT]` | | `--dry-run` | bool | false | plan only, no network calls | Env vars (all optional): `ZUVO_HUNTER_KEY`, `ZUVO_APOLLO_KEY`, `ZUVO_GITHUB_TOKEN`, `ZUVO_LEADS_OUTPUT_DIR`, `ZUVO_LEADS_DISABLED`, `ZUVO_SMTP_PROBE_CMD`, `ZUVO_LEADS_ALLOW_INSECURE_CONFIG`. API keys MUST come from env/c...

Details

Author
greglas75
Repository
greglas75/zuvo
Created
4 months ago
Last Updated
today
Language
Shell
License
MIT

Integrates with

Bundled in these plugins

Similar Skills

Semantically similar based on skill content — not just same category