# My Gmail Attachment Extractor

> my-gmail-attachment-extractor

- Skill: `eoash/my-gmail-attachment-extractor` (Agent Skill)
- Install (CLI): `npx skillmds@latest add eoash/my-gmail-attachment-extractor`
- Raw SKILL.md: https://api.skillmd.com/api/skills/eoash/my-gmail-attachment-extractor/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: eoash (https://skillmd.com/u/eoash)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/eoash/my-gmail-attachment-extractor

---

# my-gmail-attachment-extractor

Gmail에서 첨부파일을 자동으로 다운로드하고, 파일 타입별로 처리(압축해제, 텍스트 추출)하는 스킬.

## 사용 시나리오
- 변호사/회계사로부터 받은 계약서 패키지 일괄 다운로드
- 메일 첨부파일에서 텍스트 추출 후 분석
- ZIP 안의 문서들 자동 압축 해제 및 정리

## 실행 흐름

### Step 1: Gmail 검색
```
사용자 입력: 검색 쿼리 (예: "from:eugene subject:Flip has:attachment")
→ Gmail API로 매칭되는 메일 검색
→ 첨부파일 목록 출력
```

### Step 2: 다운로드
```
사용자 확인 후 첨부파일 다운로드
→ 저장 경로: docs/{project}/ 또는 사용자 지정 경로
→ ZIP 파일은 자동 압축 해제
```

### Step 3: 텍스트 추출 (선택)
```
--extract 옵션 시:
→ .docx → python-docx로 텍스트 추출
→ .pdf → PyPDF2로 텍스트 추출
→ 통합 텍스트 파일 생성 (all_extracted.txt)
```

## 의존성
- Gmail API (token_send.json)
- python-docx (docx 추출 시)
- PyPDF2 (pdf 추출 시)

## 상태: 초안 (구현 대기)
- 현재 `scripts/gmail_fetch.py` + 수동 docx 추출 코드가 분산되어 있음
- 이 스킬로 통합하면 반복 작업 제거 가능