mufi-email-manager
# mufi-email-manager
한국 주요 이메일 서비스(Gmail, 네이버, 다음, 카카오)를 통합 관리하는 IMAP/SMTP 기반 도구입니다.
## 주요 기능
- 📬 **다중 계정 통합**: Gmail, 네이버, 다음, 카카오 메일 동시 관리
- 📊 **스마트 요약**: 읽지 않은 메일 자동 요약 및 분류
- 🔍 **키워드 필터링**: 중요 메일 자동 탐지 (업무, 결제, 보안 등)
- 🤖 **자동 답장**: 템플릿 기반 빠른 답장
- 📰 **일일 다이제스트**: 하루 메일 요약 리포트 생성
## 설정
### 환경 변수 설정
스킬 폴더에 `.env` 파일을 생성하거나 환경 변수로 설정:
```bash
# 기본 계정 (필수)
DEFAULT_ACCOUNT=gmail # gmail, naver, daum, kakao 중 선택
# Gmail 계정
GMAIL_USER=your@gmail.com
GMAIL_PASS=your_app_password
GMAIL_IMAP_HOST=imap.gmail.com
GMAIL_IMAP_PORT=993
GMAIL_SMTP_HOST=smtp.gmail.com
GMAIL_SMTP_PORT=587
# 네이버 메일
NAVER_USER=your@naver.com
NAVER_PASS=your_password
NAVER_IMAP_HOST=imap.naver.com
NAVER_IMAP_PORT=993
NAVER_SMTP_HOST=smtp.naver.com
NAVER_SMTP_PORT=587
# 다음(Daum) 메일
DAUM_USER=your@daum.net
DAUM_PASS=your_password
DAUM_IMAP_HOST=imap.daum.net
DAUM_IMAP_PORT=993
DAUM_SMTP_HOST=smtp.daum.net
DAUM_SMTP_PORT=465
# 카카오(Kakao) 메일
KAKAO_USER=your@kakao.com
KAKAO_PASS=your_password
KAKAO_IMAP_HOST=imap.kakao.com
KAKAO_IMAP_PORT=993
KAKAO_SMTP_HOST=smtp.kakao.com
KAKAO_SMTP_PORT=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 | 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. 통합 메일 확인
모든 계정의 읽지 않은 메일 확인:
```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)
- 배송 완료 알림 (쿠팡)
...
🔵 읽을만한 (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추가 문의 사항 있으시면 연락 주세요."
}
}
```
## 크론 작업 예시
매일 아침 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: 앱 비밀번호 사용 여부 확인
- 네이버: IMAP/SMTP 설정 활성화 여부 확인
**TLS/SSL 에러:**
- 다음/카카오는 SMTP 포트 465 (SSL 직접 연결)
- Gmail/네이버는 SMTP 포트 587 (STARTTLS)
## 라이센스
MIT
标签
skill
ai
