Hedwige dans votre assistant, par MCP

Branchez Claude ou un autre client MCP sur l’archive d’Hedwige avec votre clé d’API. L’assistant lit ce que vous lisez sur le site, avec les mêmes droits, et ne modifie rien.

Connecter claude.ai

Dans claude.ai (Paramètres, Connecteurs, Ajouter un connecteur personnalisé), donnez l’adresse https://hedwige.koeki.fr/wp-json/hedwige/v1/mcp et aucune clé : Claude ouvre la connexion d’Hedwige, vous l’autorisez une fois, et vous pouvez la déconnecter dans Mes clés MCP.

Connecter un assistant avec une clé

1. Créez une clé dans Mon espace, Mes clés MCP. Elle n’est montrée qu’une fois : copiez-la.
2. Dans Claude ou un autre client MCP, ajoutez un serveur de type HTTP (Streamable HTTP) à l’adresse https://hedwige.koeki.fr/wp-json/hedwige/v1/mcp.
3. Donnez-lui l’en-tête Authorization : Bearer suivi de votre clé.
4. Demandez par exemple : quelles marques du secteur Beauté ont envoyé une promotion la semaine dernière ?

Ce qu’il peut faire

• hedwige-search — Les newsletters publiées, des plus récentes aux plus anciennes : par marque, secteur, période et promotion ; par les mots de leur texte pour un abonné. Chacune avec sa date (heure de Paris), sa marque, son secteur, son objet et son adresse sur le site.
• hedwige-get-newsletter — Une newsletter publiée, par son identifiant ou son adresse : pour un abonné, son texte nettoyé et l’adresse de son rendu sur le site ; pour un compte gratuit, la même chose dans ses 10 newsletters par mois des 3 derniers mois, comptées avec le site, sinon son aperçu.
• hedwige-brand — Les chiffres d’envoi d’une marque sur ses newsletters publiées : le nombre, la première et la dernière, les jours, les heures et les mois, comme le bloc hedwige/brand-stats les montre.
• hedwige-sector — Les chiffres d’envoi d’un secteur sur ses newsletters publiées, comme le bloc hedwige/sector-stats les montre.
• hedwige-season — Les emails publiés d’un temps fort, d’un secteur ou de tous : le nombre, les marques, le premier envoi et les emails par jour, à l’heure de Paris, comme le bloc hedwige/season-stats les montre.
• hedwige-get-similar — Les newsletters publiées les plus proches par le sens d’une newsletter publiée, d’après les vecteurs déjà calculés (aucun appel à OpenAI), avec un score de 0 à 100 et la raison (même temps fort, même sorte d’offre, même marque, ou le sens seul), comme les montre le bloc hedwige/similar. Un abonné en reçoit 6 au plus, tout autre les 3 plus proches, sans score ni raison.
• hedwige-list-seasons — Les temps forts du calendrier marketing d’une année : slug, nom, premier et dernier jour (heure de Paris), source et date de la source.
• hedwige-get-season — Emails publiés d’un temps fort, d’un secteur ou de tous : nombre, marques, premier envoi et emails par jour, à l’heure de Paris, comme le bloc hedwige/season-stats les montre. Sous le seuil, aucun chiffre.
• hedwige-get-season-sectors — Emails publiés d’un temps fort par secteur : emails, marques et premier envoi de chacun, comme le bloc hedwige/season-stats avec la vue sectors les montre.
• hedwige-get-season-subjects — Les mots les plus fréquents des objets des emails publiés d’un temps fort, avec le nombre d’emails qui portent chacun, comme le bloc hedwige/season-subjects les montre.
• hedwige-get-email-offers — Les offres trouvées dans un email publié, comme les montre le bloc hedwige/offer-badges : la plus forte remise en pour cent, la plus forte remise en euros, la livraison offerte, les codes promotionnels (un code personnel n’est jamais donné) ; et la structure de l’offre : son seuil (un montant d’achat, un nombre d’articles), son produit (tout le site, une sélection, une catégorie), son évènement (un temps fort du calendrier, ou une vente de la marque) et son appel à l’action. Par des règles nommées, sans modèle. Pour un abonné.
• hedwige-compare-brands — Une marque face à une autre, ou face aux médianes des marques d’un secteur : rythme, jour et heure du plus grand nombre d’envois, part des emails avec une remise, remise moyenne, longueur de l’objet, comme les montre le bloc hedwige/brand-compare. Pour un abonné.
• hedwige-get-sector-benchmark — Les quartiles des marques d’un secteur (rythme, heure médiane, envois le week-end, part des emails avec une remise, remise moyenne, longueur de l’objet), et la place d’une marque parmi elles, comme les montre le bloc hedwige/sector-benchmark. Pour un abonné.
• hedwige-get-promo-report — Les promotions d’une marque ou d’un secteur, temps fort par temps fort, avec le même temps fort l’année précédente : emails avec une remise, leur part, la remise moyenne et la plus forte, et les écarts en points, comme les montre le bloc hedwige/promo-report. Pour un abonné.
• hedwige-get-promo-calendar — Les promotions d’une marque mois par mois, sur les 12 derniers mois ou sur une année : emails, emails avec une remise, leur part, la remise moyenne et la plus forte, et la première remise de chaque temps fort, comme le bloc hedwige/promo-calendar les montre ; seulement les mois et leur niveau pour qui n’est pas abonné.
• hedwige-get-brand-signature — Les mots qui distinguent une marque dans ses newsletters (TF-IDF de l’objet et du texte face à toute l’archive, un score de 0 à 100) et son registre (tu ou vous, longueur de l’objet, points d’exclamation, emojis, capitales), comme le bloc hedwige/brand-signature les montre ; 3 mots sans score pour qui n’est pas abonné.
• hedwige-get-welcome-series — Les emails de bienvenue d’une marque, du plus ancien au plus récent, avec leur jour depuis le premier et leur délai depuis le précédent, comme les montre le bloc hedwige/welcome-timeline (codes masqués). Pour un abonné.
• hedwige-get-email-score — Le score d’un email publié au regard de règles nommées et sourcées (poids, texte alternatif des images, lien de désinscription, version texte, lecture sur mobile, texte et images), avec le résultat de chacune, comme le montre le bloc hedwige/email-score. Ce n’est pas une note de la marque. Pour un abonné.
• hedwige-get-email-meta — L’outil d’envoi (ESP) d’un email publié, par son seul nom, déduit de ses en-têtes par une table de règles, et l’en-tête que la règle a lu ; jamais une adresse ni un en-tête en entier. Comme le montre le bloc hedwige/email-meta. Pour un abonné.
• hedwige-get-index — La pression des emails (une note de 0 à 10 par rapport à la normale du secteur) ou la météo des promos (le pourcentage de remise moyen détecté, normalisé par marque) d’un secteur un jour donné, avec les emails derrière, son état (publié, sous le seuil, données incomplètes, pas assez d’historique) et les jours de collecte incomplète ; des agrégats seulement, tels que le bloc hedwige/index-gauge les montre. Public.
• hedwige-get-season-brief — Ce qu’a fait le marché au même temps fort l’année précédente, pour un secteur ou toute l’archive : les dates de début des marques (leur premier email avec une remise), le volume par rapport aux 28 jours d’avant, les remises détectées, les objets types, tels que le bloc hedwige/season-brief les montre ; sous 10 emails, aucun brief. Pour un abonné.
• hedwige-search-by-meaning — Les newsletters publiées les plus proches par le sens d’une requête (ses mots n’ont pas à être les leurs), les plus proches d’abord, comme le bloc hedwige/semantic-search les donne. La requête part seule chez OpenAI et n’est gardée nulle part. Pour un abonné.
• hedwige-test-subject — Les objets déjà envoyés les plus proches par le sens d’un objet, avec leur marque et leur date, et un indice d’originalité de 0 à 100 dont la méthode est donnée. L’objet part seul chez OpenAI et n’est gardé nulle part ; chaque test compte dans la limite du jour. Pour un abonné.
• hedwige-get-trends — Les newsletters publiées des derniers mois groupées par le sens (les vecteurs déjà calculés, aucun appel à OpenAI) : chaque tendance avec ses mots, son statut (émergente, stable, en recul), sa croissance, ses marques, ses emails mois par mois, sa première marque et des exemples, comme les montre le bloc hedwige/trends. Un abonné les reçoit toutes, tout autre le nom et le statut des 3 premières.
• hedwige-get-first-movers — Pour une tendance (son id, tel que le donne hedwige/get-trends) ou un temps fort (son slug et son année), les marques dans l’ordre de leur première newsletter publiée qui en parle, la plus ancienne d’abord, comme les montre le bloc hedwige/first-movers. Un abonné reçoit les marques et leurs newsletters, tout autre les 3 premières marques.
• hedwige-get-link-map — Une marque, un secteur ou l’archive comme un réseau : ses marques, ses secteurs et les outils d’envoi de leurs emails publiés (d’après le Message-ID), chaque nœud avec sa sorte, son poids de 1 à 5 et sa position, chaque lien avec son poids, comme les dessine le bloc hedwige/link-map. Par des règles, sans modèle. Pour un abonné.
• hedwige-get-persuasion — Les cinq leviers de persuasion (urgence, rareté, preuve sociale, exclusivité, émotion) d’une newsletter publiée, ou la part des newsletters publiées d’une marque des 12 derniers mois qui emploient chacun, trouvés par des règles nommées ; avec 3 extraits au plus chacun pour un abonné, les seuls leviers présents pour les autres.

Droits et quota

Un abonné lit chaque newsletter en entier. Un compte gratuit lit 10 newsletters par mois parmi celles des 3 derniers mois, comptées avec le site ; un abonnement expiré a les droits d’un compte gratuit. 1 000 appels par jour et par compte, toutes ses clés ensemble (3 au plus) : à partir de 80 %, un appel toutes les 5 secondes ; à 100 %, aucun jusqu’à minuit, heure de Paris.

Ce qui est journalisé

Chaque appel : sa date, le compte, une empreinte courte de la clé, l’ability, le résultat et la durée ; de ce que vous demandez, la marque et le secteur seulement, jamais vos mots. Le journal est gardé 6 mois. Une clé révoquée est supprimée au bout de 90 jours.