Email Countdowns 是做什麼的?
Email Countdowns (https://emailcountdowns.com) 為每個行銷活動的截止期限代管一個倒數計時 GIF。當電子郵件被打開時,圖片會動態繪製,因此能顯示當下剩餘的準確時間。您可以先建立計時器,取得回傳的 embed_html,然後將其放入電子郵件中。
基礎 URL: https://emailcountdowns.com
1. 選擇連接服務的方式
請依序檢查您可以呼叫什麼:
- 已連接 MCP 工具。您的工具清單中包含
create-countdown和get-countdown-stats(該伺服器通常顯示為「Email Countdowns」或「Countdown Automation」)。請直接使用這些工具,然後跳到步驟 3。 - 有可用的 API 金鑰。使用者已提供工作區金鑰,或環境變數中已設定
COUNTDOWN_API_KEY。請使用 references/rest-api.md 中的 REST API。 - 以上皆非。使用者需要一個工作區和連線設定。請前往步驟 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 個字元 | 內部標籤,也會用作圖片的替代文字。請讓它易於閱讀,例如:「黑色星期五特賣結束」。 |
date | YYYY-MM-DD | 必須是未來的截止日期。 |
time | HH:MM,24 小時制 | 計時器歸零的時刻。 |
timezone | IANA 時區名稱 | 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 的儀表板。
刪除計時器會導致所有已發送郵件中的圖片失效。在刪除之前,請先與使用者確認,並且建議保留已結束的計時器;在截止時間過後,圖片會顯示為零。
