이메일 검색¶

이메일 검색 스킬은 IMAP 검색 문법으로 이메일을 검색합니다. 검색된 이메일 ID를 이메일 수신 스킬에 전달하여 상세 내용을 조회합니다.

설정 방법¶

1. 스킬 노드 추가 및 선택¶

스킬 노드를 추가하고 우측 패널에서 이메일 검색을 선택합니다.

2. IMAP 인증 연결¶

인증 탭에서 IMAP 인증 정보를 선택합니다. (이메일 수신과 동일한 인증 사용 가능)

3. 검색 조건 입력¶

설정 탭에서 IMAP 검색 쿼리를 입력합니다.

파라미터¶

파라미터	필수	설명
query	O	IMAP 검색 쿼리
folder		검색할 폴더 (기본: `INBOX`)
limit		최대 결과 수 (기본: 50)

검색 쿼리 예시¶

FROM "sender@example.com"
SUBJECT "주문 확인"
FROM "shop@example.com" SUBJECT "invoice"
SINCE "01-Mar-2026" UNSEEN

인증 정보¶

IMAP 인증이 필요합니다. (이메일 수신 스킬과 동일)

출력¶

{
  "success": true,
  "data": {
    "email_ids": ["1234", "1235", "1240"],
    "count": 3,
    "query": "FROM \"shop@example.com\"",
    "folder": "INBOX"
  }
}

출력 참조¶

{{ $('skill_1').data_content.result.email_ids }}  → 이메일 ID 목록
{{ $('skill_1').data_content.result.count }}       → 검색 결과 수

사용 예시¶

검색 → 수신 2단계 처리¶

이메일 검색으로 대상을 먼저 좁힌 후, 이메일 수신 스킬의 email_ids 파라미터에 검색 결과를 전달합니다.

스킬	파라미터	값
이메일 검색	query	`FROM "partner@example.com" SINCE "01-Mar-2026"`
이메일 수신	email_ids	`{{ $('skill_search').data_content.result.email_ids }}`

참고¶

UTF-8 검색을 지원하며, 한국어 키워드로 검색할 수 있습니다.
검색 실패 시 자동 재시도 (최대 3회, 지수 백오프)합니다.
Gmail의 경우 X-GM-RAW 확장 검색 문법도 지원합니다.