Communitygithub.com

email-countdowns

Créez un GIF de compte à rebours en direct pour un e-mail marketing et placez-le dans le brouillon. À utiliser lorsque l'utilisateur souhaite un compte à rebours, un minuteur de date limite, un minuteur de fin de soldes, un minuteur de lancement ou un bloc d'urgence « se termine le » dans un e-mail, une newsletter ou une campagne (Klaviyo, Mailchimp, Resend, HubSpot, Campaign Monitor, Salesforce, Kit, GetResponse, Flodesk ou HTML brut). Couvre l'inscription à un espace de travail Email Countdowns gratuit, la connexion, la création du minuteur, le retour du code d'intégration et la lecture des statistiques de vues.

Qu'est-ce que email-countdowns ?

Email Countdowns est une compétence qui vous permet de créer facilement des GIFs de compte à rebours en direct pour vos campagnes e-mail. Le GIF est généré dynamiquement lorsque l'e-mail est ouvert, affichant le temps restant exact à ce moment-là. Cette compétence prend en charge plusieurs plateformes d'e-mail marketing (Klaviyo, Mailchimp, Resend, HubSpot, etc.) et s'intègre via MCP (Model Context Protocol) ou une API REST. Vous pouvez définir la date, l'heure, le fuseau horaire, les couleurs, et un identifiant de campagne unique. La compétence gère l'intégralité du flux : inscription si nécessaire, connexion, création du minuteur, génération du code HTML d'intégration, insertion dans le brouillon, et lecture des statistiques de vues. Elle vous guide également pour éviter les erreurs, comme les dates passées ou les doublons de campagne, et fournit des instructions spécifiques pour chaque plateforme.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Aperçu

Depuis le README du skill

email-countdowns preview

Documentation

Email Countdowns

Email Countdowns (https://emailcountdowns.com) héberge un GIF de compte à rebours pour chaque échéance de campagne. L'image est dessinée lorsque l'e-mail est ouvert, affichant ainsi le temps restant à cet instant. Vous créez le minuteur, récupérez le embed_html retourné, et le placez dans l'e-mail.

URL de base : https://emailcountdowns.com

1. Choisir comment accéder au service

Vérifiez ce que vous pouvez appeler, dans cet ordre :

  1. Les outils MCP sont connectés. Votre liste d'outils contient create-countdown et get-countdown-stats (le serveur est souvent affiché comme « Email Countdowns » ou « Countdown Automation »). Utilisez-les. Passez à l'étape 3.
  2. Une clé API est disponible. L'utilisateur vous a donné une clé d'espace de travail, ou COUNTDOWN_API_KEY est définie dans l'environnement. Utilisez l'API REST dans references/rest-api.md.
  3. Ni l'un ni l'autre. L'utilisateur a besoin d'un espace de travail et d'une connexion. Passez à l'étape 2.

Ne demandez pas à l'utilisateur de coller un mot de passe dans le chat. Ne tapez jamais un mot de passe à leur place.

2. Configurer un espace de travail (uniquement si nécessaire)

Demandez une fois : « Avez-vous déjà un compte Email Countdowns ? »

Pas de compte. Envoyez l'utilisateur sur https://emailcountdowns.com/register. Chaque nouveau compte reçoit 1 000 vues de compte à rebours gratuites, une fois, sans carte bancaire ni abonnement, afin de pouvoir créer et tester des minuteurs sans rien dépenser. Ils saisissent un nom, un nom d'espace de travail facultatif, une adresse e-mail et un mot de passe. Si vous contrôlez un navigateur, vous pouvez ouvrir cette page et remplir le nom, l'espace de travail et l'e-mail que l'utilisateur vous a donnés ; l'utilisateur tape le mot de passe et appuie sur S'inscrire lui-même.

Connectez-le. Choisissez la route qui correspond au client dans lequel vous vous exécutez :

ClientComment se connecter
Claude (web, desktop)Paramètres → Connecteurs → Ajouter un connecteur personnalisé. Nommez Email Countdowns, URL https://emailcountdowns.com/mcp/countdowns. Sélectionnez Connecter, connectez-vous, approuvez. Activez-le dans le chat.
Claude Codeclaude mcp add --transport http email-countdowns https://emailcountdowns.com/mcp/countdowns, puis exécutez /mcp et authentifiez-vous. L'installation de ce dépôt en tant que plugin ajoute le serveur pour vous.
ChatGPTParamètres → Apps → Paramètres avancés → activer le mode développeur. Créez une app, nommez Email Countdowns, URL https://emailcountdowns.com/mcp/countdowns, authentification OAuth. Connectez-vous, puis sélectionnez l'app dans le menu outils d'un nouveau chat. Les paramètres du plan et de l'espace de travail déterminent si cela est disponible.
Codex CLIcodex mcp add email-countdowns --url https://emailcountdowns.com/mcp/countdowns, puis codex mcp login email-countdowns.
Gemini CLIgemini mcp add --transport http countdowns https://emailcountdowns.com/mcp/countdowns, puis /mcp auth countdowns.
Scripts, actions GPT personnalisées, tout ce qui n'a pas de MCPLe propriétaire de l'espace de travail crée une clé sous Clé API d'équipe sur https://emailcountdowns.com/workspace. Stockez-la comme COUNTDOWN_API_KEY. Voir references/rest-api.md.

La connexion OAuth se produit dans le navigateur de l'utilisateur. S'ils ne sont pas encore inscrits, ils peuvent s'inscrire d'abord, puis relancer la connexion. L'écran de consentement accorde l'accès à l'espace de travail actif au moment où ils approuvent.

Après la connexion, appelez get-countdown-stats avec {"days": 7} pour confirmer que la connexion fonctionne. Dites à l'utilisateur quel nom d'espace de travail a été retourné.

3. Définir l'échéance

Vous avez besoin de quatre informations avant de créer quoi que ce soit :

ChampFormatNotes
nametexte, max 255Étiquette interne, également utilisée comme texte alternatif de l'image. Rendez-la lisible : « Fin des soldes du Black Friday ».
dateAAAA-MM-JJDoit produire une échéance future.
timeHH:MM, 24 heuresLe moment où le minuteur atteint zéro.
timezoneNom IANAEurope/Paris, America/New_York, Australia/Sydney.

Envoyez également campaign_key : un slug court et stable pour cette échéance, par exemple black-friday-2026. Réessayer avec la même clé et les mêmes paramètres retourne le minuteur existant au lieu d'un doublon. Une échéance différente nécessite une clé différente.

Résolvez les ambiguïtés avant d'appeler l'outil :

  • « Se termine vendredi à minuit » peut signifier 00:00 au début du vendredi ou 23:59 à sa fin. Demandez, ou énoncez votre lecture : « Je vais régler à 23:59 le vendredi 27 novembre, Europe/Paris. »
  • Convertissez les abréviations en fuseaux IANA : EST/EDT → America/New_York, PST/PDT → America/Los_Angeles, GMT/BST → Europe/London, CET → Europe/Paris, AEST → Australia/Sydney. Si le public couvre plusieurs régions, utilisez le fuseau dans lequel l'offre est définie.
  • Pas d'année donnée : utilisez la prochaine occurrence de cette date.
  • Lisez la date dans le texte de l'e-mail si l'utilisateur en rédige un. Le minuteur et le texte doivent correspondre.

Confirmez l'échéance à l'utilisateur en une ligne avant de créer le minuteur, à moins qu'il n'ait déjà énoncé les quatre faits sans ambiguïté.

Champs d'apparence facultatifs :

  • text_colour : hex, #RRGGBB. Par défaut #000000.
  • background_colour : hex ou transparent. Par défaut #ffffff. Faites correspondre la couleur de fond de l'e-mail là où se trouve le minuteur.
  • style_id, font_id : entiers. Envoyez uniquement les ID que l'utilisateur vous donne ou que vous lisez depuis l'éditeur de son tableau de bord. Ne les devinez pas ; un ID inconnu échoue à la validation. Omettez les deux pour le style par défaut.
  • description : texte libre, max 1 000.

4. Créer le compte à rebours

MCP :

{
  "name": "create-countdown",
  "arguments": {
    "name": "Fin des soldes d'hiver",
    "campaign_key": "winter-sale-2026",
    "date": "2026-12-18",
    "time": "17:00",
    "timezone": "Europe/Paris",
    "background_colour": "#ffffff",
    "text_colour": "#1a1a1a"
  }
}

Le résultat contient id, name, expires_at, gif_url et embed_html. L'API REST retourne les mêmes champs sous data (voir references/rest-api.md).

Erreurs que vous pouvez corriger :

  • Choose a future deadline. La date et l'heure sont passées dans ce fuseau horaire. Vérifiez l'année et le fuseau.
  • This campaign key already has different settings. La clé a été utilisée pour une autre échéance. Utilisez une nouvelle clé, ou réutilisez les paramètres d'origine.
  • Format invalide de timezone, date ou time. Corrigez le format et réessayez avec la même clé.

5. Placer dans l'e-mail

embed_html ressemble à ceci :

<img src="https://emailcountdowns.com/countdown/public/123.gif" alt="Fin des soldes d'hiver" width="300" style="max-width:100%;border:0;display:block;" />

Règles :

  • Utilisez l'URL hébergée exactement comme retournée. Ne téléchargez pas le GIF, ne le téléversez pas dans la bibliothèque d'images de la plateforme e-mail et ne le joignez pas en pièce jointe. Un GIF copié est figé au moment où il a été copié.
  • N'ajoutez pas de chaînes de requête, de paramètres de redimensionnement ou de proxys au src.
  • Vous pouvez modifier width (jusqu'à la largeur de la colonne de contenu, généralement 600) et entourer la balise d'un lien vers l'offre. Conservez max-width:100% pour qu'il rétrécisse sur les téléphones.
  • Pour le centrer, enveloppez-le : <table role="presentation" width="100%"><tr><td align="center">…</td></tr></table>.
  • Placez l'échéance en texte brut près du minuteur, pour les lecteurs dont le client bloque les images : « Soldes se terminent le 18 décembre à 17h heure française. »
  • Placez-le près de l'appel à l'action qu'il soutient, généralement juste au-dessus ou en dessous du bouton principal.

Les étapes spécifiques à chaque plateforme (Klaviyo, Mailchimp, Resend, HubSpot et autres) se trouvent dans references/email-platforms.md. Si vous pouvez modifier le brouillon via un autre outil connecté, insérez le HTML là, puis relisez le brouillon et vérifiez que le src est inchangé. Si vous ne pouvez pas modifier le brouillon, donnez à l'utilisateur le HTML et l'URL de l'image avec une phrase sur l'endroit où coller chacun.

N'envoyez ni ne planifiez la campagne. Cela reste à la charge de l'utilisateur.

Avant un envoi important, vérifiez que l'espace de travail a suffisamment de vues disponibles. Une fois les 1 000 vues gratuites utilisées, les minuteurs affichent une image vierge jusqu'à ce que le propriétaire de l'espace de travail active l'utilisation payante sous Utilisation et facturation sur https://emailcountdowns.com/dashboard/account. Si la liste est plus grande que les vues gratuites restantes, dites à l'utilisateur d'activer d'abord la facturation.

6. Faire un rapport

Donnez à l'utilisateur :

  • l'échéance telle que créée, avec le fuseau horaire
  • l'URL de l'image
  • le HTML d'intégration dans un bloc de code
  • où vous l'avez placé, ou où il doit le coller
  • la ligne de texte de secours en texte brut que vous avez ajoutée ou recommandée

Statistiques

get-countdown-stats prend days (1–90, défaut 30) et retourne, pour l'espace de travail actif : le nombre total et actif de minuteurs, les vues totales, les vues sur la période et une série quotidienne. Une vue est une requête pour l'image. Les clients de messagerie et les proxies de confidentialité (Apple Mail Privacy Protection, proxy d'image de Gmail) peuvent précharger ou mettre en cache les images, donc les vues ne sont pas des ouvertures humaines uniques. Dites-le lorsque vous les rapportez.

Modifier ou supprimer un minuteur

Les outils MCP créent uniquement des minuteurs et lisent des statistiques. Pour modifier l'échéance ou les couleurs, ou supprimer un minuteur, utilisez l'API REST avec une clé d'espace de travail, ou le tableau de bord sur https://emailcountdowns.com/dashboard.

Supprimer un minuteur brise l'image dans chaque e-mail déjà envoyé avec celui-ci. Confirmez avec l'utilisateur avant de supprimer, et préférez laisser les minuteurs terminés en place ; après l'échéance, l'image affiche zéro.

Plus

Skills associés