Documentation

Introduction

EcomMind est un connecteur MCP qui branche une base d'expérience ecommerce structurée dans l'IA que tu utilises déjà : ChatGPT, Claude ou Grok. La base contient 412 modules extraits des opérations réelles d'une marque DTC à 7 chiffres : décisions, seuils, méthodes et erreurs, documentés et tenus à jour.

Une fois connecté, ton IA arrête de répondre aux questions d'acquisition, d'offre, de créa ou d'unit economics avec des généralités du web : elle consulte d'abord la base, puis répond avec cette expérience, appliquée à tes chiffres.

Ce qu'EcomMind n'est pas

• Pas une app de plus. Aucun chat séparé : tu restes dans ton IA, avec ton historique et tes autres outils.
• Pas une formation. Aucune vidéo à regarder : des réponses à ta situation, au moment où tu en as besoin.
• Pas du contenu aspiré. La base n'agrège pas des articles publics : elle est écrite depuis les opérations, puis anonymisée.

Prérequis

• Un plan payant chez ton IA. Les connecteurs personnalisés sont une fonction payante chez ChatGPT, Claude et Grok.
• Un compte EcomMind, gratuit ou Max : le connecteur s'authentifie dessus.

Comment ça marche

Le trajet d'une question, de ton message à la réponse :

1. Tu poses ta question dans ton IA, comme d'habitude.
2. L'IA décide d'appeler l'outil search_ecom_knowledge exposé par le connecteur. L'appel est visible dans la conversation : un petit encart d'outil apparaît avant la réponse.
3. La base renvoie les modules les plus pertinents pour la question : des extraits structurés, pas des documents bruts.
4. Ton IA rédige sa propre réponse, appuyée sur ces modules et appliquée au contexte que tu as donné.

Deux conséquences. D'abord, l'intelligence reste celle de ton IA : EcomMind ajoute une source de vérité, pas une interface. Ensuite, la qualité de la réponse dépend du contexte que tu donnes : la base contient des seuils et des méthodes par situation, et ce sont tes chiffres qui décident lesquels s'appliquent.

Installation

Le connecteur s'installe en deux minutes. Tout se passe côté IA : tu ajoutes un connecteur personnalisé, tu colles l'URL d'EcomMind, puis tu te connectes avec ton compte EcomMind quand la fenêtre d'autorisation s'ouvre.

Vérifier l'installation

Colle cette première question telle quelle :

Une chose doit apparaître : l'encart d'outil (« search_ecom_knowledge » ou « EcomMind ») dans la conversation, avant la réponse. Cet encart est la preuve que la base a été consultée. Pas d'encart, c'est que l'IA a répondu de tête : va voir la section dépannage.

Le protocole MCP

MCP (Model Context Protocol) est le standard ouvert qui permet à une IA d'appeler des outils externes de façon contrôlée. Initié par Anthropic, il a été adopté par OpenAI et xAI : c'est pour ça qu'un seul connecteur EcomMind sert aussi bien ChatGPT que Claude et Grok.

Concrètement : un serveur expose des outils typés, l'IA les découvre à l'ajout du connecteur, décide seule du moment de les appeler, et chaque appel est visible dans la conversation. Rien ne tourne dans ton dos.

Ce qu'EcomMind expose

• search_ecom_knowledge : la recherche dans les modules de la base. C'est la seule capacité : le connecteur est en lecture seule, il ne peut agir sur rien.
• Les variantes search et fetch exigées par le contrat de connecteur de ChatGPT : même base, même lecture seule.

L'authentification

Le connecteur passe par OAuth : à l'ajout, ton IA ouvre une fenêtre EcomMind où tu te connectes avec ton compte. Aucune clé API à copier, rien à stocker. Retirer le connecteur de ton IA révoque l'accès.

Les modules

Le module est l'unité de la base. Ce n'est pas un article : c'est une décision documentée, avec ce qu'il faut pour la réutiliser.

• Le contexte : stade, type de produit, marché, niveau de budget.
• La décision ou la méthode, écrite pour être exécutée, pas contemplée.
• Les seuils : à partir de quel chiffre tu agis, jusqu'à quel chiffre tu attends.
• Les pièges : ce qui avait l'air juste et qui a coûté de l'argent.

D'où ça vient

La base est extraite des opérations réelles d'une marque DTC à 7 chiffres : des centaines d'heures de calls, de décisions et de tests, transcrites, structurées, puis anonymisées. Pas de noms de marques, pas de données personnelles, les chiffres sensibles en fourchettes. Ce que tu reçois, c'est l'expérience, pas l'identité.

Les familles

• Acquisition : Meta Ads, TikTok Ads, structures de test, scaling.
• Créa : hooks et angles, UGC, copywriting, direction artistique.
• Produit et offre : winner strategy, construction d'offre, pricing, sourcing.
• Économie : unit economics, point mort, mesure, budgets.
• Rétention : email et CRM, post-achat, réachat.

Versions et mises à jour

Chaque module est versionné : v1.0 à son entrée dans la base, puis incrémenté à chaque réécriture quand le terrain bouge. La base est mise à jour chaque semaine ; les dernières entrées sont visibles sur la page d'accueil. Les mises à jour sont incluses dans l'abonnement et disponibles immédiatement dans ton IA.

Les relances ciblées

Chaque réponse de la base se termine par un index : les titres des autres modules que la base contient sur le sujet. À la consultation suivante, ton IA commande les modules exacts que la question appelle, par leur titre, au lieu de chercher à l'aveugle. Tu n'as rien à faire : ça se joue entre ton IA et la base.

Bien poser ses questions

La base répond avec des seuils et des méthodes par situation. Plus ta question décrit la situation, plus la réponse est précise. Quatre règles suffisent :

1. Commence par « EcomMind ». Ça force la consultation au lieu d'une réponse de tête.
2. Donne tes chiffres. Produit, prix, marge, spend par jour, ROAS, stade. Un seuil n'a de sens qu'appliqué à ton économie.
3. Une décision par question. « Est-ce que je scale cette pub ? » bat « analyse tout mon business ». Enchaîne les questions dans la même conversation : le contexte se garde.
4. Demande le verdict. Formule « dis-moi quoi faire », pas « explique-moi ». La base est faite pour les décisions.

Avant / après

✗ « Comment améliorer mon ROAS ? »

✓ « EcomMind : ROAS 1,6 depuis 10 jours, produit à 39 €, marge brute 68 %, 150 €/jour sur Meta. Je coupe, j'optimise ou je scale ? »

Même sujet, résultats opposés : la première reçoit une checklist que n'importe qui peut écrire, la seconde reçoit un verdict calculé sur tes chiffres.

Prompts prêts à l'emploi

Six situations qui reviennent chaque semaine. Remplace les crochets par tes chiffres et colle.

EcomMind : ma pub tourne depuis [X] jours, ROAS [X], produit à [X] €, marge brute [X] %, budget [X] €/jour. Verdict : je coupe, j'optimise ou je scale, et pourquoi.

EcomMind : voici mon produit : [description courte, prix]. Cible pressentie : [qui]. Donne-moi les 3 angles les plus vendeurs et l'accroche de pub pour chacun.

EcomMind : produit [X] à [X] €, COGS [X] €. Construis l'offre complète : prix, bundle, bump, garantie, avec la logique derrière chaque choix.

EcomMind : prix [X] €, COGS [X] €, frais de paiement [X] %, TVA [X] %. Calcule mon ROAS point mort et dis-moi à partir de quel ROAS je scale.

EcomMind : mon CA a chuté de [X] % depuis [date]. Contexte : [spend stable ou modifié, saison, stock, changements sur le site]. Liste les causes probables dans l'ordre et le test pour confirmer chacune.

EcomMind : produit [X], angle [X]. Écris le brief créateur complet : script hook-problème-démo-preuve-CTA, shot list, et les 3 formats à décliner.

Combiner les connecteurs

Tes autres connecteurs apportent la donnée ; EcomMind apporte le jugement. L'IA orchestre les deux dans une même réponse : elle va chercher la donnée marché, puis la lit à travers les méthodes de la base. Deux combinaisons portent l'essentiel de la valeur :

Trouver des winners : EcomMind + TrendTrack ou Brandsearch

Le connecteur de données fait remonter les produits et marques qui accélèrent sur un marché ; EcomMind les passe à la grille winner et rend un verdict de lancement.

Produire des créas : EcomMind + Higgsfield

EcomMind écrit les hooks, les angles et les scripts ; le connecteur de génération produit les visuels à partir de ce brief.

Chaque connecteur s'installe séparément, avec son propre compte. EcomMind ne les revend pas : il les rend plus tranchants.

L'API (Max)

Le plan Max inclut l'accès API direct à la base : le même moteur de recherche que le connecteur, qui répond en JSON structuré. Branche-le dans tes propres agents, scripts ou outils internes : l'IA au milieu devient optionnelle.

Authentification

Génère ta clé depuis ta page compte (carte Accès API). Elle ne s'affiche qu'une fois ; range-la comme un mot de passe. Chaque requête la porte en en-tête Bearer :

POST /api/v1/search

Une question en entrée, les extraits de modules les plus pertinents en sortie. Corps : query (recherche par similarité), pillars (optionnel, pour resserrer la recherche), limit (1-8, 8 par défaut). Alternative : modules (une liste de titres exacts issus de résultats précédents) rend ces modules en entier et court-circuite la similarité. query ou modules est requis.

curl -X POST https://www.ecommind.co/api/v1/search \
  -H "Authorization: Bearer em_api_VOTRE_CLE" \
  -H "Content-Type: application/json" \
  -d '{"query": "seuils pour scaler une campagne Meta", "limit": 5}'

{
  "query": "seuils pour scaler une campagne Meta",
  "results": [
    {
      "id": "…",
      "title": "…",
      "pillar": "ads-launch",
      "content": "…"
    }
  ]
}

Le paramètre pillars accepte ces valeurs : ads-launch, creative, hooks, ugc, audience, geo, placement, seasonality, funnel, sourcing, product, economics, pricing, email, ltv, overview, lessons, meta, general.

GET /api/v1/usage

Ta consommation du mois en cours, dans les mêmes unités que la page compte (crédits). L'appel ne consomme rien.

Les erreurs

• 401 invalid_key · clé absente, invalide ou révoquée. Génère-la depuis ton compte.
• 403 max_required · le compte de la clé n'est plus sur Max. La clé survit à une rétrogradation ; l'accès, non.
• 429 rate_limited · la limite quotidienne de sécurité est atteinte. Elle se lève le lendemain ; pour un gros volume soutenu, écris-nous.
• 400 invalid_request · corps mal formé ; vérifie la forme ci-dessus.

Plans, limites, confidentialité

Les plans

• Gratuit : 100 crédits d'essai, une fois, soit dix questions. Ils ne se rechargent pas. Accès complet au connecteur, rien de bridé.
• EcomMind Max : questions illimitées et accès API, 29,90 € par mois ou 299 € par an.

Une question consomme 10 crédits. Une consultation de la base (l'encart d'outil que tu vois dans la conversation) est une question. Un message peut déclencher plusieurs consultations si l'IA décide de chercher plusieurs fois ; c'est rare en pratique.

Confidentialité

• EcomMind reçoit les requêtes de recherche envoyées par l'outil, jamais tes conversations.
• L'accès est lié à ton compte via OAuth ; retirer le connecteur de ton IA le révoque.
• Les cas de la base sont anonymisés à la source : pas de noms de marques, pas de données personnelles.

Dépannage

Il répond sans consulter la base

• Le connecteur doit être activé dans CHAQUE conversation : ChatGPT le choisit dans le menu « + », Claude et Grok dans le menu outils de la conversation.
• Commence ta question par « EcomMind ». Sans ça, l'IA répond souvent de tête.

L'option connecteur personnalisé n'apparaît pas

• ChatGPT : plan payant, sur ordinateur. Si besoin, active le Mode développeur : Réglages → Applications et connecteurs → Réglages avancés.
• Claude : plan payant (Pro ou plus). Sur mobile, ajoute-le d'abord depuis le web.
• Grok : dépend de ton plan ; vérifie d'abord depuis le navigateur d'un ordinateur.

La fenêtre OAuth échoue

• Identifie-toi avec le même email que ton compte EcomMind, puis autorise.
• Si ça boucle, retire le connecteur de ton IA et ajoute-le à nouveau : les sessions OAuth expirent parfois côté IA.

« Crédits épuisés » en Gratuit

Les 100 crédits d'essai sont accordés une seule fois et ne se rechargent pas. Pour continuer, passe à Max (illimité) depuis ton compte.

Toujours bloqué ? ecommind.ai@gmail.com