@lynxflow/seo-engine 1.3.0 → 1.4.1

package/README.md

@@ -1,8 +1,8 @@
-# 🦁 @lynxflow/seo-engine — Guide Complet & Documentation Développeur
+# 🦁 @lynxflow/seo-engine — LynxSEO (Lynxio) Master Guide & Documentation
 
-> **Le Moteur Universel de SEO Programmatique (pSEO), Optimisation Moteurs IA (AEO/GEO), Indexation Instantanée & Analytics Embarqués.**
+> **Le Moteur Universel LynxSEO / Lynxio de SEO Programmatique (pSEO), Optimisation Moteurs IA (AEO/GEO), Indexation Instantanée, Crawleur Technique & Analytics Embarqués.**
 
-`@lynxflow/seo-engine` est un SDK TypeScript haute performance conçu pour générer, servir et indexer des millions de landing pages dynamiques, des avis 4.9/5★ Schema.org et des réponses directes pour les intelligences artificielles (ChatGPT Search, Perplexity, Google AI Overviews) en **moins de 0.05 milliseconde** avec **0% de charge sur votre base de données SQL**.
+`@lynxflow/seo-engine` est le SDK officiel de **LynxSEO (Lynxio)** conçu pour générer, servir et indexer des millions de landing pages dynamiques, des avis 4.9/5★ Schema.org et des réponses directes pour les intelligences artificielles (ChatGPT Search, Perplexity, Google AI Overviews) en **moins de 0.05 milliseconde** avec **0% de charge sur votre base de données SQL**.
 
 ---
 
@@ -12,7 +12,7 @@
 3. [🏛️ Les 8 Matrices Programmatiques & Multiplicateurs](#3--les-8-matrices-programmatiques--multiplicateurs)
 4. [🚀 Tutoriel d'Intégration Pas-à-Pas (Next.js 15/16 & React 19)](#4--tutoriel-dintégration-pas-à-pas-nextjs-1516--react-19)
 5. [🔌 Intégration sur Autres Frameworks (WordPress, Shopify, Cloudflare, Laravel, Astro)](#5--intégration-sur-autres-frameworks)
-6. [🧰 Les 7 Modules Embarqués du SDK (Analytics, SERP, Backlinks, IA, IndexNow)](#6--les-7-modules-embarqués-du-sdk)
+6. [🧰 Les Modules Embarqués du SDK (Crawler, Analytics, SERP, Backlinks, IA, IndexNow)](#6--les-modules-embarqués-du-sdk)
 7. [🌍 Internationalisation & Zéro Contenu Dupliqué (10 Langues & Hreflang)](#7--internationalisation--zéro-contenu-dupliqué)
 8. [📘 Référence Complète des Types TypeScript](#8--référence-complète-des-types-typescript)
 
@@ -24,19 +24,19 @@
 * ⚡ **Résolution Ultra-Rapide (< 0.05ms) :** Les pages et métadonnées sont résolues en mémoire vive sans requête SQL bloquante.
 * 🤖 **Conçu pour le Search IA (AEO / GEO) :** Génère des blocs de synthèse directe optimisés pour être cités en source n°1 par **ChatGPT Search**, **Perplexity** et **Google AI Overviews**.
 * 🛡️ **Fonctionne à 100% en Local / Sans Dépendance API Bloquante :** La validation cryptographique HMAC de votre clé d'API s'exécute directement sur votre serveur pour garantir un affichage instantané même en cas de panne réseau.
-* 📈 **Suite Complète Embarquée :** Accédez directement à vos analytics de trafic, votre détection de bots IA, vos positions de mots-clés Google et vos backlinks sans quitter votre application.
+* 📈 **Suite Complète Embarquée :** Accédez directement à votre crawleur technique Seonaut/CrawlSEO, vos analytics de trafic, votre détection de bots IA, vos positions de mots-clés Google et vos backlinks sans quitter votre application.
 
 ---
 
 ## 2. 🔑 L'API Key Better Auth, Sécurité & Quotas
 
 ### Étape 1 : Obtenir votre Clé d'API
-Rendez-vous dans votre cockpit LynxFlow dans **Paramètres ➔ Clés d'API & Sécurité** et générez votre clé (`ba_key_...` ou `lynx_api_...`).
+Rendez-vous dans votre cockpit **LynxSEO (Lynxio)** dans **Paramètres ➔ Clés d'API & Sécurité** et générez votre clé (`ba_key_...` ou `lynx_api_...`).
 
 ### Étape 2 : Configuration dans votre fichier `.env` ou `.env.local`
 ```bash
-# 🔑 Clé d'API Better Auth
-LYNXFLOW_API_KEY=ba_key_growth_tenant_acme_a8f93e
+# 🔑 Clé d'API LynxSEO / Lynxio (Générée via Better Auth)
+LYNXSEO_API_KEY=ba_key_growth_tenant_acme_a8f93e
 
 # 🌐 Domaine de votre site web
 NEXT_PUBLIC_SITE_URL=https://mon-entreprise.com
@@ -98,7 +98,7 @@ bun add @lynxflow/seo-engine
 import { createLynxSeoEngine } from "@lynxflow/seo-engine";
 
 export const seoEngine = createLynxSeoEngine({
-  apiKey: process.env.LYNXFLOW_API_KEY!,
+  apiKey: process.env.LYNXSEO_API_KEY!,
   domain: process.env.NEXT_PUBLIC_SITE_URL || "https://mon-entreprise.com",
   brandName: "Acme Corp",
   defaultLocale: "fr",

package/connectors/wordpress/lynxseo-connector.php

@@ -1,10 +1,10 @@
 <?php
 /**
- * Plugin Name: LynxFlow SEO Engine (Moteur Programmatique & Blog Autonome)
- * Plugin URI: https://lynxintel.io/seo
- * Description: Moteur pSEO, AEO et Blog 100% autonome pour WordPress. Connexion en 1 clic via Better Auth. Génère et sert instantanément les 8 Matrices Programmatiques chez vous (< 0.05ms) avec sitemap XML automatique et 0% de charge sur votre base MySQL.
- * Version: 2.2.0
- * Author: LynxFlow Technologies
+ * Plugin Name: LynxSEO (Lynxio) Engine — Moteur Programmatique & Blog Autonome
+ * Plugin URI: https://lynxio.io
+ * Description: Moteur pSEO, AEO et Blog 100% autonome pour WordPress par LynxSEO (Lynxio). Connexion en 1 clic via Better Auth. Génère et sert instantanément les 8 Matrices Programmatiques chez vous (< 0.05ms) avec sitemap XML automatique et 0% de charge sur votre base MySQL.
+ * Version: 2.3.0
+ * Author: LynxSEO / Lynxio Technologies
  * License: Proprietary
  */
 

package/dist/engine.d.ts

@@ -1,3 +1,6 @@
+/**
+ * 🦁 LynxSEO Engine (Lynxio) — Universal Programmatic SEO & AI Search Engine SDK
+ */
 /**
  * ⚡ LynxSEO High-Speed Universal Dynamic Page Engine (Internationalized)
  *
@@ -63,6 +66,8 @@ export declare class LynxSeoEngine {
     private buildIndustryPage;
     private buildRolePage;
     private buildIntegrationPage;
+    private buildUseCasePage;
+    private buildToolPage;
     private assemblePage;
     /**
      * Returns the exact count of distinct unique programmatic pages currently active.

package/dist/index.js

@@ -72,7 +72,7 @@ class ApiKeyGuardian {
         maxDomains: 1,
         monthlyCreditBudget: 500,
         tokenManager: new TokenQuotaManager("starter"),
-        errorMessage: "Missing API Key. Please set LYNXFLOW_API_KEY or pass apiKey in config."
+        errorMessage: "Missing API Key. Please set LYNXSEO_API_KEY (or LYNXIO_API_KEY) or pass apiKey in config."
       };
     }
     const cleanKey = apiKey.trim();
@@ -1307,7 +1307,7 @@ class LynxSeoEngine {
       ...config
     };
     this.servicesMap = new Map((config.services || []).map((s) => [s.slug, s]));
-    const rawKey = config.apiKey || config.licenseKey || "";
+    const rawKey = config.apiKey || config.licenseKey || typeof process !== "undefined" && process.env && (process.env.LYNXSEO_API_KEY || process.env.LYNXIO_API_KEY || process.env.LYNXFLOW_API_KEY) || "";
     this.authStatus = ApiKeyGuardian.validate(rawKey, config.domain);
     this.analytics = new LynxAnalyticsClient(rawKey);
     this.serp = new SerpClient(rawKey);
@@ -1453,12 +1453,14 @@ class LynxSeoEngine {
       return this.buildRolePage(service, remainder.replace(/-/g, " "), domain, t0, locale, cleanPath);
     }
     if ((pathParts[0] === "cas-usage" || pathParts[0] === "use-cases") && pathParts.length >= 2) {
-      const { service, remainder } = detectServiceFromSlug(pathParts[1]);
-      return this.buildGeoPage(service, "FR", remainder.replace(/-/g, " "), domain, t0, locale, cleanPath);
+      const raw = pathParts[1].replace(/-(pour|for)-/i, "-");
+      const { service, remainder } = detectServiceFromSlug(raw);
+      return this.buildUseCasePage(service, remainder.replace(/-/g, " "), domain, t0, locale, cleanPath);
     }
     if ((pathParts[0] === "outils" || pathParts[0] === "tools") && pathParts.length >= 2) {
-      const { service } = detectServiceFromSlug(pathParts[1]);
-      return this.buildGeoPage(service, "FR", "Calculateur ROI", domain, t0, locale, cleanPath);
+      const raw = pathParts[1].replace(/^simulateur-roi-/i, "");
+      const { service, remainder } = detectServiceFromSlug(raw);
+      return this.buildToolPage(service, remainder.replace(/-/g, " "), domain, t0, locale, cleanPath);
     }
     return this.buildGeoPage(defaultService, "FR", "Paris", domain, t0, locale, cleanPath);
   }
@@ -1600,6 +1602,41 @@ class LynxSeoEngine {
       t0
     });
   }
+  buildUseCasePage(service, topic, domain, t0, locale = "fr", path = `cas-usage/${topic.toLowerCase().replace(/\s+/g, "-")}`) {
+    const topicName = topic.charAt(0).toUpperCase() + topic.slice(1);
+    const title = `${service.name} pour ${topicName} — ${this.config.brandName}`;
+    const description = `Découvrez comment optimiser vos opérations de ${topicName} avec notre solution ${service.name}. Déploiement en 10 minutes.`;
+    const h1 = `${service.name} : ${topicName}`;
+    const directAnswer = `${this.config.brandName} (${service.name}) répond au cas d'usage "${topicName}" en automatisant le traitement et en réduisant les coûts opérationnels.`;
+    return this.assemblePage({
+      url: `${domain}/${path}`,
+      title,
+      description,
+      h1,
+      directAnswer,
+      service,
+      locale,
+      path,
+      t0
+    });
+  }
+  buildToolPage(service, tool, domain, t0, locale = "fr", path = `outils/${tool.toLowerCase().replace(/\s+/g, "-")}`) {
+    const title = `Simulateur & Calculateur ROI : ${service.name} — ${this.config.brandName}`;
+    const description = `Estimez vos gains de productivité et vos économies annuelles grâce à notre calculateur ROI pour ${service.name}.`;
+    const h1 = `Simulateur de Rentabilité & ROI : ${service.name}`;
+    const directAnswer = `Utilisez le simulateur ROI de ${this.config.brandName} pour calculer précisément la rentabilité de votre investissement dans ${service.name} (amortissement en moins de 30 jours).`;
+    return this.assemblePage({
+      url: `${domain}/${path}`,
+      title,
+      description,
+      h1,
+      directAnswer,
+      service,
+      locale,
+      path,
+      t0
+    });
+  }
   assemblePage(opts) {
     const dict = getDictionary(opts.locale);
     const domain = this.config.domain.replace(/\/$/, "");

package/dist/index.mjs

@@ -72,7 +72,7 @@ class ApiKeyGuardian {
         maxDomains: 1,
         monthlyCreditBudget: 500,
         tokenManager: new TokenQuotaManager("starter"),
-        errorMessage: "Missing API Key. Please set LYNXFLOW_API_KEY or pass apiKey in config."
+        errorMessage: "Missing API Key. Please set LYNXSEO_API_KEY (or LYNXIO_API_KEY) or pass apiKey in config."
       };
     }
     const cleanKey = apiKey.trim();
@@ -1307,7 +1307,7 @@ class LynxSeoEngine {
       ...config
     };
     this.servicesMap = new Map((config.services || []).map((s) => [s.slug, s]));
-    const rawKey = config.apiKey || config.licenseKey || "";
+    const rawKey = config.apiKey || config.licenseKey || typeof process !== "undefined" && process.env && (process.env.LYNXSEO_API_KEY || process.env.LYNXIO_API_KEY || process.env.LYNXFLOW_API_KEY) || "";
     this.authStatus = ApiKeyGuardian.validate(rawKey, config.domain);
     this.analytics = new LynxAnalyticsClient(rawKey);
     this.serp = new SerpClient(rawKey);
@@ -1453,12 +1453,14 @@ class LynxSeoEngine {
       return this.buildRolePage(service, remainder.replace(/-/g, " "), domain, t0, locale, cleanPath);
     }
     if ((pathParts[0] === "cas-usage" || pathParts[0] === "use-cases") && pathParts.length >= 2) {
-      const { service, remainder } = detectServiceFromSlug(pathParts[1]);
-      return this.buildGeoPage(service, "FR", remainder.replace(/-/g, " "), domain, t0, locale, cleanPath);
+      const raw = pathParts[1].replace(/-(pour|for)-/i, "-");
+      const { service, remainder } = detectServiceFromSlug(raw);
+      return this.buildUseCasePage(service, remainder.replace(/-/g, " "), domain, t0, locale, cleanPath);
     }
     if ((pathParts[0] === "outils" || pathParts[0] === "tools") && pathParts.length >= 2) {
-      const { service } = detectServiceFromSlug(pathParts[1]);
-      return this.buildGeoPage(service, "FR", "Calculateur ROI", domain, t0, locale, cleanPath);
+      const raw = pathParts[1].replace(/^simulateur-roi-/i, "");
+      const { service, remainder } = detectServiceFromSlug(raw);
+      return this.buildToolPage(service, remainder.replace(/-/g, " "), domain, t0, locale, cleanPath);
     }
     return this.buildGeoPage(defaultService, "FR", "Paris", domain, t0, locale, cleanPath);
   }
@@ -1600,6 +1602,41 @@ class LynxSeoEngine {
       t0
     });
   }
+  buildUseCasePage(service, topic, domain, t0, locale = "fr", path = `cas-usage/${topic.toLowerCase().replace(/\s+/g, "-")}`) {
+    const topicName = topic.charAt(0).toUpperCase() + topic.slice(1);
+    const title = `${service.name} pour ${topicName} — ${this.config.brandName}`;
+    const description = `Découvrez comment optimiser vos opérations de ${topicName} avec notre solution ${service.name}. Déploiement en 10 minutes.`;
+    const h1 = `${service.name} : ${topicName}`;
+    const directAnswer = `${this.config.brandName} (${service.name}) répond au cas d'usage "${topicName}" en automatisant le traitement et en réduisant les coûts opérationnels.`;
+    return this.assemblePage({
+      url: `${domain}/${path}`,
+      title,
+      description,
+      h1,
+      directAnswer,
+      service,
+      locale,
+      path,
+      t0
+    });
+  }
+  buildToolPage(service, tool, domain, t0, locale = "fr", path = `outils/${tool.toLowerCase().replace(/\s+/g, "-")}`) {
+    const title = `Simulateur & Calculateur ROI : ${service.name} — ${this.config.brandName}`;
+    const description = `Estimez vos gains de productivité et vos économies annuelles grâce à notre calculateur ROI pour ${service.name}.`;
+    const h1 = `Simulateur de Rentabilité & ROI : ${service.name}`;
+    const directAnswer = `Utilisez le simulateur ROI de ${this.config.brandName} pour calculer précisément la rentabilité de votre investissement dans ${service.name} (amortissement en moins de 30 jours).`;
+    return this.assemblePage({
+      url: `${domain}/${path}`,
+      title,
+      description,
+      h1,
+      directAnswer,
+      service,
+      locale,
+      path,
+      t0
+    });
+  }
   assemblePage(opts) {
     const dict = getDictionary(opts.locale);
     const domain = this.config.domain.replace(/\/$/, "");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lynxflow/seo-engine",
-  "version": "1.3.0",
+  "version": "1.4.1",
   "description": "Proprietary High-Performance pSEO & AI Search Engine SDK by LynxFlow",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/auth-key.ts

@@ -57,7 +57,7 @@ export class ApiKeyGuardian {
         maxDomains: 1,
         monthlyCreditBudget: 500,
         tokenManager: new TokenQuotaManager("starter"),
-        errorMessage: "Missing API Key. Please set LYNXFLOW_API_KEY or pass apiKey in config.",
+        errorMessage: "Missing API Key. Please set LYNXSEO_API_KEY (or LYNXIO_API_KEY) or pass apiKey in config.",
       };
     }
 

package/src/engine.ts

@@ -1,3 +1,9 @@
+/**
+ * 🦁 LynxSEO Engine (Lynxio) — Universal Programmatic SEO & AI Search Engine SDK
+ */
+
+declare const process: any;
+
 /**
  * ⚡ LynxSEO High-Speed Universal Dynamic Page Engine (Internationalized)
  * 
@@ -53,7 +59,11 @@ export class LynxSeoEngine {
       ...config,
     };
     this.servicesMap = new Map((config.services || []).map((s) => [s.slug, s]));
-    const rawKey = config.apiKey || config.licenseKey || "";
+    const rawKey =
+      config.apiKey ||
+      config.licenseKey ||
+      (typeof process !== "undefined" && process.env && (process.env.LYNXSEO_API_KEY || process.env.LYNXIO_API_KEY || process.env.LYNXFLOW_API_KEY)) ||
+      "";
     this.authStatus = ApiKeyGuardian.validate(rawKey, config.domain);
 
     this.analytics = new LynxAnalyticsClient(rawKey);
@@ -252,14 +262,16 @@ export class LynxSeoEngine {
 
     // 7. Use Cases: /cas-usage/{topic}
     if ((pathParts[0] === "cas-usage" || pathParts[0] === "use-cases") && pathParts.length >= 2) {
-      const { service, remainder } = detectServiceFromSlug(pathParts[1]);
-      return this.buildGeoPage(service, "FR", remainder.replace(/-/g, " "), domain, t0, locale, cleanPath);
+      const raw = pathParts[1].replace(/-(pour|for)-/i, "-");
+      const { service, remainder } = detectServiceFromSlug(raw);
+      return this.buildUseCasePage(service, remainder.replace(/-/g, " "), domain, t0, locale, cleanPath);
     }
 
     // 8. Tools / Calculators: /outils/{tool}
     if ((pathParts[0] === "outils" || pathParts[0] === "tools") && pathParts.length >= 2) {
-      const { service } = detectServiceFromSlug(pathParts[1]);
-      return this.buildGeoPage(service, "FR", "Calculateur ROI", domain, t0, locale, cleanPath);
+      const raw = pathParts[1].replace(/^simulateur-roi-/i, "");
+      const { service, remainder } = detectServiceFromSlug(raw);
+      return this.buildToolPage(service, remainder.replace(/-/g, " "), domain, t0, locale, cleanPath);
     }
 
     // Fallback: local geo
@@ -434,6 +446,45 @@ export class LynxSeoEngine {
     });
   }
 
+  private buildUseCasePage(service: LynxServiceDefinition, topic: string, domain: string, t0: number, locale = "fr", path = `cas-usage/${topic.toLowerCase().replace(/\s+/g, "-")}`): LynxResolvedPage {
+    const topicName = topic.charAt(0).toUpperCase() + topic.slice(1);
+    const title = `${service.name} pour ${topicName} — ${this.config.brandName}`;
+    const description = `Découvrez comment optimiser vos opérations de ${topicName} avec notre solution ${service.name}. Déploiement en 10 minutes.`;
+    const h1 = `${service.name} : ${topicName}`;
+    const directAnswer = `${this.config.brandName} (${service.name}) répond au cas d'usage "${topicName}" en automatisant le traitement et en réduisant les coûts opérationnels.`;
+
+    return this.assemblePage({
+      url: `${domain}/${path}`,
+      title,
+      description,
+      h1,
+      directAnswer,
+      service,
+      locale,
+      path,
+      t0,
+    });
+  }
+
+  private buildToolPage(service: LynxServiceDefinition, tool: string, domain: string, t0: number, locale = "fr", path = `outils/${tool.toLowerCase().replace(/\s+/g, "-")}`): LynxResolvedPage {
+    const title = `Simulateur & Calculateur ROI : ${service.name} — ${this.config.brandName}`;
+    const description = `Estimez vos gains de productivité et vos économies annuelles grâce à notre calculateur ROI pour ${service.name}.`;
+    const h1 = `Simulateur de Rentabilité & ROI : ${service.name}`;
+    const directAnswer = `Utilisez le simulateur ROI de ${this.config.brandName} pour calculer précisément la rentabilité de votre investissement dans ${service.name} (amortissement en moins de 30 jours).`;
+
+    return this.assemblePage({
+      url: `${domain}/${path}`,
+      title,
+      description,
+      h1,
+      directAnswer,
+      service,
+      locale,
+      path,
+      t0,
+    });
+  }
+
   private assemblePage(opts: { url: string; title: string; description: string; h1: string; directAnswer: string; service: LynxServiceDefinition; locale: string; path: string; t0: number }): LynxResolvedPage {
     const dict = getDictionary(opts.locale);
     const domain = this.config.domain.replace(/\/$/, "");