Skip to content

Repository files navigation

📧 AutoMailer

Scale your creator outreach with ease.

一个完全本地运行的邮件自动化工具,用于批量发送邮件、达人建联、出海获客等场景。 A fully local email automation tool for bulk email sending, creator outreach, and lead generation.


✨ Features | 功能特点

  • 📩 Bulk email sending (Excel-based) 批量发送邮件(基于 Excel)

  • 🧩 Custom HTML email template 自定义 HTML 邮件内容(完全自由排版)

  • 🖼️ Embedded images (not attachments) 图片内嵌在邮件正文(非附件)

  • 🔁 Resume after interruption 支持断点续发(防崩溃)

  • ⏱️ Adjustable sending interval 自定义发送频率(降低封禁风险)

  • 🔒 100% local execution 完全本地运行,不上传任何数据


📂 Project Structure | 项目结构

AutoMailer/
├── AutoMailer.py
├── email_template.html
├── maillist.xlsx
├── collaboration_brief_sample.jpg
├── send_results/
├── README.md
├── requirements.txt

⚙️ Setup | 使用步骤

1️⃣ Install Python

安装 Python(推荐 3.9+)


2️⃣ Install dependencies

安装依赖

pip install pandas openpyxl

3️⃣ Configure email settings

配置邮箱信息

打开 AutoMailer.py,修改:

SENDER_EMAIL = "your_email@gmail.com"
SENDER_PASSWORD = "your_app_password"
EMAIL_SUBJECT = "Your Email Subject"

⚠️ Use App Password, NOT your login password ⚠️ 请使用“应用专用密码”,不要使用邮箱登录密码


4️⃣ Prepare Excel file

准备邮件名单

Excel 必须包含两列:

ID | Email

示例:

John | john@email.com
Anna | anna@email.com

5️⃣ Edit email template

编辑邮件内容

打开:

email_template.html

可以自由修改内容,但必须保留:

{{name}}
<img src="cid:brief_image">

说明:

  • {{name}} → 自动替换为 Excel 中的 ID
  • cid:brief_image → 用于插入图片

6️⃣ Run script

运行程序

python AutoMailer.py

📊 Output | 输出结果

结果会保存在:

send_results/

文件示例:

send_result_20260426_153012.xlsx

内容格式:

ID | Email | Status

说明:

  • 1 = 发送成功
  • 0 = 发送失败 / 未发送

🔁 Resume Mechanism | 断点续发

程序会自动:

  • 读取 send_results 中最新结果文件
  • 跳过 Status = 1 的邮件
  • 继续发送未完成部分

⚠️ Important Notes | 注意事项

  • ❌ Do NOT upload real email lists to GitHub 不要上传真实邮箱数据

  • ❌ Do NOT expose your email password 不要泄露邮箱密码

  • ⚠️ Use responsibly (avoid spam behavior) 请合理使用,避免滥发邮件


📌 License

MIT License


👤 Author

Ethan(iny720)

About

A local email automation tool for scalable outreach with customizable HTML templates, embedded images, and resumable sending. 一个完全本地运行的邮件自动化工具,支持自定义HTML模板、内嵌图片、可控发送频率及断点续发,适用于邮件批量外联场景。

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages