email-finder

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

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.

采用混合方式查找与域名关联的电子邮件地址：优先使用免费方法（网页抓取、模式推测、WHOIS查询），当有可用密钥时再使用API（Hunter.io、Apollo.io等）。

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

扫描域名以查找关联的邮箱地址
查找企业的联系邮箱
替代Email Hunter功能
查找域名对应的邮箱命名模式
验证电子邮件地址
用发现的邮箱地址丰富联系人数据

Project Context Discovery

项目上下文探查

Before finding emails:

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

在查找邮箱之前：

检查是否已有邮箱发现工具
查看可用的API密钥（Hunter.io、Apollo.io）
检查合规性/隐私要求
查找项目专属的
```
[project]-email-finder
```
Skill

Methodology

方法流程

Free Methods (Primary)

免费方法（优先）

Web Scraping - Scan
```
/contact
```
,
```
/about
```
,
```
/team
```
pages for emails
WHOIS Lookup - Query domain registration data

Pattern Guessing - Generate patterns from names found on site:

```
firstname.lastname@domain.com
```
```
firstnamelastname@domain.com
```
```
firstname@domain.com
```
```
f.lastname@domain.com
```

网页抓取 - 扫描
```
/contact
```
、
```
/about
```
、
```
/team
```
页面以查找邮箱
WHOIS查询 - 查询域名注册数据

模式推测 - 根据网站上找到的姓名生成邮箱模式：

```
firstname.lastname@domain.com
```
```
firstnamelastname@domain.com
```
```
firstname@domain.com
```
```
f.lastname@domain.com
```

API Methods (If Keys Available)

API方法（当有可用密钥时）

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

API	环境变量	用途
Hunter.io	`HUNTER_API_KEY`	域名搜索 + 验证
Apollo.io	`APOLLO_API_KEY`	联系人发现
Snov.io	`SNOV_CLIENT_ID/SECRET`	邮箱查找
Clearbit	`CLEARBIT_API_KEY`	企业信息丰富

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;
}

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

速率限制：请求之间添加延迟（建议1秒）
尊重robots.txt：抓取前先检查
去重：标准化邮箱地址（转为小写、去除首尾空格）
验证：使用MX记录检查或API验证
过滤：移除noreply@、donotreply@这类地址

Legal & Ethical

法律与伦理

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

遵守GDPR/CCPA法规
尊重服务条款
执行退订请求
不要向发现的邮箱发送垃圾邮件

Integration

集成

Works well with:

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

For complete implementation code, API examples, verification patterns, and rate limiting utilities, see:

references/full-guide.md

与以下工具兼容良好：

```
leads-researcher
```
- 研究企业后发现联系邮箱
```
copywriter
```
- 使用找到的邮箱进行推广活动

完整的实现代码、API示例、验证模式和速率限制工具，请查看：

references/full-guide.md