---
name: skill-email
description: Gmail API를 통한 이메일 읽기·쓰기·요약. 사용자가 "메일 확인해줘", "이메일 보내줘", "메일함 정리해줘" 등 이메일 관련 요청을 할 때 사용.
runtime:
  kind: external_http
  service_url_env: SKILL_EMAIL_URL
---

# skill-email

Gmail 통합 스킬. 포트 8501.

## Trigger

- `email_read`: 수신함 확인, 최근 메일 읽기, 안 읽은 메일
- `email_send`: 메일 작성·전송·답장
- `email_summary`: 메일함 요약, 핵심만 정리

## Do

- Gmail OAuth 토큰 기반 인증
- Push 알림 지원 (Google Pub/Sub)
- rb8001에서 HTTP로 호출

## Do Not

- 토큰 없이 호출하지 않음
- 비인증 사용자에게 메일 내용 노출 금지

## API

### 이메일 전송

POST /send

| 파라미터 | 타입 | 필수 | 설명 |
|---------|------|------|------|
| to | string | 필수 | 수신자 이메일 |
| subject | string | 필수 | 제목 |
| body | string | 필수 | 본문 |

### 이메일 조회

GET /messages

| 파라미터 | 타입 | 필수 | 설명 |
|---------|------|------|------|
| user_id | UUID | 필수 | 사용자 ID (쿼리 파라미터) |
| limit | int | 선택 | 최대 결과 수 (기본 10) |
| query | string | 선택 | 검색 쿼리 |
| provider | string | 선택 | "gmail" (기본) |

### 이메일 요약

POST /process

## 환경변수

- `USER_ID`, `TOKEN_BASE`, `TOPIC` (Gmail Push)