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, Codex, GitHub Copilot, Cursor, Gemini CLI, OpenCode, Goose, Hermes, Jesse, Windsurf, Zed
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
```bash
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
```bash
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
```bash
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
```bash
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
```bash
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
```bash
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

```bash
# 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