mufi-email-manager

한국 주요 이메일 서비스(Gmail, 네이버, 다음, 카카오)를 통합 관리하는 IMAP/SMTP 기반 도구입니다.

주요 기능

• 📬 다중 계정 통합: Gmail, 네이버, 다음, 카카오 메일 동시 관리
• 📊 스마트 요약: 읽지 않은 메일 자동 요약 및 분류
• 🔍 키워드 필터링: 중요 메일 자동 탐지 (업무, 결제, 보안 등)
• 🤖 자동 답장: 템플릿 기반 빠른 답장
• 📰 일일 다이제스트: 하루 메일 요약 리포트 생성

설정

환경 변수 설정

스킬 폴더에 .env 파일을 생성하거나 환경 변수로 설정:

# 기본 계정 (필수)
DEFAULT_ACCOUNT=gmail  # gmail, naver, daum, kakao 중 선택

# Gmail 계정
[email protected]
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

# 네이버 메일
[email protected]
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) 메일
[email protected]
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) 메일
[email protected]
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
[email protected]

한국 이메일 서버 정보

서비스	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. 통합 메일 확인

모든 계정의 읽지 않은 메일 확인:

node scripts/check-all.js [--limit 20]

특정 계정만 확인:

node scripts/check.js --account gmail [--limit 10]
node scripts/check.js --account naver [--limit 10]

2. 스마트 요약

읽지 않은 메일을 키워드 기반으로 분류하여 요약:

node scripts/summary.js [--account gmail] [--recent 24h]

출력 예시:

📬 읽지 않은 메일 요약 (Gmail)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🔴 중요 (3건)
  - [결제] 카드 승인 내역 안내 (신한카드)
  - [보안] 새로운 기기에서 로그인 시도 (Google)
  - [업무] 프로젝트 마감 알림 (팀장님)

🟡 일반 (12건)
  - 주간 뉴스레터 (Tech News)
  - 배송 완료 알림 (쿠팡)
  ...

🔵 읽을만한 (5건)
  - 친구 초대장 (Facebook)
  ...

3. 중요 메일 필터링

키워드로 중요 메일만 추출:

node scripts/filter.js --keywords "결제,청구,승인" [--account all] [--recent 7d]

4. 자동 답장

템플릿 기반 빠른 답장:

# 템플릿 목록
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. 일일 다이제스트

하루 메일 요약 리포트 생성:

node scripts/digest.js [--date 2026-02-16] [--accounts gmail,naver]

출력 형식: - 텍스트 리포트 - HTML 이메일로 전송 옵션 - JSON 형식 지원

6. 메일 발송

통합 발송 인터페이스:

node scripts/send.js 
  --account gmail 
  --to [email protected] 
  --subject "안녕하세요" 
  --body "메일 본문입니다." 
  [--attach file.pdf]

7. 검색

모든 계정에서 통합 검색:

node scripts/search.js 
  --query "프로젝트" 
  [--accounts gmail,naver] 
  [--recent 30d] 
  [--limit 50]

템플릿 커스터마이징

scripts/templates.json 파일에서 답장 템플릿 수정 가능:

{
  "thanks": {
    "subject": "Re: {original_subject}",
    "body": "안녕하세요,nn메일 감사합니다.n확인 후 회신 드리겠습니다.nn감사합니다."
  },
  "confirm": {
    "subject": "Re: {original_subject}",
    "body": "확인 완료했습니다.n추가 문의 사항 있으시면 연락 주세요."
  }
}

크론 작업 예시

매일 아침 9시 다이제스트 발송:

0 9 * * * cd /path/to/mufi-email-manager && node scripts/digest.js --send

30분마다 중요 메일 체크:

*/30 * * * * cd /path/to/mufi-email-manager && node scripts/filter.js --keywords "긴급,urgent" --notify

설치

cd skills/mufi-email-manager
npm install

보안 주의사항

• .env 파일을 .gitignore에 추가
• Gmail은 앱 비밀번호 사용 권장
• 비밀번호를 코드에 하드코딩하지 말 것
• 중요 메일은 자동 삭제하지 않도록 주의

트러블슈팅

연결 실패: - 서버 주소와 포트 확인 - 방화벽 설정 확인

인증 실패: - 이메일 주소와 비밀번호 재확인 - Gmail: 앱 비밀번호 사용 여부 확인 - 네이버: IMAP/SMTP 설정 활성화 여부 확인

TLS/SSL 에러: - 다음/카카오는 SMTP 포트 465 (SSL 직접 연결) - Gmail/네이버는 SMTP 포트 587 (STARTTLS)

라이센스

MIT