sales-minelead

What this skill does

# Minelead Platform Help

Help the user with Minelead platform questions — from Company Email Search and Email Finder through Lead Generation, Email Verification, Disposable Email Detection, Email Campaigns, Leads/CRM, Bulk Operations, and Integrations. Minelead is a London-based B2B email finder, verifier, and lead generation platform with 500M+ emails and 100M+ business profiles, offering a REST API and browser extensions for in-workflow lookup.

## Step 1 — Gather context


If `references/learnings.md` exists, read it first for accumulated knowledge.

Ask the user:

1. **What area of Minelead do you need help with?**
   - A) Company Email Search — find all email addresses associated with a domain (500M+ emails indexed)
   - B) Email Finder — find a professional email address from first name + last name + domain
   - C) Lead Finder / Tags — discover companies and leads from keywords and locations
   - D) Email Verifier — validate email deliverability with quality scoring (25-100%)
   - E) Disposable Email Detector — identify temporary/throwaway email addresses (score 0-5)
   - F) Email Campaigns — send campaigns via connected Gmail accounts with round-robin multi-account support
   - G) Leads/CRM — save, organize, export lead collections, import CSV
   - H) Bulk Operations — batch email search or verification via CSV upload
   - I) Browser Extensions — Chrome and Firefox for in-browser email lookup
   - J) Integrations — HubSpot, Zoho CRM, Google Sheets, Zapier
   - K) API — REST API setup, endpoints, authentication
   - L) Account / Billing — plans, pricing, credits
   - M) Something else — describe it

2. **What's your role?**
   - A) Sales / SDR / BDR
   - B) RevOps / Sales ops
   - C) Developer / engineer
   - D) Growth / marketing
   - E) Recruiter / talent acquisition
   - F) Other

3. **What are you trying to accomplish?** (describe your specific goal or question)

**If the user's request already provides most of this context, skip directly to the relevant step.** Lead with your best-effort answer using reasonable assumptions (stated explicitly), then ask only the most critical 1-2 clarifying questions at the end — don't gate your response behind gathering complete context.

Note: If the user needs a specialized skill, route them there with a brief explanation of why that skill is a better fit.

## Step 2 — Route or answer directly

If the request maps to a specialized skill, route:
- Cross-platform enrichment strategy / multi-tool enrichment -> `/sales-enrich`
- Email deliverability / verification strategy (not Minelead-specific) -> `/sales-deliverability`
- Prospect list building strategy -> `/sales-prospect-list`
- Outbound sequence / cadence strategy -> `/sales-cadence`
- Connecting Minelead to other tools via middleware -> `/sales-integration`
- Hunter.io-specific questions -> `/sales-hunter`
- Tomba-specific questions -> `/sales-tomba`
- Prospeo-specific questions -> `/sales-prospeo`
- Enrich.so-specific questions -> `/sales-enrichso`

Otherwise, answer directly from platform knowledge using the reference below.

## Step 3 — Minelead platform reference

**Read `references/platform-guide.md`** for detailed module documentation, pricing, integrations, and data model.

*You no longer need the platform guide details — focus on the user's specific situation.*

## Step 4 — Actionable guidance

Based on the user's specific question:

1. **Finding all emails at a target company domain**:
   1. Call `GET /v1/search?domain=example.com&key=<your-key>` to retrieve all known email addresses at the domain
   2. Minelead searches its index of 500M+ emails and returns matching addresses — webmail domains are excluded by default
   3. For each returned email, run verification with `GET /v1/validate?email=<email>&key=<your-key>` to get a quality score (25-100%)
   4. Filter results: keep emails with quality scores above 70% for outreach, flag catch-all domains for extra caution
   5. Save verified leads to a collection via `POST /v1/leads` for organization and future export
   6. For multiple domains, use Bulk Operations to process a CSV of domains in one batch
   7. Export your verified lead collection to HubSpot, Zoho CRM, or Google Sheets via integrations

2. **Finding a specific person's email**:
   1. Use the Email Finder: `GET /v1/find?first_name=Jane&last_name=Doe&domain=example.com&key=<your-key>`
   2. Minelead returns the most likely professional email address with confidence indicators
   3. Verify the found email immediately: `GET /v1/validate?email=<found-email>&key=<your-key>`
   4. Check the quality score — above 70% is safe for outreach, below 50% warrants caution
   5. If no result, try alternate domain spellings or the company's parent domain
   6. For batch lookups (e.g., a list of 50 decision-makers), prepare a CSV with first_name, last_name, domain columns and use Bulk Operations

3. **Building a prospect list from keywords and locations**:
   1. Use Lead Finder / Tags: `GET /v1/tags?keyword=saas+marketing&location=London&key=<your-key>`
   2. Minelead returns companies matching your keyword and geographic criteria
   3. For each discovered company, run Company Email Search to find contacts at the domain
   4. Verify discovered emails with the Email Verifier — filter out low-quality scores and disposable addresses
   5. Save qualified leads to a collection in Minelead's Leads/CRM
   6. Export the collection to your CRM or Google Sheets for outreach workflow
   7. Repeat with varied keywords to expand your TAM across different market segments

## Gotchas

> *Best-effort from research — review these, especially items about plan-gated features and integration gotchas that may be outdated.*

1. **API key is passed as a query parameter, not a header — do not put it in the Authorization header.** All Minelead API requests authenticate via `key=<your-api-key>` as a URL query parameter. This differs from platforms like Enrich.so or Hunter.io that use Bearer token headers. Be mindful that API keys in URLs can appear in server logs and browser history — use HTTPS and avoid sharing URLs that contain your key.

2. **Bulk operation batch limits vary by plan and can silently truncate your upload.** Free and Starter plans cap at 50 records per batch, Pro at 100, Business at 1,000. If you upload a CSV with more records than your plan allows, excess rows may be ignored without an explicit error. Check your plan's bulk limit before uploading and split large files into plan-appropriate batches. Enterprise is the only plan with unlimited bulk operations.

3. **Email quality scores (25-100%) are not binary — treat them as a confidence gradient, not a pass/fail.** A score of 70% does not mean the email has a 70% chance of being valid. Scores near 25% indicate high risk (likely invalid or catch-all), while 90%+ indicates strong confidence. Catch-all domains will often return moderate scores even for non-existent mailboxes — always flag catch-all results for manual review or extra validation steps.

4. **Disposable email scores (0-5) require a threshold decision — Minelead does not set a default cutoff.** A score of 0 means definitely not disposable, 5 means definitely disposable, but scores of 2-3 are ambiguous. You need to decide your own threshold based on your use case — form validation might reject anything above 2, while lead qualification might only reject 4-5. Test with known disposable providers to calibrate your threshold.

5. **Email Campaigns require connected Gmail accounts — there is no built-in SMTP or non-Gmail sending.** Campaign sending works exclusively through connected Gmail accounts via OAuth. If you need to send from non-Gmail addresses, you will need to use a separate email campaign tool. Round-robin distributes sends across connected accounts, which helps with deliverability but means you need multiple Gmail accounts for high-volume campaigns.

6. **HubSpot, Zoho CRM, and Google Sheets integrations may require a Pro plan or highe