leadmagic-cli

name	leadmagic-cli
description	Use the LeadMagic CLI for enrichment automation — find emails, validate contacts, enrich CSVs in batch, find decision-makers by role, and push to outbound platforms (Smartlead, Instantly). Use when automating enrichment from the command line, batch-processing contacts, or integrating LeadMagic into scripts. Triggers on: "LeadMagic CLI", "lm find", "lm validate", "lm enrich", "LeadMagic command line", or any request about CLI-based enrichment.
license	MIT
compatibility	Claude Code, Jesse, Codex, Hermes, Windsurf, OpenCode, Gemini CLI, Copilot, Zed, VS Code, Goose
metadata	{"version":"1.1.0","author":"LeadMagic","category":"leadmagic","tags":["leadmagic","cli","automation","enrichment","batch-processing"],"frameworks":["CLI Design Patterns","Enrichment Workflow Automation","LeadMagic Public Documentation — B2B Data Enrichment"],"related_skills":["leadmagic-waterfall","leadmagic-integrations","api-enrichment"]}

LeadMagic CLI

Overview

The LeadMagic CLI provides terminal access to email finding, validation, company enrichment, and outbound platform integration. Use it to automate enrichment workflows, batch-process CSV files, and push verified contacts to sending platforms — all without leaving the terminal.

Authoritative Foundations

• CLI Design Patterns — Shapes deliverables for this skill — The LeadMagic CLI provides terminal access to email finding, validation, company enrichment, and outbound platform integ.
• Enrichment Workflow Automation — Shapes deliverables for this skill — The LeadMagic CLI provides terminal access to email finding, validation, company enrichment, and outbound platform integ.
• LeadMagic Public Documentation — B2B Data Enrichment — B2B Data Enrichment

When to Use

• "Use the LeadMagic CLI to find emails"
• "Validate a CSV of contacts from the command line"
• "Push enriched contacts to Smartlead via CLI"
• "Automate enrichment in a shell script"
• "Batch process contacts with LeadMagic"
• "Find specific roles at companies via CLI"

Key Commands

Email Finding

lm find email -f Jane -l Smith -d company.com

Returns a verified work email for the given name and domain. Pay-per-result pricing — only charged when a valid email is found.

Email Validation

lm validate -f contacts.csv -c email

Validates all emails in the specified CSV column. Returns valid/invalid/risky/ unknown status per email. Process 4 validations per credit.

Bulk CSV Enrichment

lm enrich -i contacts.csv --batch-size 25

Enriches a CSV with auto-detected columns. Processes in configurable batches for reliability. Adds columns for found emails, verification status, and enrichment metadata.

Role Finding

lm find role -c "Acme Corp" -t "VP Sales"

Finds people with specific titles at a company. Returns name, title, and verified email where available.

Company Enrichment

lm find profile-search -p linkedin.com/in/janesmith

Fetch full professional profiles from profile URLs. Includes work history, education, and skills data.

Outbound Platform Push

lm integrations smartlead connect
lm integrations smartlead campaigns
lm integrations smartlead push --campaign <id>

Connect to Smartlead, Instantly, or EmailBison. List campaigns, push enriched contacts, view stats. All from terminal.

Workflow Pattern

1. Find contacts: lm find role or lm find email for individual lookups
2. Bulk enrich: lm enrich -i input.csv for batch processing
3. Validate: lm validate -f enriched.csv -c email before sending
4. Push: lm integrations smartlead push to outbound platform

Always validate after finding. Never push unverified contacts to a sequencer.

Scripting Integration

# Shell script: enrich and push weekly
#!/bin/bash
lm enrich -i weekly_leads.csv --batch-size 25 -o enriched_$(date +%Y%m%d).csv
lm validate -f enriched_$(date +%Y%m%d).csv -c email
lm integrations smartlead push --campaign main_campaign

Output Format

Commands produce structured JSON or CSV output. All results include source attribution and confidence indicators. Pipe into other tools or import into spreadsheets.

Quality Check

Before delivering, verify:

• All required sections are complete
• Output matches the user's stated need
• Named frameworks are cited for key recommendations
• No vague claims — every recommendation has a specific action
• Deliverable is ready for operational use, not just conceptual

Common Pitfalls

1. Not validating after finding. Always run lm validate before pushing to a sequence. Found emails can be stale.

2. Batch size too large. Stick to 25-50 per batch for reliability. Larger batches risk timeouts.

3. Skipping the verification step. Enrichment finds emails. Validation confirms they are deliverable. Two separate steps for a reason.

4. Wrong CSV column mapping. Use --batch-size to control throughput. Check column auto-detection before running full batches.

Execution Artifacts

• references/framework-notes.md — CLI patterns, Pat validate-before-push, Eric scale ops
• templates/output-template.md — command sequence + verify gate deliverable
• scripts/check-output.py — local checklist validator for required sections This skill includes lightweight artifacts the agent can load on demand:
• references/cli-workflow-patterns.md — find → validate → push pipelines (Patterns A–E)
• ../leadmagic-waterfall/references/waterfall-column-spec.md — Clay alternative for recurring
• ../../tools/smartlead-workflows/references/clay-enrollment-handoff.md — post-CLI sequencer handoff
• ../../outbound/cold-email-copywriting/references/pat-spielmann-outbound-copy.md — verify-before-send (Pat Spielmann)
• ../../../../references/gtm-experts-outbound-index.md — expert router Use the artifacts when the user asks for an implementation-ready deliverable, a repeatable workflow, or a quality check rather than generic advice.

Related Skills

• leadmagic-waterfall: Clay waterfall with LeadMagic primary
• leadmagic-integrations: Platform-specific integration guides
• leadmagic-bulk-enrichment: API-based bulk processing
• leadmagic-job-change: Job change monitoring via CLI