Communitygithub.com

Email Countdowns: temporizadores de cuenta atrás en vivo

Crea un GIF de cuenta atrás en vivo para campañas de email marketing y lo inserta en el borrador. Ideal para generar urgencia con ofertas por tiempo limitado en plataformas como Klaviyo, Mailchimp, HubSpot y otras.

¿Qué es Email Countdowns: temporizadores de cuenta atrás en vivo?

Email Countdowns habilita a los agentes de IA para crear temporizadores de cuenta regresiva en vivo que se renderizan al abrir el email, mostrando el tiempo restante exacto en ese momento. La habilidad soporta múltiples formas de conexión: herramientas MCP (`create-countdown` y `get-countdown-stats`), API REST mediante clave de workspace, o guía al usuario para registrarse y conectar su workspace cuando no hay conexión previa. El agente debe determinar la fecha, hora y zona horaria del plazo, crear el temporizador y devolver el código HTML de inserción (`embed_html`) que referencia la imagen alojada en el servicio (nunca descargarla). También puede leer estadísticas de visualización y reportar el estado de la campaña. Es compatible con clientes como Claude, ChatGPT, Codex CLI, Gemini CLI y también se puede usar mediante scripts con la API REST. La habilidad enfatiza no modificar la URL de la imagen, no enviar ni programar la campaña, y advertir sobre el límite de vistas gratuitas.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Vista previa

Del README del skill

Email Countdowns: temporizadores de cuenta atrás en vivo preview

Documentación

Countdowns por Correo Electrónico (Email Countdowns)

Email Countdowns (https://emailcountdowns.com) aloja un GIF de cuenta atrás para cada plazo de campaña. La imagen se genera en el momento en que se abre el correo, mostrando el tiempo restante en ese instante. Tú creas el temporizador, tomas el embed_html devuelto y lo colocas en el correo.

URL base: https://emailcountdowns.com

1. Elegir cómo acceder al servicio

Verifica qué puedes usar, en este orden:

  1. Las herramientas MCP están conectadas. Tu lista de herramientas contiene create-countdown y get-countdown-stats (el servidor suele aparecer como "Email Countdowns" o "Countdown Automation"). Úsalas. Salta al paso 3.
  2. Hay una clave API disponible. El usuario te ha proporcionado una clave de workspace, o COUNTDOWN_API_KEY está definida en el entorno. Usa la API REST que se describe en references/rest-api.md.
  3. Ninguna de las anteriores. El usuario necesita un workspace y una conexión. Ve al paso 2.

No le pidas al usuario que pegue una contraseña en el chat. Nunca escribas una contraseña por él.

2. Configurar un workspace (solo si es necesario)

Pregunta una vez: "¿Ya tienes una cuenta de Email Countdowns?"

Sin cuenta. Envía al usuario a https://emailcountdowns.com/register. Cada cuenta nueva recibe 1.000 visualizaciones de countdown gratuitas, una vez, sin necesidad de tarjeta ni suscripción, para que puedas crear y probar temporizadores sin gastar nada. El usuario introduce un nombre, un nombre de workspace opcional, una dirección de correo electrónico y una contraseña. Si controlas un navegador, puedes abrir esa página y rellenar el nombre, el workspace y el correo que el usuario te haya dado; el usuario escribe la contraseña y pulsa Registrar por sí mismo.

Conectar. Elige la ruta que se adapte al cliente en el que estés trabajando:

ClienteCómo conectar
Claude (web, escritorio)Ajustes → Conectores → Añadir conector personalizado. Nombre Email Countdowns, URL https://emailcountdowns.com/mcp/countdowns. Selecciona Conectar, inicia sesión, autoriza. Actívalo en el chat.
Claude Codeclaude mcp add --transport http email-countdowns https://emailcountdowns.com/mcp/countdowns, luego ejecuta /mcp y autentica. Instalar este repositorio como plugin añade el servidor automáticamente.
ChatGPTAjustes → Apps → Ajustes avanzados → activar modo desarrollador. Crear app, nombre Email Countdowns, URL https://emailcountdowns.com/mcp/countdowns, autenticación OAuth. Conectar, luego seleccionar la app desde el menú de herramientas en un nuevo chat. La configuración del plan y del workspace determina si está disponible.
Codex CLIcodex mcp add email-countdowns --url https://emailcountdowns.com/mcp/countdowns, luego codex mcp login email-countdowns.
Gemini CLIgemini mcp add --transport http countdowns https://emailcountdowns.com/mcp/countdowns, luego /mcp auth countdowns.
Scripts, Acciones personalizadas de GPT, cualquier cosa sin MCPEl propietario del workspace crea una clave en Clave API del equipo en https://emailcountdowns.com/workspace. Guárdala como COUNTDOWN_API_KEY. Consulta references/rest-api.md.

El inicio de sesión OAuth ocurre en el navegador del usuario. Si aún no está registrado, puede registrarse primero y luego volver a ejecutar la conexión. La pantalla de consentimiento concede acceso al workspace que esté activo cuando el usuario lo apruebe.

Después de conectar, llama a get-countdown-stats con {"days": 7} para confirmar que la conexión funciona. Indica al usuario qué nombre de workspace ha devuelto.

3. Definir el plazo

Necesitas cuatro datos antes de crear nada:

CampoFormatoNotas
nametexto, máximo 255Etiqueta interna, también se usa como texto alternativo de la imagen. Hazlo legible: "Oferta de Black Friday termina".
dateAAAA-MM-DDDebe ser una fecha futura de plazo.
timeHH:MM, formato 24hEl momento en que el temporizador llega a cero.
timezoneNombre IANAEurope/London, America/New_York, Australia/Sydney.

También envía campaign_key: un slug corto y estable para este plazo, como black-friday-2026. Reintentar con la misma clave y la misma configuración devuelve el temporizador existente en lugar de un duplicado. Un plazo diferente necesita una clave diferente.

Resuelve ambigüedades antes de llamar a la herramienta:

  • "Termina el viernes a medianoche" puede significar 00:00 al inicio del viernes o 23:59 al final. Pregunta, o indica tu interpretación: "Configuraré 23:59 del viernes 27 de noviembre, Europe/London."
  • Convierte abreviaturas a zonas IANA: EST/EDT → America/New_York, PST/PDT → America/Los_Angeles, GMT/BST → Europe/London, CET → Europe/Paris, AEST → Australia/Sydney. Si la audiencia abarca varias regiones, usa la zona en la que está definida la oferta.
  • Sin año: usa la próxima ocurrencia de esa fecha.
  • Lee la fecha del texto del correo si el usuario está redactando uno. El temporizador y el texto deben coincidir.

Confirma el plazo al usuario en una sola línea antes de crear el temporizador, a menos que ya haya indicado los cuatro datos de forma inequívoca.

Campos de apariencia opcionales:

  • text_colour: hexadecimal, #RRGGBB. Por defecto #000000.
  • background_colour: hexadecimal o transparent. Por defecto #ffffff. Debe coincidir con el fondo del correo donde se coloca el temporizador.
  • style_id, font_id: enteros. Solo envía IDs que el usuario te haya dado o que hayas leído de su editor de panel. No los adivines; un ID desconocido falla la validación. Omite ambos para el estilo predeterminado.
  • description: texto libre, máximo 1.000.

4. Crear el countdown

MCP:

{
  "name": "create-countdown",
  "arguments": {
    "name": "Oferta de invierno termina",
    "campaign_key": "winter-sale-2026",
    "date": "2026-12-18",
    "time": "17:00",
    "timezone": "Europe/London",
    "background_colour": "#ffffff",
    "text_colour": "#1a1a1a"
  }
}

El resultado contiene id, name, expires_at, gif_url y embed_html. La API REST devuelve los mismos campos bajo data (consulta references/rest-api.md).

Errores que puedes solucionar:

  • Elige una fecha futura. La fecha y hora ya han pasado en esa zona horaria. Verifica el año y la zona.
  • Esta clave de campaña ya tiene una configuración diferente. La clave se usó para otro plazo. Usa una clave nueva o reutiliza la configuración original.
  • Formato inválido de timezone, date o time. Corrige el formato y vuelve a intentar con la misma clave.

5. Colocarlo en el correo

embed_html tiene este aspecto:

<img src="https://emailcountdowns.com/countdown/public/123.gif" alt="Oferta de invierno termina" width="300" style="max-width:100%;border:0;display:block;" />

Reglas:

  • Usa la URL alojada exactamente como se devuelve. No descargues el GIF, no lo subas a la biblioteca de imágenes de la plataforma de correo ni lo adjuntes. Un GIF copiado se congela en el momento en que se copia.
  • No añadas cadenas de consulta, parámetros de redimensionamiento ni proxies al src.
  • Puedes cambiar width (hasta el ancho de la columna de contenido, normalmente 600) y envolver la etiqueta en un enlace a la oferta. Mantén max-width:100% para que se reduzca en teléfonos.
  • Para centrarlo, envuélvelo: <table role="presentation" width="100%"><tr><td align="center">…</td></tr></table>.
  • Coloca el plazo en texto plano cerca del temporizador, para los lectores cuyo cliente de correo bloquee las imágenes: "La oferta termina el 18 de diciembre a las 5 p.m. (hora del Reino Unido)".
  • Colócalo cerca de la llamada a la acción a la que acompaña, generalmente justo encima o debajo del botón principal.

Los pasos específicos de cada plataforma (Klaviyo, Mailchimp, Resend, HubSpot y otras) están en references/email-platforms.md. Si puedes editar el borrador a través de otra herramienta conectada, inserta el HTML allí, luego lee el borrador de vuelta y verifica que el src no haya cambiado. Si no puedes editar el borrador, entrégale al usuario el HTML y la URL de la imagen con una frase sobre dónde pegar cada uno.

No envíes ni programes la campaña. Eso queda en manos del usuario.

Antes de un envío masivo, verifica que el workspace tenga vistas disponibles. Una vez utilizadas las 1.000 vistas gratuitas, los temporizadores muestran una imagen en blanco hasta que el propietario del workspace active el uso de pago en Uso y facturación en https://emailcountdowns.com/dashboard/account. Si la lista es mayor que las vistas gratuitas restantes, dile al usuario que primero active la facturación.

6. Informar al usuario

Proporciónale al usuario:

  • el plazo tal como se creó, con la zona horaria
  • la URL de la imagen
  • el HTML de inserción en un bloque de código
  • dónde lo has colocado, o dónde debe pegarlo
  • la línea de texto alternativo que has añadido o que recomiendas

Estadísticas

get-countdown-stats recibe days (1–90, por defecto 30) y devuelve, para el workspace activo: total de countdowns y countdowns activos, vistas totales, vistas en el período y una serie diaria. Una vista es una solicitud de la imagen. Los clientes de correo y los proxies de privacidad (Protección de Privacidad de Apple Mail, proxy de imágenes de Gmail) pueden precargar o cachear imágenes, por lo que las vistas no corresponden a aperturas únicas de personas. Indícalo al reportarlas.

Cambiar o eliminar un temporizador

Las herramientas MCP solo crean temporizadores y leen estadísticas. Para cambiar el plazo o los colores, o para eliminar un temporizador, usa la API REST con una clave de workspace, o el panel en https://emailcountdowns.com/dashboard.

Eliminar un temporizador rompe la imagen en todos los correos ya enviados con él. Confírmalo con el usuario antes de eliminar, y prefiere dejar los temporizadores finalizados en su lugar; después del plazo, la imagen muestra cero.

Más información

Skills relacionados