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 | 设置 → 应用 → 高级设置 → 启用开发者模式。创建应用,名称填写 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 创建 Team API 密钥。将其存储为 COUNTDOWN_API_KEY。请参阅 references/rest-api.md。 |
OAuth 登录在用户的浏览器中完成。如果他们尚未注册,可以先注册,然后重新运行连接。同意屏幕授予对批准时处于活动状态的工作区的访问权限。
连接后,调用 get-countdown-stats,参数为 {"days": 7},以确认连接正常工作。告诉用户返回的工作区名称。
3. 确定截止时间
在创建任何内容之前,你需要四个信息:
| 字段 | 格式 | 备注 |
|---|---|---|
name | 文本,最长 255 个字符 | 内部标签,也用作图像的 alt 文本。使其可读性良好,例如:“黑五大促结束”。 |
date | YYYY-MM-DD | 必须是未来的截止日期。 |
time | HH:MM,24 小时制 | 计时器归零的时刻。 |
timezone | IANA 名称 | Europe/London、America/New_York、Australia/Sydney。 |
还需发送 campaign_key:此截止日期的简短稳定标识符,例如 black-friday-2026。使用相同键和相同设置重试将返回现有计时器而非重复项。不同的截止日期需要不同的键。
在调用工具前解决歧义:
- “周五午夜结束”可能指周五开始时的 00:00 或结束时的 23:59。询问,或说明你的理解:“我将设置为欧洲/伦敦时间,11 月 27 日周五的 23:59。”
- 将缩写转换为 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。不要猜测它们;未知 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)。
你可以修复的错误:
请选择一个未来的截止日期。该日期和时间在此时区已过去。检查年份和时区。此营销活动键已具有其他设置。该键已用于另一个截止日期。使用新键,或重复使用原始设置。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 的“使用量和计费”下启用付费使用。如果邮件列表大于剩余免费浏览次数,请告知用户先启用计费。
6. 报告结果
向用户提供:
- 创建的截止时间,包含时区
- 图像 URL
- 嵌入的 HTML(放在代码块中)
- 你放置的位置,或他们应粘贴的位置
- 你添加或推荐的纯文本后备内容
统计数据
get-countdown-stats 接受 days(1–90,默认 30),并针对活动工作区返回:总计和活动中的倒计时数量、所有时间的浏览数、指定周期内的浏览数以及每日序列。一次浏览代表一次图像请求。邮件客户端和隐私代理(Apple Mail 隐私保护、Gmail 图像代理)可能会预取或缓存图像,因此浏览数并非唯一的人为打开次数。在报告时应说明这一点。
更改或删除计时器
MCP 工具仅用于创建计时器和读取统计数据。要更改截止时间或颜色,或删除计时器,请使用带有工作区密钥的 REST API,或使用 https://emailcountdowns.com/dashboard 上的仪表盘。
删除计时器会破坏所有已发送邮件中的图像。在删除前请与用户确认,并优先保留已完成的计时器;截止时间过后,图像会显示零。
