gws-gmail-watch은(는) 무엇을 하나요?
Gmail: 새 이메일을 감시하고 NDJSON으로 스트리밍합니다.
개요
이 스킬은 Gmail API의 Watch 기능을 사용하여 새 이메일이 도착할 때마다 효율적으로 감지하고, 각 메시지의 메타데이터(발신자, 제목, 수신 시간 등)를 NDJSON 형식으로 스트리밍합니다. 실시간 이메일 모니터링이 필요한 애플리케이션에 적합합니다.
사용 방법
-
전제 조건
- Google Cloud 프로젝트에서 Gmail API 활성화되어 있어야 합니다.
- OAuth 2.0 클라이언트 ID 또는 서비스 계정이 설정되어 있어야 합니다.
- Gmail 사용자 계정에 대한 액세스 권한이 필요합니다.
-
인증 설정
- 필요한 환경 변수를 설정하세요:
export GOOGLE_APPLICATION_CREDENTIALS="/path/to/service-account-key.json" export GMAIL_USER_EMAIL="[email protected]"
- 필요한 환경 변수를 설정하세요:
-
실행
- 다음 명령어로 스킬을 실행하세요:
npx @anthropic-ai/claude-code --skill googleworkspace/gws-gmail-watch - 또는 에이전트 내에서
/gws-gmail-watch명령어를 사용하세요.
- 다음 명령어로 스킬을 실행하세요:
출력 형식
출력은 각 줄이 하나의 이메일 이벤트를 나타내는 NDJSON 스트림입니다. 각 객체는 다음과 같은 필드를 포함합니다:
{
"id": "message-id",
"threadId": "thread-id",
"from": "[email protected]",
"subject": "이메일 제목",
"date": "2023-10-01T12:34:56Z",
"snippet": "이메일 내용의 미리보기..."
}
지원 플랫폼
- Claude Code
- 기타 AI 에이전트 플랫폼 (적절한 인증 및 API 호출 지원 시)
참고 사항
- 이 스킬은 장기 실행 프로세스로 설계되었습니다. 중단하려면
Ctrl+C를 누르세요. - Gmail API의 Watch 요청은 기본적으로 7일 후에 만료되므로, 필요에 따라 갱신해야 합니다.
- 자세한 내용은 Gmail API 문서를 참조하세요.