Communitygithub.com

邮件倒计时

为营销邮件创建实时倒计时计时器 GIF 并放入草稿中。当用户希望在邮件、新闻通讯或营销活动中添加倒计时、截止日期、促销结束计时器、发布计时器或“即将结束”的紧迫感模块时使用(支持 Klaviyo、Mailchimp、Resend、HubSpot、Campaign Monitor、Salesforce、Kit、GetResponse、Flodesk 或纯 HTML)。涵盖注册免费 Email Countdowns 工作区、连接、创建计时器、返回嵌入代码以及查看统计数据。

邮件倒计时 是什么?

该技能为 Claude、ChatGPT 等 AI 代理提供了在营销邮件中嵌入实时倒计时 GIF 的能力。它通过 Email Countdowns 服务 (https://emailcountdowns.com) 实现,当邮件被打开时,GIF 图像会实时绘制剩余时间,从而营造紧迫感并提升点击率。该技能支持多种平台,包括 Klaviyo、Mailchimp、HubSpot 和 Resend,并可以通过 MCP 协议(工具如 `create-countdown` 和 `get-countdown-stats`)或 REST API 进行操作。首先需要设置一个工作区(新用户免费获得 1000 次浏览),然后根据用户提供的截止日期、时间和时区创建计时器,最后将生成的 `embed_html` 代码直接插入邮件 HTML 中。此外,技能还能读取统计信息,帮助用户了解计时器的浏览情况。

兼容平台✓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

邮件倒计时 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设置 → 应用 → 高级设置 → 启用开发者模式。创建应用,名称填写 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 文本。使其可读性良好,例如:“黑五大促结束”。
dateYYYY-MM-DD必须是未来的截止日期。
timeHH:MM,24 小时制计时器归零的时刻。
timezoneIANA 名称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 上的仪表盘。

删除计时器会破坏所有已发送邮件中的图像。在删除前请与用户确认,并优先保留已完成的计时器;截止时间过后,图像会显示零。

更多信息

相关技能