mufi-email-manager
한국 주요 이메일 서비스(Gmail, 네이버, 다음, 카카오)를 통합 관리하는 IMAP/SMTP 기반 도구입니다.
주요 기능
- - 📬 다중 계정 통합: Gmail, 네이버, 다음, 카카오 메일 동시 관리
- 📊 스마트 요약: 읽지 않은 메일 자동 요약 및 분류
- 🔍 키워드 필터링: 중요 메일 자동 탐지 (업무, 결제, 보안 등)
- 🤖 자동 답장: 템플릿 기반 빠른 답장
- 📰 일일 다이제스트: 하루 메일 요약 리포트 생성
설정
환경 변수 설정
스킬 폴더에 .env 파일을 생성하거나 환경 변수로 설정:
CODEBLOCK0
한국 이메일 서버 정보
| 서비스 | IMAP 서버 | IMAP 포트 | SMTP 서버 | SMTP 포트 | 비고 |
|---|
| Gmail | imap.gmail.com | 993 | smtp.gmail.com | 587 | 2단계 인증 시 앱 비밀번호 필요 |
| 네이버 |
imap.naver.com | 993 | smtp.naver.com | 587 | IMAP/SMTP 설정 활성화 필요 |
| 다음 | imap.daum.net | 993 | smtp.daum.net | 465 | SSL 사용 |
| 카카오 | imap.kakao.com | 993 | smtp.kakao.com | 465 | SSL 사용 |
| 한메일 | imap.daum.net | 993 | smtp.daum.net | 465 | 다음과 동일 |
중요:
- - Gmail: 2단계 인증 사용 시 앱 비밀번호 필수
- 네이버: 메일 설정에서 IMAP/SMTP 사용 설정 필요
- 다음/카카오: SMTP 포트 465 (SSL 직접 연결)
명령어
1. 통합 메일 확인
모든 계정의 읽지 않은 메일 확인:
CODEBLOCK1
특정 계정만 확인:
CODEBLOCK2
2. 스마트 요약
읽지 않은 메일을 키워드 기반으로 분류하여 요약:
CODEBLOCK3
출력 예시:
CODEBLOCK4
3. 중요 메일 필터링
키워드로 중요 메일만 추출:
CODEBLOCK5
4. 자동 답장
템플릿 기반 빠른 답장:
CODEBLOCK6
기본 템플릿:
- -
thanks: 감사 인사 - INLINECODE2 : 확인 완료
- INLINECODE3 : 미팅 일정 조율
- INLINECODE4 : 부재중 자동 응답
5. 일일 다이제스트
하루 메일 요약 리포트 생성:
CODEBLOCK7
출력 형식:
- - 텍스트 리포트
- HTML 이메일로 전송 옵션
- JSON 형식 지원
6. 메일 발송
통합 발송 인터페이스:
CODEBLOCK8
7. 검색
모든 계정에서 통합 검색:
CODEBLOCK9
템플릿 커스터마이징
INLINECODE5 파일에서 답장 템플릿 수정 가능:
CODEBLOCK10
크론 작업 예시
매일 아침 9시 다이제스트 발송:
CODEBLOCK11
30분마다 중요 메일 체크:
CODEBLOCK12
설치
CODEBLOCK13
보안 주의사항
- -
.env 파일을 .gitignore에 추가 - Gmail은 앱 비밀번호 사용 권장
- 비밀번호를 코드에 하드코딩하지 말 것
- 중요 메일은 자동 삭제하지 않도록 주의
트러블슈팅
연결 실패:
인증 실패:
- - 이메일 주소와 비밀번호 재확인
- Gmail: 앱 비밀번호 사용 여부 확인
- 네이버: IMAP/SMTP 설정 활성화 여부 확인
TLS/SSL 에러:
- - 다음/카카오는 SMTP 포트 465 (SSL 직접 연결)
- Gmail/네이버는 SMTP 포트 587 (STARTTLS)
라이센스
MIT
mufi-email-manager
基于IMAP/SMTP的工具,用于统一管理韩国主要电子邮件服务(Gmail、Naver、Daum、Kakao)。
主要功能
- - 📬 多账户集成:同时管理Gmail、Naver、Daum、Kakao邮件
- 📊 智能摘要:自动摘要和分类未读邮件
- 🔍 关键词过滤:自动检测重要邮件(工作、付款、安全等)
- 🤖 自动回复:基于模板的快速回复
- 📰 每日摘要:生成每日邮件摘要报告
设置
环境变量设置
在技能文件夹中创建.env文件或设置为环境变量:
bash
默认账户(必填)
DEFAULT_ACCOUNT=gmail # 可选:gmail、naver、daum、kakao
Gmail账户
GMAIL_USER=your@gmail.com
GMAIL
PASS=yourapp_password
GMAIL
IMAPHOST=imap.gmail.com
GMAIL
IMAPPORT=993
GMAIL
SMTPHOST=smtp.gmail.com
GMAIL
SMTPPORT=587
Naver邮件
NAVER_USER=your@naver.com
NAVER
PASS=yourpassword
NAVER
IMAPHOST=imap.naver.com
NAVER
IMAPPORT=993
NAVER
SMTPHOST=smtp.naver.com
NAVER
SMTPPORT=587
Daum邮件
DAUM_USER=your@daum.net
DAUM
PASS=yourpassword
DAUM
IMAPHOST=imap.daum.net
DAUM
IMAPPORT=993
DAUM
SMTPHOST=smtp.daum.net
DAUM
SMTPPORT=465
Kakao邮件
KAKAO_USER=your@kakao.com
KAKAO
PASS=yourpassword
KAKAO
IMAPHOST=imap.kakao.com
KAKAO
IMAPPORT=993
KAKAO
SMTPHOST=smtp.kakao.com
KAKAO
SMTPPORT=465
过滤关键词(用逗号分隔)
IMPORTANT_KEYWORDS=付款,账单,缴纳,合同,批准,安全,密码,urgent,invoice
SPAM_KEYWORDS=广告,宣传,活动,优惠券,折扣
摘要设置
DIGEST_ENABLED=true
DIGEST_TIME=09:00
DIGEST_RECIPIENTS=your@gmail.com
韩国邮件服务器信息
| 服务 | IMAP服务器 | IMAP端口 | SMTP服务器 | SMTP端口 | 备注 |
|---|
| Gmail | imap.gmail.com | 993 | smtp.gmail.com | 587 | 两步验证时需要应用密码 |
| Naver |
imap.naver.com | 993 | smtp.naver.com | 587 | 需要启用IMAP/SMTP设置 |
| Daum | imap.daum.net | 993 | smtp.daum.net | 465 | 使用SSL |
| Kakao | imap.kakao.com | 993 | smtp.kakao.com | 465 | 使用SSL |
| Hanmail | imap.daum.net | 993 | smtp.daum.net | 465 | 与Daum相同 |
重要提示:
- - Gmail:使用两步验证时必须使用应用密码
- Naver:需要在邮件设置中启用IMAP/SMTP
- Daum/Kakao:SMTP端口465(SSL直接连接)
命令
1. 统一邮件查看
查看所有账户的未读邮件:
bash
node scripts/check-all.js [--limit 20]
仅查看特定账户:
bash
node scripts/check.js --account gmail [--limit 10]
node scripts/check.js --account naver [--limit 10]
2. 智能摘要
基于关键词对未读邮件进行分类和摘要:
bash
node scripts/summary.js [--account gmail] [--recent 24h]
输出示例:
📬 未读邮件摘要 (Gmail)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🔴 重要 (3封)
- [付款] 信用卡批准通知 (新韩卡)
- [安全] 新设备登录尝试 (Google)
- [工作] 项目截止通知 (组长)
🟡 普通 (12封)
- 每周通讯 (Tech News)
- 配送完成通知 (Coupang)
...
🔵 值得阅读 (5封)
- 朋友邀请 (Facebook)
...
3. 重要邮件过滤
通过关键词提取重要邮件:
bash
node scripts/filter.js --keywords 付款,账单,批准 [--account all] [--recent 7d]
4. 自动回复
基于模板的快速回复:
bash
模板列表
node scripts/reply.js --list
使用模板
node scripts/reply.js --uid 12345 --template thanks --account gmail
自定义回复
node scripts/reply.js --uid 12345 --body 谢谢。 --account gmail
默认模板:
- - thanks:感谢问候
- confirm:确认完成
- meeting:会议日程协调
- ooo:不在办公室自动回复
5. 每日摘要
生成每日邮件摘要报告:
bash
node scripts/digest.js [--date 2026-02-16] [--accounts gmail,naver]
输出格式:
- - 文本报告
- 可选通过HTML邮件发送
- 支持JSON格式
6. 发送邮件
统一发送接口:
bash
node scripts/send.js \
--account gmail \
--to recipient@example.com \
--subject 您好 \
--body 这是邮件正文。 \
[--attach file.pdf]
7. 搜索
在所有账户中统一搜索:
bash
node scripts/search.js \
--query 项目 \
[--accounts gmail,naver] \
[--recent 30d] \
[--limit 50]
模板自定义
可在scripts/templates.json文件中修改回复模板:
json
{
thanks: {
subject: Re: {original_subject},
body: 您好,\n\n感谢您的邮件。\n确认后会回复您。\n\n谢谢。
},
confirm: {
subject: Re: {original_subject},
body: 已确认完成。\n如有其他问题,请随时联系。
}
}
Cron任务示例
每天早上9点发送摘要:
bash
0 9 * cd /path/to/mufi-email-manager && node scripts/digest.js --send
每30分钟检查重要邮件:
bash
/30 * cd /path/to/mufi-email-manager && node scripts/filter.js --keywords 紧急,urgent --notify
安装
bash
cd skills/mufi-email-manager
npm install
安全注意事项
- - 将.env文件添加到.gitignore
- 建议Gmail使用应用密码
- 不要将密码硬编码到代码中
- 注意不要自动删除重要邮件
故障排除
连接失败:
认证失败:
- - 重新确认邮箱地址和密码
- Gmail:检查是否使用应用密码
- Naver:检查是否已启用IMAP/SMTP设置
TLS/SSL错误:
- - Daum/Kakao:SMTP端口465(SSL直接连接)
- Gmail/Naver:SMTP端口587(STARTTLS)
许可证
MIT