LE DÉMARRAGE, ÉTAPE PAR ÉTAPE

Votre première recommandation.
Un chemin clair pour y arriver.

Commencez par l’installation automatique : une commande dans le dossier de votre site, la détection de votre framework, puis votre assistant IA pour terminer l’intégration.

01. Lancez l’installation dans votre projet

INSTALLATION AUTOMATIQUE · ENTRÉE RECOMMANDÉE

npx @likyly/wizard

Le wizard détecte votre framework et sa version, installe le SDK, vous connecte à votre compte Likyly dans le navigateur, relie votre assistant IA au serveur MCP, vérifie le tout, puis lance votre assistant sur la suite.

Détection et plan. Le wizard reconnaît votre framework, vérifie que sa version est prise en charge et affiche tout ce qu’il va faire avant d’agir. Il n’écrase jamais un fichier existant. Dans un dépôt Git, il propose de travailler sur une nouvelle branche likyly/setup (vos modifications en cours suivent, intactes) et ne commite jamais.
Installation du SDK avec votre gestionnaire de paquets (npm, pnpm, yarn, bun, composer…).
Connexion à votre compte. Le navigateur s’ouvre sur likyly.com : connectez-vous ou créez votre compte (e-mail, GitHub ou Google). Votre clé publique et une clé MCP pour votre assistant reviennent seules dans le terminal. La clé publique va dans le fichier d’environnement de votre framework, la clé MCP dans .likyly/credentials.env, jamais commité.
Connexion de votre assistant IA : Claude Code, Cursor et VS Code, avec la skill Likyly pour Claude Code.
Vérification : SDK installé, versions compatibles, clés acceptées par l’API, assistant connecté.
Relecture : la liste des fichiers ajoutés et modifiés par Likyly, à part de ce que vous aviez déjà modifié. Relisez-les dans le panneau Source Control de VS Code (Ctrl/Cmd+Maj+G) ou avec git diff. Votre assistant fait de même : il code sur la même branche, ne commite pas, liste ses fichiers dans son récapitulatif et ouvre une pull request si vous le lui demandez.
Suite : Entrée lance Claude Code sur le prompt d’intégration (ou ouvre Cursor avec le prompt copié). Votre assistant relie le catalogue, crée l’emplacement, l’intègre à votre code et vérifie l’intégration.

Désinstaller

DÉSINSTALLER

npx @likyly/wizard uninstall

Montre d’abord ce qui sera retiré et demande confirmation (--dry-run pour seulement regarder). Retire ce que le wizard a ajouté : SDK, clé publique, fichier de démarrage s’il n’a pas été modifié, configuration MCP, skill, commandes et .likyly/. Votre code n’est jamais modifié : les fichiers qui utilisent encore Likyly sont listés. Votre compte (catalogue, emplacements, clés) reste intact. Dans Claude Code : /likyly-uninstall.

Sans interaction (CI) : npx @likyly/wizard --yes --public-key pk_…. Aperçu sans rien écrire : --dry-run. Le terminal doit faire au moins 64 × 20 caractères.

Vous préférez intégrer vous-même ? SDK et API REST

Les SDK et l’API constituent une autre entrée, pour garder la maîtrise du code d’intégration.

npm install @likyly/sdk

Sans SDK, utilisez directement les appels HTTP de l’API REST, disponible dès maintenant. La clé secrète reste sur le backend.

Consulter la documentation technique →

02. Ajoutez votre catalogue

Choisissez la source parmi celles que Likyly sait lire aujourd’hui (ci-dessous), ou importez directement par l’API.
Préparez les informations : un identifiant stable, un titre, une description et les attributs utiles. L’API exige item_id et title pour un import groupé ; titre, description et properties.category alimentent la similarité.
Vérifiez l’import : contrôlez les éléments reçus, les erreurs et la correspondance des identifiants avant d’envoyer des interactions.
Organisez la mise à jour : la synchronisation d’une source se déclenche à la demande (le nombre de synchronisations par jour dépend du forfait) ; les sources « push » sont mises à jour à chaque envoi.

Fichier CSV : import d’un fichier, ou lecture d’un CSV en ligne (URL).
API REST ou JSON : votre API ou un flux JSON, avec pagination et authentification configurables.
Shopify : connecteur natif : Likyly lit le catalogue via l’API Admin de la boutique.
WordPress / WooCommerce : l’extension LIKYLY envoie le catalogue, crée les blocs et les affiche, sans code (voir /docs/wordpress).
Webhook : votre système pousse les éléments vers Likyly à chaque changement.

Les autres plateformes (PrestaShop, Akeneo, Magento…) se relient par leur API ou par un export CSV : ce n’est pas une synchronisation native.

Un premier import côté serveur

L’API accepte jusqu’à 1 000 éléments par appel à POST /items/import, avec la clé secrète dans l’en-tête X-API-Key :

curl -X POST https://api.likyly.com/items/import \
  -H "X-API-Key: $LIKYLY_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "items": [{
    "item_id": "video_001",
    "title": "Le monde en mouvement",
    "description": "Un documentaire sur les mobilités urbaines.",
    "properties": {"category": "documentaire"}
  }]
}'

La réponse détaille les erreurs élément par élément : vérifiez-les avant de considérer l’import comme terminé.

03. Confiez l’intégration à votre assistant IA

Votre assistant écrit l’intégration à partir de votre code et pilote Likyly par le serveur MCP. Avec la clé publique, il obtient des recommandations et transmet des événements. Avec une clé MCP, il gère aussi les sources de catalogue (création, correspondance des champs, synchronisation) et les emplacements, puis vérifie l’intégration. Le catalogue arrive par une source de données ; si votre site tourne en local, hors d’atteinte de Likyly, l’assistant envoie lui-même les produits lus dans votre code.

Vous lui parlez en langage courant (« vérifie mon intégration Likyly », « vide le cache Likyly ») : pas de commande à retenir. Exemples de demandes

CONNEXION DE VOTRE ASSISTANT

npx @likyly/wizard mcp add

Écrit la configuration MCP de Claude Code, Cursor ou VS Code, sans y inscrire de clé.

Un prompt pour préparer l’intégration complète

À utiliser dans un assistant ayant accès au code de votre site.

PROMPT

Intègre Likyly à ce projet en te basant sur sa documentation actuelle.
1. Identifie la stack du site et la source du catalogue. Montre les champs à mapper et les identifiants utilisés.
2. Vérifie le SDK disponible et les opérations réellement autorisées. Prépare l’import via l’API côté serveur ou un CSV conforme. Avec le serveur MCP, passe par une source de données (create_data_source puis sync_data_source), seulement si la clé MCP a le droit sources:write.
3. Configure les clés au bon endroit : clé secrète ou clé MCP uniquement côté serveur, clé publique pour le navigateur. Ne les affiche pas dans les journaux.
4. Ajoute un bloc de recommandations sur la page d’accueil, puis les emplacements adaptés au parcours de mon secteur.
5. Relie les événements documentés au bon identifiant de contenu, de session ou d’utilisateur. Pour la vidéo, utilise un événement personnalisé avec quantity en secondes regardées conformément à l’API ; les propriétés libres ne pondèrent pas le modèle.
6. Vérifie l’import d’un élément, la réponse du moteur et l’affichage (validate_integration). Détaille les données manquantes pour activer le collaboratif et les étapes de synchronisation.

Outils du serveur MCP et droits nécessaires →

04. Affichez les recommandations et reliez les interactions

Le SDK ou l’API renvoie la sélection ; votre interface l’affiche. Transmettez uniquement le contexte disponible : contenu de référence, session, utilisateur, emplacement, nombre de résultats.

POST /events/{event_type} accepte vues, achats et types personnalisés comme reservation ou watch. Le niveau de poids de chaque type se règle dans votre espace ; quantity multiplie ce poids dans l’entraînement. Les propriétés JSON libres sont conservées, mais le modèle ne les utilise pas comme signaux.

Sans historique : commencez avec la popularité ou la similarité de contenu. Avec un historique suffisant et un identifiant stable : le modèle collaboratif s’entraîne (à la demande, ou automatiquement après 50 nouvelles interactions pondérées, dans la limite quotidienne de votre forfait), puis le mode collaboratif ou hybride devient pertinent.

Cache et disponibilité

Votre site n’appelle pas Likyly à chaque page vue. Le SDK garde une réponse une heure pour le même visiteur et le même produit ; côté Likyly, la réponse pour un visiteur anonyme est gardée une heure par produit et partagée entre visiteurs. Le cache se vide tout seul quand le catalogue ou l’emplacement change. Pour le vider tout de suite :

VIDER LE CACHE

npx @likyly/wizard cache clear

Tous les emplacements, ou un seul : npx @likyly/wizard cache clear pdp-related. Utilise la clé MCP du projet ; scriptable en CI ou après un déploiement. Dans Claude Code : /likyly-clear-cache. Dans la console : bouton Vider le cache sur l’emplacement.

Le navigateur garde sa propre copie par onglet : ouvrez la page dans un nouvel onglet pour voir les nouvelles recommandations.

Si Likyly ne répond pas (panne, surcharge), le SDK cesse de l’appeler pendant 30 secondes : votre page affiche aussitôt son contenu de repli au lieu d’attendre. Réglage : option cache du client ({ ttlSeconds, pauseSeconds }, ou false pour la désactiver).

Plan Pro : sur une fiche produit, un visiteur anonyme voit les produits proches de celui affiché mêlés à ce qu’il a déjà regardé pendant sa visite. En Free, les recommandations anonymes suivent le produit affiché.

Exemples et référence TypeScript →

05. Vérifiez avant de généraliser

Le catalogue est reçu avec les bons identifiants et les bons attributs.
La requête renvoie des éléments existants, affichés correctement sur votre site.
Les interactions arrivent avec le bon contexte et sans clé secrète exposée.
Le parcours fonctionne aussi pour un nouveau visiteur sans historique.
La stratégie collaborative utilise un modèle entraîné sur les interactions attendues.

Le contrôle d’intégration se fait par GET /placements/{slug}/health : appels, impressions, clics et autres événements reçus, avec des états ok / warning / missing.

Aucun délai d’installation universel n’est promis : il dépend du catalogue, de la stack et du suivi déjà en place.

Revenir aux parcours →

Votre première recommandation.Un chemin clair pour y arriver.