# Corp Email Scraper Pro - 用户使用说明

## 1. 程序简介

## Google Maps Scraper 和 Corp Email Scraper 是两个独立的工具软件，可独立使用，可组合使用（推荐）

Corp Email Scraper Pro 是一款专业的企业邮箱爬取工具，支持从指定网站批量提取企业邮箱地址。 程序具备强大的邮箱解码能力和智能过滤功能。

### 主要功能

- 批量爬取目标网站的企业邮箱地址（目标网站上明码或隐藏的邮箱，不一定是企业负责人的邮箱。）
- 支持多种邮箱解码方式（HTML实体、URL编码、Base64等12种）
- 智能邮箱过滤（自动排除公共邮箱、临时邮箱）
- 支持断点续爬，不会重复爬取已访问的URL
- 灵活的搜索深度控制
- 多种导出格式 (CSV/JSONL/TXT)
- 开箱即用的现代化图形界面，支持亮色/暗色主题切换

### 系统要求

- Windows 10+ 操作系统
- 4GB+ RAM（内存）
- 100MB+ 可用硬盘空间
- 网络连接正常（一般情况下不需要 开启 VPN 科学上网，除非目标网站需要科学上网才能访问）。

## 2. 界面布局

### 界面组件说明

组件 | 说明
--- | ---
菜单栏 | 包含数据管理和许可证相关操作
主题切换 | 可切换亮色/暗色界面主题
批量输入 | 输入目标网站URL，支持多个URL（每行一个），可复制粘贴。
从文件导入 | 从文件（.txt文本格式文件）读取批量目标网站URL。
配置选项 | 默认已经设置好搜索参数（深度、线程数、超时时间等），用户无需设置。
控制按钮 | 开始搜索，停止搜索，清空日志，清空输入，清除已经选择文件，打开数据目录
进度条 | 显示当前搜索进度
日志区域 | 显示程序运行状态和日志信息

## 3. 快速开始

### 3.1 首次使用

1. 下载程序
   - `Corp_Email_Scraper_Pro_V1.6.8` 下载地址
   - https://software.anoralighting.com/software_zip/Corp_Email_Scraper_Pro_V1.6.8.zip，复制链接用浏览器打开即开始下载，或点击上面链接下载。
2. 启动程序
   - 双击 `Corp_Email_Scraper_Pro_V1.6.8.exe` 启动程序
   - 程序启动时会自动检测许可证状态
3. 试用期激活
   - 首次使用会自动激活 7 天免费试用
   - 试用期内可免费使用所有功能，无功能限制。
4. 开始第一次搜索
   1. 在URL输入框中输入目标网站域名，每行一个
   2. 例如：`https://www.example.com` 或 `example.com`
   3. 设置搜索参数（默认参数即可开始）
   4. 点击"开始搜索"
   5. 搜索过程中建议用户不要主动中断搜索（停止搜索），让程序自动完成搜索工作。

### 3.2 URL输入格式

支持以下输入格式：

    # 格式示例
    https://www.example.com
    http://example.com
    example.com
    www.example.com

    # 批量输入（每行一个）
    https://www.company1.com
    https://www.company2.com
    https://www.company3.com

注意事项：
- 每行一个URL
- 支持带协议(http/https)或不带协议的域名
- 程序会自动规范化URL为 https://domain.com 格式

## 4. 配置选项详解

### 4.1 基本配置（用户无需设置）

选项 | 说明 | 默认值
--- | --- | ---
爬取深度 | 从首页开始的最大页面深度 (1-10) | 3
最大结果 | 每个域名最多提取的邮箱数量 (10-5000) | 500
并行数 | 同时执行的爬取任务数 (1-20) | 5
超时时间 | 单个请求超时时间（秒）(10-120) | 30
重试次数 | 请求失败后重试次数 (0-5) | 2

### 4.2 爬取策略（用户无需设置）

策略 | 说明
--- | ---
深度优先 | 优先深入爬取当前页面的链接（适合结构较深的网站）
广度优先 | 优先爬取当前页面同级的链接（适合扁平化结构网站）

### 4.3 邮箱解码选项

程序支持12种邮箱解码方式，默认全部开启：

- HTML实体解码（如 &#64; → @）
- URL编码解码（如 %40 → @）
- Unicode转义解码（如 \u0040 → @）
- Base64解码
- CSS内容提取
- CSS反转修复
- 零宽字符清理
- 分隔符形式解码（如 [at] → @）
- 反向域名修复
- JS十六进制解码
- 字符串替换

### 4.4 过滤设置

选项 | 说明 | 默认状态
--- | --- | ---
过滤公共邮箱 | 自动排除 vip.163.com、zoho.com、Yahoo 等公共邮箱服务（可编辑文件排除或保留） | 开启
过滤临时邮箱 | 自动排除临时邮箱服务（如 yopmail.com，10minutemail.com） | 开启
过滤系统账号 | 自动排除 admin、noreply 等系统账号 | 开启
过滤特定扩展名 | 不爬取图片、文档等非HTML文件 | 开启
过滤管理后台路径 | 不爬取 /admin、/login 等路径 | 开启

### 4.5 配置建议

场景 | 推荐配置
--- | ---
快速测试 | 爬取深度=1, 最大结果=50, 并行数=2
常规爬取 | 爬取深度=3, 最大结果=500, 并行数=5
大规模爬取 | 爬取深度=5, 最大结果=2000, 并行数=10
高质量数据 | 开启所有过滤选项

## 5. 许可证管理

### 5.1 菜单说明

在菜单栏点击"许可证"可看到以下选项：

菜单项 | 说明
--- | ---
许可证状态 | 查看当前许可证信息
许可证激活 | 输入激活码激活许可证
许可证迁移 | 将许可证转移到新电脑
解除许可证 | 解除当前设备的许可证绑定

### 5.2 查看许可证状态

1. 点击菜单：许可证 → 许可证状态
2. 可查看：
   - 机器码（16位，用于激活）
   - 许可证状态（未激活/试用期/正式版/VIP永久版）
   - 许可证类型
   - 过期时间
   - 剩余天数

### 5.3 激活许可证

1. 点击菜单：许可证 → 许可证激活
2. 输入您的激活码
3. 点击"激活"按钮
4. 激活成功后会显示提示信息

许可证类型说明：

类型 | 说明
--- | ---
试用版 | 免费试用 7 天，无功能限制
正式版 | 按天授权，首次 30 天起售，后续可按天续费

获取激活码请联系：阿诺拉【Anora】 - 微信: 180 2416 9261

### 5.4 许可证迁移

当需要更换电脑时：

1. 在旧电脑上：许可证 → 许可证迁移
2. 获取当前机器码
3. 在新电脑上使用相同的激活码进行激活
4. 如需协助，请联系客服

### 5.5 解除许可证

在以下情况需要解除许可证：

- 输入新激活码前
- 许可证转移前
- 设备报废后

## 6. 数据导出

### 6.1 导出格式

程序支持以下导出格式：

- CSV - 逗号分隔值，可用 Excel 打开
- JSONL - JSON Lines 格式，每行一个JSON对象
- TXT - 纯文本格式，每行一个邮箱

### 6.2 导出位置

数据默认导出到 `data` 目录：

    项目目录/
    └── data/
        └── emails_all_20260115_103015.jsonl
        └── emails_all_20260115_103015.csv
        └── exports/
            └── (手动导出的文件)

### 6.3 数据字段

导出的关键数据有以下字段：

字段 | 说明
--- | ---
email | 邮箱地址
url | 发现邮箱的页面URL
crawled_at | 爬取时间
domain | 域名
page_title | 页面标题
source_type | 来源类型（正则匹配/mailto链接）

### 6.4 打开数据目录

点击"打开数据目录"按钮可直接打开 data 文件夹

### 6.5 统计报告

搜索完成后，程序会自动生成统计报告：

- 总邮箱记录数
- 唯一邮箱地址数
- 唯一域名数
- 邮箱数量最多的域名（前10个）
- 按来源类型统计
- 最近提取的邮箱（前20个）

## 7. 常见问题

### 7.1 启动问题

Q: 程序无法启动？

解决方案：
1. 确认系统版本为 Windows 10 或更高
2. 确认有足够的内存和硬盘空间

Q: 提示"许可证验证失败"？

解决方案：
1. 点击"许可证"菜单
2. 选择"许可证激活"
3. 输入有效的激活码

### 7.2 搜索问题

Q: 搜索没有结果？

可能原因：
1. 网络连接问题 → 检查网络
2. 目标网站无法访问 → 尝试用浏览器打开

Q: 结果数量少于预期？

优化建议：
1. 检查是否被过滤选项拦截

Q: 提示"SSL证书错误"？

解决方案：
1. 确保系统时间正确
2. 尝试更新操作系统
3. 检查目标网站的SSL证书是否有效

### 7.3 导出问题

Q: 导出文件为空？

解决方案：
1. 确认搜索成功完成
2. 检查日志区域是否有错误信息
3. 确认 data 目录有写入权限

Q: Excel 打开乱码？

解决方案：
1. 在 Excel 中通过"数据 → 自文本，分隔符号，逗号（只选择），常规 "

### 7.4 过滤问题

Q: 某些邮箱被误过滤？

解决方案：
1. 检查 filter_files 目录下的过滤配置文件
2. 可手动编辑 ignore_email_domains.txt 添加或移除域名
3. 可手动编辑 ignore_email_prefix.txt 添加或移除前缀

### 7.5 其他问题

Q: 如何联系我们？

微信：180 2416 9261
联系人：阿诺拉 (Anora)

Q: 程序闪退？

解决方案：
1. 更新程序到最新版本
2. 清理缓存文件后重试
3. 检查系统日志获取详细错误信息

## 附录

### A. 快捷操作

按钮 | 功能
--- | ---
开始搜索 | 启动爬取任务
停止搜索 | 立即停止正在运行的爬取
清空日志 | 清空日志显示区域
清空输入 | 清空URL输入内容
打开数据目录 | 打开 data 文件夹

### B. 数据管理菜单

菜单项 | 功能
--- | ---
搜索状态 | 查看当前爬取进度和状态
重置状态 | 清空所有爬取状态（可重新爬取）
显示统计报告 | 显示最近爬取的统计信息
导出数据 | 手动导出数据（支持CSV/JSONL/TXT）
退出程序 | 关闭程序

### C. 日志查看

日志区域显示程序运行信息：

- INFO - 正常操作信息
- DEBUG - 调试信息，非错误
- WARNING - 警告信息
- ERROR - 错误信息

### D. 过滤配置文件说明

filter_files 目录包含以下配置文件：

文件 | 用途
--- | ---
ignore_path.txt | 忽略的URL路径（如 /admin, /api）
priority_paths.txt | 优先爬取的路径（如 /contact, /about）
ignore_email_domains.txt | 忽略的邮箱域名
ignore_email_prefix.txt | 忽略的邮箱前缀
ignore_extensions.txt | 忽略的文件扩展名