Etsy Customer Notify Tool

一个用于自动化Etsy客户营销消息发送的Windows桌面工具。

功能特性

Git自动更新: 启动时自动检查并拉取最新版本
智能登录检查: 检测Etsy登录状态和API访问权限
双重触发模式: 支持对话触发和订单触发两种营销方式
用户标签过滤: 可选择排除特定标签的用户
消息去重: 避免向同一用户重复发送营销消息
批量限制: 支持每日和批次发送限制，避免被封号
Excel导出: 完整的发送记录导出和统计分析
人性化操作: 随机延迟和人工化操作，规避检测

系统要求

Windows 10/11
Python 3.7+
Chrome浏览器
稳定的网络连接

安装步骤

下载项目

git clone http://gitlab.zb100.com:10080/chaijin/EtsyCustomerNotify.git
cd EtsyCustomerNotify

运行安装脚本
```
install.bat
```
启动程序
```
run.bat
```

使用说明

初次设置

启动程序: 双击 run.bat 启动工具
检查登录: 点击"检查登录状态"确保Etsy账户已登录
配置消息: 添加至少5条不同风格的营销消息
选择标签: 刷新并选择要排除的用户标签

对话营销

设置日期范围
选择排除标签
点击"启动对话营销"
系统将自动遍历对话列表并发送营销消息

订单营销

设置日期范围
点击"启动订单营销"
系统将从订单列表向客户发起营销对话

重要功能

重置营销消息: 清空历史发送记录，重新开始营销
导出记录: 将发送记录导出为Excel文件进行分析
实时监控: 状态窗口显示实时处理进度和结果

安全限制

每日限制: 最多发送100条消息
批次限制: 每50条消息暂停5分钟
随机延迟: 每条消息间隔10-20秒
去重机制: 自动跳过已发送的用户/订单

注意事项

️ 重要提醒:

使用前确保Etsy账户已正常登录
营销消息需要至少5条且内容差异化
请遵守Etsy社区准则，避免发送垃圾信息
建议在低峰期使用以减少封号风险

故障排除

常见问题

Chrome启动失败
- 确保Chrome浏览器已正确安装
- 检查Chrome版本是否为最新
登录检查失败
- 手动登录Etsy网站
- 检查网络连接
元素查找失败
- Etsy页面结构可能已更新
- 需要更新元素选择器

日志文件

程序运行日志保存在 data/ 目录下：

etsy_notify.db: 发送记录数据库
config.json: 配置文件

技术架构

EtsyCustomerNotify/
├── main.py                 # 程序入口
├── src/
│   ├── core/              # 核心模块
│   │   ├── config.py      # 配置管理
│   │   ├── database.py    # 数据库操作
│   │   ├── git_updater.py # Git自动更新
│   │   └── excel_exporter.py # Excel导出
│   ├── gui/               # GUI界面
│   │   └── main_window.py # 主窗口
│   └── etsy/              # Etsy相关
│       ├── chrome_controller.py # Chrome控制
│       └── etsy_manager.py      # Etsy管理
├── requirements.txt       # 依赖列表
├── run.bat               # 启动脚本
└── install.bat           # 安装脚本

版本更新

程序启动时会自动检查Git仓库更新：

发现新版本时自动下载
自动安装新依赖
自动重启应用程序

快速开始: 运行 install.bat → run.bat → 点击"检查登录状态" → 添加营销消息 → 开始营销！