Guide de mise en route — de la souscription à l'installation complète
Trois étapes pour avoir une recherche qui fonctionne. Puis trois modules indépendants, à activer selon vos besoins : aucun n'est obligatoire pour que le moteur réponde à vos clients.
Fondations
ObligatoireSouscription · clé API · premier catalogue indexé
Heurix Tracker
OptionnelSuivi de conversion — clics et achats liés à une recherche
Intégration front-end
OptionnelBarre de recherche prête à l'emploi sur votre site
Serveur MCP
OptionnelBranchez Heurix directement à un agent IA
Étape 1 — Créez votre compte
Créez votre compte depuis la console : l'essai gratuit de 14 jours ne demande pas de carte bancaire. Votre clé API (hx_...) est immédiatement disponible dans votre console, menu Mon compte → Clé API. Un plan payant se souscrit ensuite sur la page tarifs.
Étape 2 — Indexez votre premier catalogue
Un seul appel suffit : le catalogue se crée automatiquement au premier import, pas de configuration préalable :
curl -X POST https://api.heurix.fr/v1/index/moncatalogue/items \
-H "Authorization: Bearer VOTRE_CLE_API" \
-H "Content-Type: application/json" \
-d '{
"items": [
{"id": "sku-1", "name": "Perceuse GDX 18V-285 BOSCH", "ref": "M8 x 20 - Inox A2", "stock": 8, "price": 139.90}
]
}'Précisez "rulepack": "outillage" dans le corps de la requête si votre secteur correspond à l'un des onze packs de règles pré-configurés ; sinon, le moteur indexe quand même, avec une reconnaissance de structure plus limitée tant qu'aucun pack ou Custom Rule n'est actif.
Étape 3 — Confirmez que la recherche fonctionne
curl -X POST https://api.heurix.fr/v1/index/moncatalogue/search \
-H "Authorization: Bearer VOTRE_CLE_API" \
-H "Content-Type: application/json" \
-d '{"q": "perceuse bosch"}'Une réponse avec votre produit dans hits confirme que tout fonctionne. À ce stade, la recherche est pleinement opérationnelle — tout ce qui suit est optionnel.
Construisez votre parcours
Trois questions pour ne garder que ce qui vous concerne. Les étapes 1 à 3 ci-dessus sont obligatoires dans tous les cas.
Souhaitez-vous mesurer les ventes générées par la recherche ?
Vos équipes doivent-elles interroger le catalogue via un agent IA ?
Disposez-vous déjà d'une interface de recherche sur votre site ?
À partir d'ici, trois modules indépendants
Deux des trois modules tournent dans le navigateur (Tracker et intégration front-end). Générez d'abord une clé publique depuis votre console (menu Mon compte → Clé API) : elle commence par hxp_ et ne peut que chercher, parcourir et remonter des événements. Votre clé serveur (hx_) ne doit jamais apparaître dans une page web : elle donne accès à votre facturation. Détail des deux types de clés.
Chacun répond à un besoin différent. Activez ce qui vous concerne, ignorez le reste : rien n'est requis pour les deux autres, et rien n'est requis pour que la recherche elle-même continue de fonctionner.
Module optionnel — Heurix Tracker (Conversion & ROI)
Pour savoir quelles recherches génèrent réellement des ventes, pas seulement des clics. Téléchargez heurix-tracker.js, éditez les deux variables en tête de fichier avec votre clé et votre catalogue :
var HEURIX_API_KEY = "VOTRE_CLE_PUBLIQUE"; // hxp_, pas hx_
var HEURIX_CATALOG = "moncatalogue";Puis posez le script une seule fois, site-wide :
<script src="heurix-tracker.js"></script>Appelez ensuite Heurix.trackClick(query, productId) sur un clic depuis vos résultats de recherche, et Heurix.trackPurchase([{id, amount, margin}]) à la confirmation d'une commande — détail complet dans la documentation Conversion & ROI.
Module optionnel — Intégration front-end
Deux façons d'afficher une recherche sur votre site, selon votre situation :
Vous partez de zéro, pas de recherche existante — heurix-search.js, un script autonome qui affiche une barre de recherche complète (saisie, résultats, facettes) en trois lignes :
<div id="ma-recherche"></div>
<script src="heurix-search.js"></script>
<script>
Heurix.searchBox({ apiKey: "VOTRE_CLE_PUBLIQUE", catalog: "moncatalogue", containerId: "ma-recherche" });
</script>Vous avez déjà une interface, ou une stack JS/TS établie — heurix-client, un client léger pour construire votre propre interface :
npm install heurix-clientimport { HeurixClient } from "heurix-client";
const client = new HeurixClient({ apiKey: "VOTRE_CLE_API", catalog: "moncatalogue" });
const results = await client.search("perceuse bosch");Détail complet des deux options : heurix-search.js et la référence API pour construire votre propre appel.
Module optionnel — Serveur MCP (agents IA)
Pour qu'un agent IA (Claude Desktop, Cursor, un agent interne) interroge votre catalogue en langage naturel, sans jamais appeler l'API lui-même. Guide complet, installation pas à pas incluse : Connecter Heurix à Claude Desktop et Cursor.
Et ensuite
Une fois ces bases posées, la documentation complète couvre le reste : synonymes, facettes, Browse & Discovery, priorités de requête. Rien de tout ça n'est nécessaire pour démarrer, mais tout est disponible dès que vous en avez besoin. Ce qu'il faut regarder chaque semaine, et quel levier essayer d'abord : piloter votre recherche au quotidien.