Communitygithub.com

이메일 카운트다운

마케팅 이메일용 실시간 카운트다운 타이머 GIF를 만들고 초안에 배치합니다. 사용자가 캠페인, 마감 촉박, 판매 종료 임박 또는 '종료 예정' 문구가 필요한 이메일에 사용합니다.

이메일 카운트다운란 무엇인가요?

이 스킬은 AI 에이전트(Claude, ChatGPT, Codex, Gemini 등)가 Email Countdowns 서비스와 통합하여 이메일 마케팅 캠페인에 실시간 카운트다운 타이머를 추가하도록 지원합니다. 에이전트는 MCP 도구(create-countdown, get-countdown-stats)를 직접 호출하거나 REST API를 통해 타이머를 생성, 설정 및 이메일 본문에 포함시킬 수 있습니다. 핵심 기능은 이메일이 열릴 때마다 서버에서 GIF 이미지를 실시간으로 렌더링하여 구독자에게 정확한 남은 시간을 보여주는 것입니다. 이 스킬은 사용자가 마감일, 시간대, 시각적 스타일을 지정하면 GPT가 적절한 embed_html 코드를 생성하여 Klaviyo, Mailchimp, Resend, HubSpot 등 주요 이메일 플랫폼의 이메일 본문에 삽입할 수 있도록 합니다. 또한 타이머 조회 통계를 제공하고, 사용량이 초과되면 과금 활성화를 안내하며, 타이머 변경/삭제 시 주의사항을 알려줍니다.

지원 대상✓Claude Code✓Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/nexasoftltd/email-countdowns-skill/tree/main/skills/email-countdowns

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

미리보기

스킬 README에서

이메일 카운트다운 preview

문서

Email Countdowns (이메일 카운트다운)

Email Countdowns (https://emailcountdowns.com) 는 각 캠페인의 마감 시간을 표시하는 카운트다운 GIF를 호스팅합니다. 이미지는 이메일이 열릴 때 그려지므로, 해당 시점의 남은 시간을 보여줍니다. 사용자가 타이머를 생성하고, 반환된 embed_html을 가져와 이메일에 넣습니다.

기본 URL: https://emailcountdowns.com

1. 서비스 접근 방법 선택

호출 가능한 방법을 다음 순서로 확인하세요:

  1. MCP 도구가 연결되어 있습니다. 도구 목록에 create-countdown과 get-countdown-stats가 포함되어 있습니다 (서버는 종종 "Email Countdowns" 또는 "Countdown Automation"으로 표시됨). 이를 사용하세요. 3단계로 건너뜁니다.
  2. API 키를 사용할 수 있습니다. 사용자가 워크스페이스 키를 제공했거나, 환경에 COUNTDOWN_API_KEY가 설정되어 있습니다. references/rest-api.md의 REST API를 사용하세요.
  3. 둘 다 아닙니다. 사용자에게 워크스페이스와 연결이 필요합니다. 2단계로 이동합니다.

사용자에게 채팅에 비밀번호를 붙여넣도록 요청하지 마세요. 사용자를 대신해 비밀번호를 입력하지 마세요.

2. 워크스페이스 설정 (필요한 경우에만)

한 번만 묻습니다: "이미 Email Countdowns 계정이 있으신가요?"

계정이 없는 경우. 사용자를 https://emailcountdowns.com/register 로 보냅니다. 모든 새 계정은 한 번, 카드 등록이나 구독 없이 1,000회의 무료 카운트다운 조회를 받으므로, 비용 부담 없이 타이머를 생성하고 테스트할 수 있습니다. 사용자가 이름, 선택적 워크스페이스 이름, 이메일 주소, 비밀번호를 입력합니다. 브라우저를 제어할 수 있다면 해당 페이지를 열고 사용자가 제공한 이름, 워크스페이스, 이메일을 입력할 수 있습니다. 사용자가 직접 비밀번호를 입력하고 등록 버튼을 누릅니다.

연결하기. 현재 실행 중인 클라이언트에 적합한 방법을 선택하세요:

클라이언트연결 방법
Claude (웹, 데스크톱)설정 → 커넥터 → 사용자 지정 커넥터 추가. 이름 Email Countdowns, URL https://emailcountdowns.com/mcp/countdowns. 연결 선택, 로그인, 승인. 채팅에서 활성화.
Claude Codeclaude mcp add --transport http email-countdowns https://emailcountdowns.com/mcp/countdowns, 그 다음 /mcp 실행 및 인증. 이 리포지토리를 플러그인으로 설치하면 서버가 자동 추가됩니다.
ChatGPT설정 → 앱 → 고급 설정 → 개발자 모드 활성화. 앱 만들기, 이름 Email Countdowns, URL https://emailcountdowns.com/mcp/countdowns, 인증 OAuth. 연결 후 새 채팅의 도구 메뉴에서 앱 선택. 요금제 및 워크스페이스 설정에 따라 사용 가능 여부가 결정됩니다.
Codex CLIcodex mcp add email-countdowns --url https://emailcountdowns.com/mcp/countdowns, 그 다음 codex mcp login email-countdowns.
Gemini CLIgemini mcp add --transport http countdowns https://emailcountdowns.com/mcp/countdowns, 그 다음 /mcp auth countdowns.
스크립트, 사용자 지정 GPT 액션, MCP를 지원하지 않는 모든 도구워크스페이스 소유자가 https://emailcountdowns.com/workspace 에서 팀 API 키를 생성합니다. COUNTDOWN_API_KEY로 저장하세요. references/rest-api.md 참조.

OAuth 로그인은 사용자의 브라우저에서 이루어집니다. 아직 등록되지 않은 경우 먼저 등록한 후 연결을 다시 실행할 수 있습니다. 동의 화면은 사용자가 승인할 때 활성화된 워크스페이스에 대한 액세스 권한을 부여합니다.

연결 후, get-countdown-stats를 {"days": 7}와 함께 호출하여 연결이 작동하는지 확인하세요. 어떤 워크스페이스 이름이 반환되었는지 사용자에게 알려줍니다.

3. 마감 시간 확정

타이머를 생성하기 전에 다음 네 가지 정보가 필요합니다:

필드형식참고
name텍스트, 최대 255자내부 레이블이며 이미지 대체 텍스트로도 사용됩니다. 읽기 쉽게 작성하세요: "블랙 프라이데이 세일 종료".
dateYYYY-MM-DD미래의 마감일이어야 합니다.
timeHH:MM, 24시간제타이머가 0이 되는 시점입니다.
timezoneIANA 이름Europe/London, America/New_York, Australia/Sydney.

또한 campaign_key를 보내세요: 이 마감일에 대한 짧고 안정적인 슬러그 (예: black-friday-2026). 동일한 키와 동일한 설정으로 재시도하면 중복 생성 없이 기존 타이머가 반환됩니다. 다른 마감일에는 다른 키가 필요합니다.

도구를 호출하기 전에 모호성을 해소하세요:

  • "금요일 자정 종료"는 금요일 시작 시점의 00:00 또는 종료 시점의 23:59를 의미할 수 있습니다. 질문하거나 해석을 명시하세요: "2026년 11월 27일 금요일 23:59, Europe/London 시간대로 설정합니다."
  • 약어를 IANA 시간대로 변환하세요: EST/EDT → America/New_York, PST/PDT → America/Los_Angeles, GMT/BST → Europe/London, CET → Europe/Paris, AEST → Australia/Sydney. 대상이 여러 지역에 걸쳐 있다면 프로모션이 정의된 시간대를 사용하세요.
  • 연도가 없는 경우: 해당 날짜의 다음 발생일을 사용하세요.
  • 사용자가 이메일 초안을 작성 중이라면 이메일 본문에서 날짜를 읽어오세요. 타이머와 본문이 일치해야 합니다.

사용자가 네 가지 정보를 모두 명확히 제시하지 않은 경우, 타이머를 생성하기 전에 한 줄로 마감 시간을 사용자에게 확인하세요.

선택적 외관 필드:

  • text_colour: 16진수, #RRGGBB. 기본값 #000000.
  • background_colour: 16진수 또는 transparent. 기본값 #ffffff. 타이머가 위치할 이메일 배경과 일치시키세요.
  • style_id, font_id: 정수입니다. 사용자가 제공하거나 대시보드 편집기에서 읽은 ID만 보내세요. 추측하지 마세요. 알 수 없는 ID는 유효성 검사에 실패합니다. 기본 스타일을 사용하려면 둘 다 생략하세요.
  • description: 자유 텍스트, 최대 1,000자.

4. 카운트다운 생성

MCP:

{
  "name": "create-countdown",
  "arguments": {
    "name": "겨울 세일 종료",
    "campaign_key": "winter-sale-2026",
    "date": "2026-12-18",
    "time": "17:00",
    "timezone": "Europe/London",
    "background_colour": "#ffffff",
    "text_colour": "#1a1a1a"
  }
}

결과에는 id, name, expires_at, gif_url 및 embed_html이 포함됩니다. REST API는 data 아래에 동일한 필드를 반환합니다 (references/rest-api.md 참조).

수정할 수 있는 오류:

  • Choose a future deadline. (미래의 마감일을 선택하세요.) 해당 시간대에서 날짜와 시간이 이미 지났습니다. 연도와 시간대를 확인하세요.
  • This campaign key already has different settings. (이 캠페인 키에 이미 다른 설정이 있습니다.) 키가 다른 마감일에 사용되었습니다. 새 키를 사용하거나 원래 설정을 재사용하세요.
  • timezone, date 또는 time 형식이 잘못되었습니다. 형식을 수정하고 동일한 키로 다시 시도하세요.

5. 이메일에 넣기

embed_html은 다음과 같습니다:

<img src="https://emailcountdowns.com/countdown/public/123.gif" alt="겨울 세일 종료" width="300" style="max-width:100%;border:0;display:block;" />

규칙:

  • 반환된 호스팅 URL을 그대로 사용하세요. GIF를 다운로드하여 이메일 플랫폼의 이미지 라이브러리에 업로드하거나 첨부하지 마세요. 복사된 GIF는 복사된 시점에 고정됩니다.
  • src에 쿼리 문자열, 크기 조정 매개변수 또는 프록시를 추가하지 마세요.
  • width는 최대 콘텐츠 열 너비(보통 600)까지 변경할 수 있으며, 태그를 프로모션 링크로 감쌀 수 있습니다. max-width:100%를 유지하여 모바일에서 축소되도록 하세요.
  • 중앙 정렬하려면 <table role="presentation" width="100%"><tr><td align="center">…</td></tr></table>로 감싸세요.
  • 이미지를 차단하는 이메일 클라이언트를 위해 타이머 근처에 일반 텍스트 마감 시간을 넣으세요: "세일은 18일 오후 5시(영국 시간)에 종료됩니다."
  • 타겟 쿠폰/행동 유도 버튼 근처, 일반적으로 메인 버튼 바로 위나 아래에 배치하세요.

플랫폼별 단계 (Klaviyo, Mailchimp, Resend, HubSpot 등)는 references/email-platforms.md에 있습니다. 다른 연결된 도구를 통해 초안을 편집할 수 있다면 거기에 HTML을 삽입하고, 초안을 다시 읽어 src가 변경되지 않았는지 확인하세요. 초안을 편집할 수 없다면 사용자에게 HTML과 이미지 URL을 제공하고 각각을 어디에 붙여넣을지 한 문장으로 알려주세요.

캠페인을 보내거나 예약하지 마세요. 이는 사용자의 몫입니다.

대량 발송 전에 워크스페이스에 충분한 조회수가 남아 있는지 확인하세요. 무료 조회수 1,000회를 모두 사용하면 타이머는 워크스페이스 소유자가 https://emailcountdowns.com/dashboard/account 의 사용량 및 청구에서 유료 사용을 활성화할 때까지 빈 이미지를 표시합니다. 수신자 목록이 남은 무료 조회수보다 크면 사용자에게 먼저 청구를 활성화하도록 알리세요.

6. 결과 보고

사용자에게 다음을 제공하세요:

  • 생성된 마감 시간 (시간대 포함)
  • 이미지 URL
  • 코드 블록의 임베드 HTML
  • HTML을 삽입한 위치 또는 사용자가 붙여넣어야 할 위치
  • 추가했거나 권장하는 일반 텍스트 대체 문구

통계

get-countdown-stats는 days (1~90, 기본값 30)를 받아 활성 워크스페이스에 대해 다음을 반환합니다: 총 카운트다운 수 및 활성 카운트다운 수, 전체 기간 조회수, 해당 기간 조회수 및 일일 시계열 데이터. 조회수는 이미지에 대한 요청 1회입니다. 이메일 클라이언트 및 개인정보 보호 프록시(Apple Mail 개인정보 보호, Gmail 이미지 프록시)는 이미지를 미리 가져오거나 캐시할 수 있으므로 조회수는 고유한 인간 열람 횟수가 아닙니다. 이를 보고할 때 함께 알려주세요.

타이머 변경 또는 삭제

MCP 도구는 타이머 생성 및 통계 읽기만 지원합니다. 마감 시간이나 색상을 변경하거나 타이머를 삭제하려면 워크스페이스 키와 함께 REST API를 사용하거나 https://emailcountdowns.com/dashboard 의 대시보드를 사용하세요.

타이머를 삭제하면 해당 타이머가 포함된 모든 전송된 이메일의 이미지가 깨집니다. 삭제 전에 사용자에게 확인하고, 완료된 타이머는 그대로 두는 것이 좋습니다. 마감 시간이 지나면 이미지는 0을 표시합니다.

추가 정보

관련 스킬