skills/sales-minelead/SKILL.md
Minelead platform help — B2B email finder, verifier, and lead generation with 500M+ emails and 100M+ business profiles. Use when you can't find email addresses for a company, need to verify if emails are valid before sending, leads from keyword searches aren't relevant, Gmail campaigns in Minelead aren't delivering, disposable emails are polluting your list, or the Minelead API isn't returning results. Do NOT use for cross-platform enrichment strategy (use /sales-enrich), email deliverability/verification strategy (use /sales-deliverability), prospect list building strategy (use /sales-prospect-list), or outbound sequence/cadence strategy (use /sales-cadence).
npx skillsauth add sales-skills/sales sales-mineleadInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
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.
If references/learnings.md exists, read it first for accumulated knowledge.
Ask the user:
What area of Minelead do you need help with?
What's your role?
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.
If the request maps to a specialized skill, route:
/sales-enrich/sales-deliverability/sales-prospect-list/sales-cadence/sales-integration/sales-hunter/sales-tomba/sales-prospeo/sales-enrichsoOtherwise, answer directly from platform knowledge using the reference below.
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.
Based on the user's specific question:
Finding all emails at a target company domain:
GET /v1/search?domain=example.com&key=<your-key> to retrieve all known email addresses at the domainGET /v1/validate?email=<email>&key=<your-key> to get a quality score (25-100%)POST /v1/leads for organization and future exportFinding a specific person's email:
GET /v1/find?first_name=Jane&last_name=Doe&domain=example.com&key=<your-key>GET /v1/validate?email=<found-email>&key=<your-key>Building a prospect list from keywords and locations:
GET /v1/tags?keyword=saas+marketing&location=London&key=<your-key>Best-effort from research — review these, especially items about plan-gated features and integration gotchas that may be outdated.
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.
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.
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.
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.
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.
HubSpot, Zoho CRM, and Google Sheets integrations may require a Pro plan or higher — Free and Starter plans have limited integration access. Verify your plan includes the integrations you need before building workflows that depend on them. Zapier connectivity may also require a paid Minelead plan for certain triggers/actions.
The Free plan is throttled and limited to 25 credits/month — expect slower response times and rate limiting. The Free tier is suitable for evaluation only. API calls may be rate-limited more aggressively than paid plans. If you are building an integration, test on a paid plan to get realistic performance characteristics.
references/learnings.md with today's date./sales-enrich — Cross-platform datan enrichment strategy (multi-tool enrichment workflows, waterfall enrichment)/sales-deliverability — Email deliverability and verification strategy (SPF/DKIM/DMARC, warmup, inbox placement)/sales-prospect-list — Prospect list building strategy and best practices/sales-cadence — Outbound sequence and cadence strategy (multi-channel, timing, follow-up)/sales-integration — Connect Minelead to CRM, automation tools, or other platforms/sales-hunter — Hunter.io platform help (similar domain email search and verification)/sales-tomba — Tomba platform help (similar email finder and verifier)/sales-prospeo — Prospeo platform help (similar email finder with LinkedIn focus)/sales-enrichso — Enrich.so platform help (B2B datan enrichment API with LinkedIn and company data)/sales-do — Not sure which skill to use? The router matches any sales objective to the right skill. Install: npx skills add sales-skills/sales --skill sales-doUser says: "I want to find all email addresses at acmecorp.com and push the verified ones to HubSpot." Skill does:
GET /v1/search?domain=acmecorp.com&key=<key> to retrieve all known emails at the domainGET /v1/validate?email=<email>&key=<key> — checks deliverability and returns quality scores (25-100%)POST /v1/leadsUser says: "I have a CSV of 500 email addresses I collected from events. I need to clean the list before launching a cold email campaign." Skill does:
User says: "We're expanding into the fintech space in Berlin. How do I find companies and their contact emails using Minelead?" Skill does:
GET /v1/tags?keyword=fintech&location=Berlin&key=<key> to discover fintech companies in BerlinGET /v1/find?first_name=&last_name=&domain=<target-domain>&key=<key> when the user has named contacts in mindSymptom: Calling GET /v1/search?domain=example.com&key=<key> returns an empty result set even though the company is well-known and has many employees.
Cause: The domain may not be indexed in Minelead's database yet, the company may use a different primary domain than expected (e.g., a parent company domain or country-specific domain), or the domain may be classified as a webmail provider and excluded from results.
Solution: Verify the domain is the company's primary business domain — check their website and LinkedIn page. Try alternate domains (e.g., company.co.uk vs company.com, or a parent company domain). If the company is small or new, it may not yet be indexed — try the Email Finder endpoint with specific names instead, as it uses a different lookup mechanism. If you consistently get no results for domains you expect to have coverage, contact Minelead support to check index status.
Symptom: The same email address returns different quality scores on repeated verification calls, or emails you know are valid receive low scores.
Cause: Quality scores depend on real-time checks (MX records, SMTP responses) that can vary based on the recipient mail server's behavior at the time of the check. Catch-all domains are a common source of inconsistency — the server accepts all addresses, making it impossible to confirm whether a specific mailbox exists. Temporary server issues or greylisting can also cause fluctuating scores.
Solution: For catch-all domains, treat all emails as "unverifiable" rather than relying on the quality score — these domains accept everything, so even non-existent addresses may score moderately. If scores fluctuate for non-catch-all domains, re-verify after 24 hours to account for temporary server issues. For critical outreach, use a multi-tool verification approach — cross-check with a second verification service (see /sales-deliverability for strategy). Quality scores are probabilistic, not deterministic — use them as one input into your send/no-send decision, not the sole factor.
Symptom: Email campaigns sent through Minelead's campaign module are landing in recipients' spam folders even though the email addresses were verified with high quality scores.
Cause: Email verification confirms deliverability (the address exists and accepts mail) but does not guarantee inbox placement. Spam filtering depends on sender reputation, email content, authentication (SPF/DKIM/DMARC), sending volume, and recipient engagement. Common causes: new Gmail accounts with no sending history, high-volume sending from a single account, spammy content or subject lines, missing email authentication records.
Solution: Warm up connected Gmail accounts gradually — start with 10-20 sends per day and increase over 2-4 weeks. Use round-robin across multiple Gmail accounts to distribute volume and protect individual account reputation. Review email content for spam trigger words, excessive links, or image-heavy layouts. Ensure your sending domain has SPF, DKIM, and DMARC records configured. Monitor open and reply rates — low engagement signals to Gmail that your emails are unwanted. For comprehensive deliverability strategy beyond Minelead-specific settings, use /sales-deliverability.
tools
UpViral platform help — viral referral marketing and list-building platform (by Emarky) for viral sweepstakes, giveaway/reward campaigns, pre-launch waiting lists, and milestone referral programs, with REST API (app.upviral.com/api/v1/), callback-URL webhooks, PHP SDK, fraud detection (IP-based suspicious-referral flagging), A/B testing, smart leaderboards, unlockable incentives, and 30+ native ESP/CRM integrations (Mailchimp, ActiveCampaign, ConvertKit, AWeber, HubSpot, Klaviyo, Intercom) plus Zapier/Make/Pipedream/Integrately/Pabbly. Use when UpViral campaigns aren't tracking referral points correctly, deciding between Starter $79/mo annual (10K leads, 1 brand, NO API) vs Business $119/mo (25K, 2 brands, API + webhooks unlocked) vs Premium $319/mo (100K, 5 brands, dedicated account manager), the API returns errors because you're on the Starter tier where API/webhooks are gated, building an UpViral→CRM or UpViral→data-warehouse pipeline with add_contact / get_leads / get_leads_points / add_points / get_custom_fields / lists methods (uvapikey + uvmethod form-encoded POST), interpreting fraud flags where same-IP referrals get marked suspicious and you must manually activate/delete/blacklist, setting up the Callback URL (webhook) to fire on reward-unlock events, Zapier New Lead / New Reward Unlocked triggers not firing, ClickFunnels/Shopify/funnel-builder integration breaking, the drag-and-drop page builder showing broken widgets or limited customization, the setup feeling long and complicated for your first campaign, or picking UpViral over Viral Loops / KickoffLabs / Vyper / Prefinery / Gleam / KingSumo / ShortStack for a viral campaign. Do NOT use for general newsletter audience growth strategy across all platforms (use /sales-audience-growth), newsletter monetization (use /sales-newsletter), KickoffLabs-specific help (use /sales-kickofflabs), no-code merge-tag newsletter referrals (use /sales-referralkit), SparkLoop paid recommendations (use /sales-sparkloop), or full-stack multi-level Level-1/2/3 referral/affiliate tracking (use /sales-referralhero).
development
ReferralHero platform help — full-stack referral, affiliate, waitlist, contest, and NPS platform with subscriber API, webhooks, Zapier, Mailchimp/Kit/AWeber/Klaviyo/ActiveCampaign/SendLane connectors, coupon codes, multi-level referral tracking (Level 1/2/3), anti-fraud, and 5,000 calls/hour rate limit. Use when ReferralHero campaigns aren't tracking referrals correctly, deciding between PRO $199/mo (10K members, includes API + webhooks) and PREMIUM $399/mo (50K members, adds ReCaptcha + SMS verification), authentication is failing with no_token or X-API-Key header is being ignored, multi-level referral counts (Level 2/3) aren't appearing for downline subscribers, coupon group endpoints return 404 or coupon arrays max out, hitting the 5,000 calls/hour soft limit and getting too_many_calls 429s, the Mailchimp/Kit native integration is double-adding subscribers, webhook payloads aren't firing on confirmation events, importing Stripe customer IDs through transaction tracking, generating reward fulfillment when subscribers cross milestone thresholds (promote/unlock_promoted_reward), comparing ReferralHero against SparkLoop/ReferralKit/Viral Loops/GrowSurf/KickoffLabs for referral marketing, or routing referral data via add_bulk_transactions (500-transaction batch limit). Do NOT use for general newsletter audience growth strategy (use /sales-audience-growth), general newsletter monetization (use /sales-newsletter), no-code newsletter-only referral with merge-tag insertion (use /sales-referralkit), SparkLoop's paid recommendations or partner network (use /sales-sparkloop), or affiliate program strategy across many platforms (use /sales-affiliate-program).
tools
KickoffLabs platform help — viral marketing platform for pre-launch waitlists, bonus-entry giveaways, milestone-reward referral programs, leaderboard giveaways, and email opt-in bribes with REST API v1 + v2, server-side webhooks (in/out), KOL.js JavaScript library, AnyForm script for custom pages, fraud detection (duplicate_ip / bounced / duplidate_email flags), SMS verification add-on, native ESP integrations (Klaviyo, Mailchimp, ActiveCampaign, Brevo), website builders (Webflow, Wix, Squarespace, Weebly), Shopify, Facebook Audiences, Slack, Zapier. Use when KickoffLabs viral campaigns aren't tracking referrals correctly, deciding between Hobby $13/mo annual (500 leads/mo no A/B no reward emails) vs Premium $48/mo (2.5K + A/B + reward emails + tracking pixels) vs Business $99/mo (10K + custom email templates + custom domains + advanced reporting + 3 team) vs Enterprise $202/mo (25K + 5 team + SMS included), API key getting rejected because you embedded it in client-side JavaScript instead of server-side, can't decide whether to use v1 /subscribe vs v2 /tags/:TAG_ID/lead for lead creation, webhook payloads firing with `__fraudulent` flag and you need to interpret the duplicate_ip/bounced/duplidate_email reason codes (yes, duplidate is spelled that way in their docs), AnyForm script not posting to KickoffLabs vs native API endpoint, leaderboard endpoint returning more than 50 leads is not allowed, social_id (kid in share URLs) attribution chain breaking between v1 and v2, contest score vs lead count metrics in the webhook payload are confusing, SMS Verification only available on Premium+ as $50/mo add-on (Enterprise includes), per-month lead cap auto-upgrades at $8 per 1000 overage leads, picking between KickoffLabs and Viral Loops / UpViral / Prefinery / ReferralCandy / Voucherify for viral campaign type fit, or rate limit per tier (10-100 calls/minute) is hitting on bulk imports. Do NOT use for general newsletter audience growth strategy (use /sales-audience-growth), general newsletter monetization (use /sales-newsletter), no-code merge-tag-only newsletter referrals (use /sales-referralkit), SparkLoop paid recommendations + partner network (use /sales-sparkloop), or full-stack referral/affiliate with multi-level Level-1/2/3 tracking (use /sales-referralhero).
development
Routes any sales, marketing, ad, or GTM objective to the right specialized skill and outputs the install command for that skill plus a ready-to-paste prompt packed with the user's context. Asks clarifying questions when the objective is ambiguous, then hands back a copy-paste-runnable next step. Covers prospecting, outbound cadences, deals, proposals, forecasting, deliverability, enrichment, intent, content, coaching, CRO, SEO, launch directories, newsletters, email/SMS/push marketing, chatbots, influencer marketing, social media, employee advocacy, media relations, reviews, data hygiene, B2B advertising, retargeting, affiliate, loyalty, digital products, memberships, webinars, checkout, and platform-specific help. Use when the user has a sales or marketing question and isn't sure which skill to use, or wants a multi-skill sequence with a batch install command. Do NOT use to solve problems directly — this skill only routes.