Communitygithub.com

Email Countdowns

為行銷電子郵件建立即時倒數計時器 GIF,並將其放入草稿中。適用於當使用者需要在電子郵件、電子報或行銷活動(Klaviyo、Mailchimp、Resend、HubSpot、Campaign Monitor、Salesforce、Kit、GetResponse、Flodesk 或純 HTML)中加入倒數計時、截止期限、促銷結束計時、啟動計時或「即將結束」的急迫感區塊時使用。涵蓋註冊免費的 Email Countdowns 工作區、連接服務、建立計時器、回傳嵌入程式碼以及檢視統計資料。

Email Countdowns 是什麼?

Email Countdowns 是一個專門為行銷電子郵件建立即時倒數計時器 GIF 的工具。當電子郵件被打開時,GIF 圖片會動態繪製,因此能顯示當下剩餘的準確時間,非常適合用來營造限時優惠、銷售截止或活動啟動的急迫感。該工具支援透過 MCP 協定(適用於 Claude、Claude Code、ChatGPT、Codex CLI、Gemini CLI 等多種 AI 用戶端)或 REST API 進行操作,並可以無縫整合到 Klaviyo、Mailchimp、HubSpot 等主流電子郵件平台。使用時,只需設定截止日期、時間和時區,系統即會產生一組嵌入 HTML 程式碼,可直接貼入電子郵件草稿中,確保圖片永遠顯示最新的剩餘時間。Email Countdowns 還提供免費的使用額度(1000 次檢視),並支援自訂計時器的文字顏色、背景顏色與字型樣式,讓行銷人員能輕鬆創建符合品牌風格的急迫感行銷素材。

相容平台✓Claude Code✓Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/nexasoftltd/email-countdowns-skill/tree/main/skills/email-countdowns

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

預覽

來自技能 README

Email Countdowns 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 Code執行 claude mcp add --transport http email-countdowns https://emailcountdowns.com/mcp/countdowns,然後執行 /mcp 進行身分驗證。安裝此儲存庫作為外掛程式也會自動加入伺服器。
ChatGPT設定 → Apps → 進階設定 → 啟用開發者模式。建立應用程式,名稱輸入 Email Countdowns,URL 輸入 https://emailcountdowns.com/mcp/countdowns,驗證方式選擇 OAuth。連接後,在新增聊天中從工具選單選取該應用程式。方案與工作區設定會決定此功能是否可用。
Codex CLI執行 codex mcp add email-countdowns --url https://emailcountdowns.com/mcp/countdowns,然後執行 codex mcp login email-countdowns。
Gemini CLI執行 gemini mcp add --transport http countdowns https://emailcountdowns.com/mcp/countdowns,然後執行 /mcp auth countdowns。
腳本、自訂 GPT 動作或任何不支援 MCP 的環境工作區擁有者在 https://emailcountdowns.com/workspace 的「團隊 API 金鑰」(Team API key) 下建立一個金鑰。將其儲存為 COUNTDOWN_API_KEY。請參閱 references/rest-api.md。

OAuth 登入會在使用者的瀏覽器中進行。如果使用者尚未註冊,可以先註冊,然後再次執行連接。授權畫面會授予連接時所使用之工作區的存取權限。

連接完成後,呼叫 get-countdown-stats 並傳入 {"days": 7} 以確認連接正常。告知使用者回傳的工作區名稱。

3. 確定截止時間

在建立任何東西之前,您需要四個資訊:

欄位格式備註
name文字,最多 255 個字元內部標籤,也會用作圖片的替代文字。請讓它易於閱讀,例如:「黑色星期五特賣結束」。
dateYYYY-MM-DD必須是未來的截止日期。
timeHH:MM,24 小時制計時器歸零的時刻。
timezoneIANA 時區名稱Europe/London、America/New_York、Australia/Sydney。

同時也要傳送 campaign_key:一個簡短穩定的 slug,用於標記這個截止時間,例如 black-friday-2026。使用相同的金鑰和相同的設定重試時,會回傳現有的計時器,而不是建立重複的。不同的截止時間需要使用不同的金鑰。

在呼叫工具之前,請先解決不明確之處:

  • 「週五午夜結束」可能指的是週五開始的 00:00,或者週五結束的 23:59。請詢問,或闡述您的解讀:「我會設定為 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:十六進位,#RRGGBB。預設為 #000000。
  • background_colour:十六進位或 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>。
  • 在計時器附近放置純文字的截止時間,以供無法顯示圖片的收件者閱讀:「特賣將於英國時間 12 月 18 日下午 5 點結束。」
  • 將其放置在它所支援的行動呼籲附近,通常在主按鈕的正上方或正下方。

特定平台的步驟(Klaviyo、Mailchimp、Resend、HubSpot 等)在 references/email-platforms.md 中。如果您可以透過其他連接的工具編輯草稿,請在那裡插入 HTML,然後重新讀取草稿並檢查 src 是否未被更改。如果您無法編輯草稿,請將 HTML 和圖片 URL 提供給使用者,並用一句話說明應該貼在何處。

請勿發送或排程行銷活動。這應由使用者自行決定。

在大規模發送之前,請檢查工作區是否有足夠的檢視次數。一旦用完 1,000 次免費檢視,計時器將顯示空白圖片,直到工作區擁有者在 https://emailcountdowns.com/dashboard/account 的「用量與帳單」(Usage and billing) 下開啟付費使用。如果郵件清單規模大於剩餘的免費檢視次數,請告知使用者先啟用付費功能。

6. 回報結果

向使用者提供:

  • 已建立的截止時間,包含時區
  • 圖片 URL
  • 程式碼區塊中的嵌入 HTML
  • 您放置的位置,或他們應該貼上的位置
  • 您添加或建議的純文字備援內容

統計資料

get-countdown-stats 接受 days(1–90,預設 30),並針對活躍的工作區回傳:計時器總數和活躍數量、歷史總檢視次數、指定期間內的檢視次數,以及每天的數據序列。一次檢視代表對圖片的一次請求。電子郵件用戶端和隱私代理(例如 Apple Mail Privacy Protection、Gmail 的圖片代理)可能會預先擷取或快取圖片,因此檢視次數並非唯一的人數開啟次數。請在回報時說明這一點。

變更或刪除計時器

MCP 工具僅能建立計時器和讀取統計資料。若要變更截止時間或顏色,或刪除計時器,請使用工作區金鑰的 REST API,或使用 https://emailcountdowns.com/dashboard 的儀表板。

刪除計時器會導致所有已發送郵件中的圖片失效。在刪除之前,請先與使用者確認,並且建議保留已結束的計時器;在截止時間過後,圖片會顯示為零。

更多資訊

相關技能