# Email Finder

> Find and verify contact emails associated with a domain using free discovery methods first and APIs when keys are available. Triggers on domain email scans, contact discovery, email pattern finding, and email enrichment.

- **Type:** Skill
- **Install:** `agentstack add skill-genfeedai-skills-email-finder`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [genfeedai](https://agentstack.voostack.com/s/genfeedai)
- **Installs:** 0
- **Category:** [Communication](https://agentstack.voostack.com/c/communication)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [genfeedai](https://github.com/genfeedai)
- **Source:** https://github.com/genfeedai/skills/tree/master/bundles/all/skills/email-finder
- **Website:** https://skills.sh/genfeedai/skills

## Install

```sh
agentstack add skill-genfeedai-skills-email-finder
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Email Finder

## Overview

Discover email addresses associated with a domain using a hybrid approach: free methods first (web scraping, pattern guessing, WHOIS lookup), then APIs (Hunter.io, Apollo.io, etc.) when keys are available.

## When to Use

- Scan a domain to find associated emails
- Find contact emails for a company
- Replace email hunter functionality
- Find email patterns for a domain
- Verify email addresses
- Enrich contact data with discovered emails

## Project Context Discovery

Before finding emails:

1. Check for existing email discovery tools
2. Review available API keys (Hunter.io, Apollo.io)
3. Check compliance/privacy requirements
4. Look for project-specific `[project]-email-finder` skill

## Methodology

### Free Methods (Primary)

1. **Web Scraping** - Scan `/contact`, `/about`, `/team` pages for emails
2. **WHOIS Lookup** - Query domain registration data
3. **Pattern Guessing** - Generate patterns from names found on site:
   - `firstname.lastname@domain.com`
   - `firstnamelastname@domain.com`
   - `firstname@domain.com`
   - `f.lastname@domain.com`

### API Methods (If Keys Available)

| API | Env Variable | Purpose |
|-----|-------------|---------|
| Hunter.io | `HUNTER_API_KEY` | Domain search + verification |
| Apollo.io | `APOLLO_API_KEY` | Contact discovery |
| Snov.io | `SNOV_CLIENT_ID/SECRET` | Email finder |
| Clearbit | `CLEARBIT_API_KEY` | Company enrichment |

## Email Result Interface

```typescript
interface EmailResult {
  email: string;
  source: 'web-scraping' | 'whois' | 'pattern-guessing' | 'hunter' | 'apollo';
  confidence?: number;
  firstName?: string;
  lastName?: string;
  position?: string;
  verified?: boolean;
}
```

## Best Practices

- **Rate limiting**: Delay between requests (1s recommended)
- **Respect robots.txt**: Check before scraping
- **Deduplicate**: Normalize emails (lowercase, trim)
- **Verify**: Use MX record checks or API verification
- **Filter**: Remove noreply@, donotreply@ addresses

## Legal & Ethical

- Comply with GDPR/CCPA
- Respect terms of service
- Honor opt-out requests
- Don't spam discovered emails

## Integration

Works well with:

- `leads-researcher` - Discover contact emails after researching companies
- Genfeed copywriter - Use found emails for outreach campaigns

---

**For complete implementation code, API examples, verification patterns, and rate limiting utilities, see:** `references/full-guide.md`

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [genfeedai](https://github.com/genfeedai)
- **Source:** [genfeedai/skills](https://github.com/genfeedai/skills)
- **License:** MIT
- **Homepage:** https://skills.sh/genfeedai/skills

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-genfeedai-skills-email-finder
- Seller: https://agentstack.voostack.com/s/genfeedai
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.