IMAP/SMTP Email Tool 是一款专为开发者设计的命令行邮件管理解决方案，支持通过 IMAP 协议接收邮件、通过 SMTP 协议发送邮件。该工具兼容主流邮箱服务商如 Gmail、Outlook、163.com、126.com 等，也适用于任何遵循标准 IMAP/SMTP 协议的服务器。用户可通过简单的配置文件或环境变量设置账户信息，无需复杂依赖即可快速集成到自动化流程中。其核心功能覆盖邮件检查、内容获取、附件下载、关键词搜索以及标记阅读状态等操作，特别适合需要批量处理邮件或对邮件系统进行二次开发的场景。 工具采用模块化脚本设计，分别提供 `imap.js` 和 `smtp.js` 两个独立模块，分别处理收信与发信任务。接收端支持按时间范围筛选新邮件、提取完整邮件内容、下载指定附件，并支持基于发件人、主题、日期等条件进行精准检索；发送端则支持纯文本与 HTML 格式邮件、多收件人（含 CC/BCC）、文件附件等功能。所有配置均通过 `.env` 文件或系统环境变量完成，确保敏感信息的安全隔离。特别针对 Gmail 和网易邮箱等常见平台提供了详细配置指引，例如 Gmail 必须使用应用专用密码而非原始账户密码，163.com 需启用授权码机制。 整体架构轻量高效，依赖少且易于部署，适合嵌入 CI/CD 流程、定时任务或自定义邮件处理脚本中。无论是用于监控企业邮箱的新消息提醒、自动归档重要邮件、还是构建内部通讯自动化系统，该工具都能以简洁的命令行接口满足灵活的需求。同时，项目强调安全性，建议将凭据存储在本地 `.env` 文件中并加入版本控制忽略列表，避免泄露风险。
核心功能特点
- 支持 IMAP 协议接收邮件，可检查新邮件、获取完整内容及附件下载
- 支持 SMTP 协议发送邮件，支持 HTML 格式、多收件人、CC/BCC 及文件附件
- 兼容 Gmail、Outlook、163.com、126.com 等主流邮箱服务，也适用于任意标准 IMAP/SMTP 服务器
- 提供灵活的搜索功能，可按发件人、主题、时间范围、是否已读等条件过滤邮件
- 支持标记邮件为已读或未读状态，便于邮件状态管理
- 命令行操作简洁直观，支持脚本化调用，易于集成到自动化工作流中
适用场景
该工具特别适合需要自动化处理邮件的开发者或运维人员。例如，在企业内部系统中，可以将其嵌入定时任务脚本，定期检查特定邮箱中的新邮件并触发后续动作，如自动回复确认、生成工单或通知相关人员。对于数据抓取类应用，可通过搜索功能定位包含关键信息的邮件，并自动提取正文或附件内容进行分析。此外，在持续集成（CI）环境中，可用于发送构建结果通知，或在部署失败时向团队发送告警邮件，提升 DevOps 流程的透明度与响应效率。 另一个典型应用场景是个人用户的邮件整理与归档需求。用户可通过脚本定期扫描“INBOX”中的未读邮件，根据预设规则自动分类或下载重要文档，从而减少手动操作的负担。对于使用多个邮箱账户的用户，该工具也能统一管理不同服务商的消息流，避免在不同客户端间频繁切换。结合 cron 或其他调度器，还能实现每日简报生成——汇总过去几小时内的关键邮件并按优先级排序输出。 在更复杂的业务逻辑中，该工具可作为中间件连接邮件系统与数据库、API 或其他服务。比如，当收到客户反馈邮件时，自动解析内容并写入工单系统；或者从供应商处接收订单邮件后，提取发票附件并上传至云存储，同时更新库存记录。由于其完全基于命令行运行，不依赖图形界面，因此非常适合在无头服务器（headless server）或容器化环境中部署，实现高度定制化的邮件驱动型自动化流程。