@lynxflow/seo-engine 1.8.1 → 1.8.2

package/dist/index.d.ts

@@ -64,6 +64,7 @@ export * from "./team-rbac";
 export * from "./real-reviews-sync";
 export * from "./google-business-profile";
 export * from "./video-youtube-analyzer";
+export * from "./power-words-psychology";
 import { LynxSeoEngine, type EngineConfig } from "./engine";
 import { ApiKeyGuardian } from "./auth-key";
 import { TokenQuotaManager } from "./token-quota-manager";

package/dist/index.js

@@ -71,12 +71,14 @@ __export(exports_src, {
   RealReviewsSyncEngine: () => RealReviewsSyncEngine,
   RankMathParityEngine: () => RankMathParityEngine,
   PseoMatrixEngine: () => PseoMatrixEngine,
+  PowerWordsPsychologyEngine: () => PowerWordsPsychologyEngine,
   PSEO_AGENT_SYSTEM_PROMPT: () => PSEO_AGENT_SYSTEM_PROMPT,
   OgImageGenerator: () => OgImageGenerator,
   NGramDensityAnalyzer: () => NGramDensityAnalyzer,
   McpSeoServerHub: () => McpSeoServerHub,
   MasterMarketingEngine: () => MasterMarketingEngine,
   MULTILINGUAL_STOP_WORDS: () => MULTILINGUAL_STOP_WORDS,
+  MULTILINGUAL_POWER_WORDS: () => MULTILINGUAL_POWER_WORDS,
   MULTILINGUAL_DISCLAIMERS: () => MULTILINGUAL_DISCLAIMERS,
   MULTILINGUAL_BANNED_DISPARAGING_WORDS: () => MULTILINGUAL_BANNED_DISPARAGING_WORDS,
   LynxSeoEngine: () => LynxSeoEngine,
@@ -7346,6 +7348,354 @@ class VideoYouTubeAnalyzer {
     `.trim();
   }
 }
+// src/power-words-psychology.ts
+var MULTILINGUAL_POWER_WORDS = {
+  fr: {
+    authority: [
+      "officiel",
+      "guide",
+      "expert",
+      "complet",
+      "certifié",
+      "ultime",
+      "meilleur",
+      "meilleurs",
+      "comparatif",
+      "maîtriser",
+      "spécialiste",
+      "leader",
+      "professionnel",
+      "authentique",
+      "infaillible",
+      "reconnu",
+      "démontré"
+    ],
+    urgency: [
+      "rapide",
+      "instantané",
+      "maintenant",
+      "immédiat",
+      "express",
+      "2026",
+      "dernière minute",
+      "urgent",
+      "dépêchez-vous",
+      "en 5 min",
+      "en 10 min",
+      "aujourd'hui",
+      "débloquer"
+    ],
+    value: [
+      "gratuit",
+      "économique",
+      "rentable",
+      "offert",
+      "sans engagement",
+      "garanti",
+      "facile",
+      "clé en main",
+      "rentabilité",
+      "gain",
+      "économisez",
+      "inclus",
+      "accessible",
+      "inédit"
+    ],
+    curiosity: [
+      "exclusif",
+      "secret",
+      "astuces",
+      "révélé",
+      "inédit",
+      "top",
+      "méthode",
+      "pourquoi",
+      "comment",
+      "découvrir",
+      "choc",
+      "incontournable",
+      "mystère",
+      "incroyable"
+    ],
+    sentimentPositive: [
+      "parfait",
+      "incroyable",
+      "magnifique",
+      "puissant",
+      "réussi",
+      "génial",
+      "exceptionnel",
+      "facile",
+      "meilleur",
+      "succès",
+      "brillant",
+      "splendide",
+      "radieux",
+      "magique",
+      "sublime"
+    ],
+    sentimentNegative: [
+      "erreur",
+      "piège",
+      "danger",
+      "éviter",
+      "pire",
+      "arnaque",
+      "catastrophe",
+      "risqué",
+      "menace",
+      "perte"
+    ]
+  },
+  en: {
+    authority: [
+      "ultimate",
+      "complete",
+      "definitive",
+      "guide",
+      "expert",
+      "official",
+      "proven",
+      "master",
+      "certified",
+      "best",
+      "top",
+      "authority",
+      "case study",
+      "benchmark",
+      "professional"
+    ],
+    urgency: [
+      "instant",
+      "fast",
+      "quick",
+      "now",
+      "today",
+      "2026",
+      "deadline",
+      "last chance",
+      "step-by-step",
+      "overnight",
+      "rapid",
+      "minutes"
+    ],
+    value: [
+      "free",
+      "affordable",
+      "guaranteed",
+      "save",
+      "profit",
+      "profitable",
+      "bonus",
+      "cheap",
+      "priceless",
+      "effortless",
+      "lifetime",
+      "budget"
+    ],
+    curiosity: [
+      "secret",
+      "secrets",
+      "exclusive",
+      "revealed",
+      "hacks",
+      "tricks",
+      "hacks",
+      "behind the scenes",
+      "uncovered",
+      "surprising",
+      "insider",
+      "confidential",
+      "jaw-dropping"
+    ],
+    sentimentPositive: [
+      "amazing",
+      "awesome",
+      "brilliant",
+      "epic",
+      "legendary",
+      "superb",
+      "stunning",
+      "perfect",
+      "powerful",
+      "triumph",
+      "miracle",
+      "flawless"
+    ],
+    sentimentNegative: [
+      "mistake",
+      "warning",
+      "deadly",
+      "worst",
+      "danger",
+      "toxic",
+      "destroy",
+      "ruin",
+      "scam",
+      "nightmare"
+    ]
+  },
+  es: {
+    authority: ["guía", "completo", "definitivo", "experto", "oficial", "mejor", "mejores", "certificado", "profesional", "maestro"],
+    urgency: ["rápido", "ahora", "inmediato", "2026", "hoy", "urgente", "en minutos", "paso a paso"],
+    value: ["gratis", "gratuito", "económico", "garantizado", "ahorra", "rentable", "oferta", "sin riesgo"],
+    curiosity: ["secreto", "exclusivo", "revelado", "trucos", "increíble", "top", "método", "descubre"],
+    sentimentPositive: ["increíble", "fantástico", "perfecto", "excelente", "maravilloso", "potente", "éxito"],
+    sentimentNegative: ["error", "peligro", "evitar", "peor", "estafa", "trampa", "arruinar"]
+  },
+  de: {
+    authority: ["leitfaden", "komplett", "experte", "offiziell", "beste", "bester", "zertifiziert", "vergleich", "meister"],
+    urgency: ["schnell", "jetzt", "sofort", "2026", "heute", "schritt-für-schritt", "in 5 minuten"],
+    value: ["kostenlos", "gratis", "sparen", "garantiert", "günstig", "rendite", "ohne risiko"],
+    curiosity: ["geheim", "exklusiv", "tipps", "tricks", "enthüllt", "top", "warum", "entdecken"],
+    sentimentPositive: ["perfekt", "genial", "hervorragend", "leistungsstark", "erfolg", "wunderbar"],
+    sentimentNegative: ["fehler", "gefahr", "vermeiden", "schlimmste", "falle", "risiko"]
+  },
+  it: {
+    authority: ["guida", "completa", "esperto", "ufficiale", "migliore", "migliori", "certificato", "professionale"],
+    urgency: ["veloce", "ora", "subito", "2026", "oggi", "passo dopo passo", "in pochi minuti"],
+    value: ["gratis", "gratuito", "economico", "garantito", "risparmio", "conveniente", "senza rischi"],
+    curiosity: ["segreto", "esclusivo", "trucchi", "rivelato", "top", "metodo", "scopri"],
+    sentimentPositive: ["perfetto", "fantastico", "eccellente", "potente", "successo", "incredibile"],
+    sentimentNegative: ["errore", "pericolo", "evitare", "peggiore", "truffa", "trappola"]
+  },
+  nl: {
+    authority: ["gids", "compleet", "expert", "officieel", "beste", "gecertificeerd", "professioneel"],
+    urgency: ["snel", "nu", "direct", "2026", "vandaag", "stap voor stap"],
+    value: ["gratis", "goedkoop", "gegarandeerd", "bespaar", "rendement", "zonder risico"],
+    curiosity: ["geheim", "exclusief", "tips", "onthuld", "top", "ontdek"],
+    sentimentPositive: ["perfect", "geweldig", "uitstekend", "krachtig", "succes"],
+    sentimentNegative: ["fout", "gevaar", "vermijden", "slechtste", "valkuil"]
+  },
+  pt: {
+    authority: ["guia", "completo", "definitivo", "especialista", "oficial", "melhor", "melhores", "certificado"],
+    urgency: ["rápido", "agora", "imediato", "2026", "hoje", "passo a passo"],
+    value: ["grátis", "gratuito", "econômico", "garantido", "economize", "sem risco"],
+    curiosity: ["segredo", "exclusivo", "revelado", "truques", "top", "descubra"],
+    sentimentPositive: ["incrível", "perfeito", "excelente", "poderoso", "sucesso"],
+    sentimentNegative: ["erro", "perigo", "evitar", "pior", "golpe"]
+  }
+};
+
+class PowerWordsPsychologyEngine {
+  static analyzeTitlePsychology(title, lang = "fr") {
+    const cleanTitle = title.toLowerCase();
+    const dict = MULTILINGUAL_POWER_WORDS[lang] || MULTILINGUAL_POWER_WORDS.fr;
+    const detectedPowerWords = [];
+    let score = 30;
+    const hasAuthority = dict.authority.some((w) => {
+      if (cleanTitle.includes(w)) {
+        detectedPowerWords.push(w);
+        return true;
+      }
+      return false;
+    });
+    if (hasAuthority)
+      score += 20;
+    const hasUrgency = dict.urgency.some((w) => {
+      if (cleanTitle.includes(w)) {
+        detectedPowerWords.push(w);
+        return true;
+      }
+      return false;
+    });
+    if (hasUrgency)
+      score += 15;
+    const hasValue = dict.value.some((w) => {
+      if (cleanTitle.includes(w)) {
+        detectedPowerWords.push(w);
+        return true;
+      }
+      return false;
+    });
+    if (hasValue)
+      score += 15;
+    const hasCuriosity = dict.curiosity.some((w) => {
+      if (cleanTitle.includes(w)) {
+        detectedPowerWords.push(w);
+        return true;
+      }
+      return false;
+    });
+    if (hasCuriosity)
+      score += 10;
+    const hasNumber = /\d+/.test(title);
+    if (hasNumber)
+      score += 10;
+    const currentYear = new Date().getFullYear().toString();
+    const hasYear = title.includes(currentYear) || title.includes("2026");
+    let sentiment = "neutre";
+    const hasPositive = dict.sentimentPositive.some((w) => cleanTitle.includes(w));
+    const hasNegative = dict.sentimentNegative.some((w) => cleanTitle.includes(w));
+    if (hasPositive) {
+      sentiment = "positif";
+    } else if (hasNegative) {
+      sentiment = "negatif";
+    }
+    const recommendations = [];
+    if (!detectedPowerWords.length) {
+      recommendations.push("Ajoutez au moins un mot d'impact (*Power Word*) comme 'Guide Complet', 'Meilleur' ou 'Ultime'.");
+    }
+    if (!hasNumber) {
+      recommendations.push("Intégrez un chiffre ou l'année en cours (ex: '7 astuces', '2026') pour booster le taux de clic de +36%.");
+    }
+    if (title.length < 35) {
+      recommendations.push("Titre trop court : enrichissez votre promesse de valeur pour occuper les 600px de la SERP Google.");
+    }
+    const suggestedTitles = [];
+    if (lang === "fr") {
+      suggestedTitles.push(`${title} : Guide Ultime 2026`);
+      suggestedTitles.push(`Les 5 Meilleurs ${title} (Comparatif & Avis)`);
+      suggestedTitles.push(`${title} — Solution Rapide & Complète`);
+    } else {
+      suggestedTitles.push(`${title}: The Ultimate 2026 Guide`);
+      suggestedTitles.push(`Top 5 Best ${title} (Full Review & Comparison)`);
+      suggestedTitles.push(`${title} — Proven & Fast Method`);
+    }
+    return {
+      score: Math.min(100, score),
+      powerWordsDetected: Array.from(new Set(detectedPowerWords)),
+      sentiment,
+      hasNumber,
+      hasYear,
+      hasCuriosityTrigger: hasCuriosity,
+      hasUrgencyTrigger: hasUrgency,
+      hasAuthorityTrigger: hasAuthority,
+      recommendations,
+      suggestedTitles
+    };
+  }
+  static enrichProgrammaticTitle(service, locationOrCompetitor, type = "geo", lang = "fr") {
+    const year = "2026";
+    if (lang === "fr") {
+      if (type === "geo") {
+        return `Meilleur ${service} à ${locationOrCompetitor} : Guide Complet ${year}`;
+      } else if (type === "vs") {
+        return `${service} vs ${locationOrCompetitor} : Le Comparatif Ultime & Avis`;
+      } else {
+        return `Top 5 Alternatives à ${locationOrCompetitor} : Comparatif ${year}`;
+      }
+    } else if (lang === "en") {
+      if (type === "geo") {
+        return `Best ${service} in ${locationOrCompetitor}: Ultimate ${year} Guide`;
+      } else if (type === "vs") {
+        return `${service} vs ${locationOrCompetitor}: Definitive Comparison`;
+      } else {
+        return `Top 5 Alternatives to ${locationOrCompetitor} (${year} Review)`;
+      }
+    } else if (lang === "es") {
+      if (type === "geo") {
+        return `Mejor ${service} en ${locationOrCompetitor}: Guía Completa ${year}`;
+      } else {
+        return `${service} vs ${locationOrCompetitor}: Comparativa Definitiva`;
+      }
+    } else if (lang === "de") {
+      return `Beste ${service} in ${locationOrCompetitor}: Kompletter Leitfaden ${year}`;
+    } else {
+      return `${service} in ${locationOrCompetitor} (${year})`;
+    }
+  }
+}
 // src/index.ts
 function createLynxSeoEngine(config) {
   return new LynxSeoEngine(config);

package/dist/index.mjs

@@ -7232,6 +7232,354 @@ class VideoYouTubeAnalyzer {
     `.trim();
   }
 }
+// src/power-words-psychology.ts
+var MULTILINGUAL_POWER_WORDS = {
+  fr: {
+    authority: [
+      "officiel",
+      "guide",
+      "expert",
+      "complet",
+      "certifié",
+      "ultime",
+      "meilleur",
+      "meilleurs",
+      "comparatif",
+      "maîtriser",
+      "spécialiste",
+      "leader",
+      "professionnel",
+      "authentique",
+      "infaillible",
+      "reconnu",
+      "démontré"
+    ],
+    urgency: [
+      "rapide",
+      "instantané",
+      "maintenant",
+      "immédiat",
+      "express",
+      "2026",
+      "dernière minute",
+      "urgent",
+      "dépêchez-vous",
+      "en 5 min",
+      "en 10 min",
+      "aujourd'hui",
+      "débloquer"
+    ],
+    value: [
+      "gratuit",
+      "économique",
+      "rentable",
+      "offert",
+      "sans engagement",
+      "garanti",
+      "facile",
+      "clé en main",
+      "rentabilité",
+      "gain",
+      "économisez",
+      "inclus",
+      "accessible",
+      "inédit"
+    ],
+    curiosity: [
+      "exclusif",
+      "secret",
+      "astuces",
+      "révélé",
+      "inédit",
+      "top",
+      "méthode",
+      "pourquoi",
+      "comment",
+      "découvrir",
+      "choc",
+      "incontournable",
+      "mystère",
+      "incroyable"
+    ],
+    sentimentPositive: [
+      "parfait",
+      "incroyable",
+      "magnifique",
+      "puissant",
+      "réussi",
+      "génial",
+      "exceptionnel",
+      "facile",
+      "meilleur",
+      "succès",
+      "brillant",
+      "splendide",
+      "radieux",
+      "magique",
+      "sublime"
+    ],
+    sentimentNegative: [
+      "erreur",
+      "piège",
+      "danger",
+      "éviter",
+      "pire",
+      "arnaque",
+      "catastrophe",
+      "risqué",
+      "menace",
+      "perte"
+    ]
+  },
+  en: {
+    authority: [
+      "ultimate",
+      "complete",
+      "definitive",
+      "guide",
+      "expert",
+      "official",
+      "proven",
+      "master",
+      "certified",
+      "best",
+      "top",
+      "authority",
+      "case study",
+      "benchmark",
+      "professional"
+    ],
+    urgency: [
+      "instant",
+      "fast",
+      "quick",
+      "now",
+      "today",
+      "2026",
+      "deadline",
+      "last chance",
+      "step-by-step",
+      "overnight",
+      "rapid",
+      "minutes"
+    ],
+    value: [
+      "free",
+      "affordable",
+      "guaranteed",
+      "save",
+      "profit",
+      "profitable",
+      "bonus",
+      "cheap",
+      "priceless",
+      "effortless",
+      "lifetime",
+      "budget"
+    ],
+    curiosity: [
+      "secret",
+      "secrets",
+      "exclusive",
+      "revealed",
+      "hacks",
+      "tricks",
+      "hacks",
+      "behind the scenes",
+      "uncovered",
+      "surprising",
+      "insider",
+      "confidential",
+      "jaw-dropping"
+    ],
+    sentimentPositive: [
+      "amazing",
+      "awesome",
+      "brilliant",
+      "epic",
+      "legendary",
+      "superb",
+      "stunning",
+      "perfect",
+      "powerful",
+      "triumph",
+      "miracle",
+      "flawless"
+    ],
+    sentimentNegative: [
+      "mistake",
+      "warning",
+      "deadly",
+      "worst",
+      "danger",
+      "toxic",
+      "destroy",
+      "ruin",
+      "scam",
+      "nightmare"
+    ]
+  },
+  es: {
+    authority: ["guía", "completo", "definitivo", "experto", "oficial", "mejor", "mejores", "certificado", "profesional", "maestro"],
+    urgency: ["rápido", "ahora", "inmediato", "2026", "hoy", "urgente", "en minutos", "paso a paso"],
+    value: ["gratis", "gratuito", "económico", "garantizado", "ahorra", "rentable", "oferta", "sin riesgo"],
+    curiosity: ["secreto", "exclusivo", "revelado", "trucos", "increíble", "top", "método", "descubre"],
+    sentimentPositive: ["increíble", "fantástico", "perfecto", "excelente", "maravilloso", "potente", "éxito"],
+    sentimentNegative: ["error", "peligro", "evitar", "peor", "estafa", "trampa", "arruinar"]
+  },
+  de: {
+    authority: ["leitfaden", "komplett", "experte", "offiziell", "beste", "bester", "zertifiziert", "vergleich", "meister"],
+    urgency: ["schnell", "jetzt", "sofort", "2026", "heute", "schritt-für-schritt", "in 5 minuten"],
+    value: ["kostenlos", "gratis", "sparen", "garantiert", "günstig", "rendite", "ohne risiko"],
+    curiosity: ["geheim", "exklusiv", "tipps", "tricks", "enthüllt", "top", "warum", "entdecken"],
+    sentimentPositive: ["perfekt", "genial", "hervorragend", "leistungsstark", "erfolg", "wunderbar"],
+    sentimentNegative: ["fehler", "gefahr", "vermeiden", "schlimmste", "falle", "risiko"]
+  },
+  it: {
+    authority: ["guida", "completa", "esperto", "ufficiale", "migliore", "migliori", "certificato", "professionale"],
+    urgency: ["veloce", "ora", "subito", "2026", "oggi", "passo dopo passo", "in pochi minuti"],
+    value: ["gratis", "gratuito", "economico", "garantito", "risparmio", "conveniente", "senza rischi"],
+    curiosity: ["segreto", "esclusivo", "trucchi", "rivelato", "top", "metodo", "scopri"],
+    sentimentPositive: ["perfetto", "fantastico", "eccellente", "potente", "successo", "incredibile"],
+    sentimentNegative: ["errore", "pericolo", "evitare", "peggiore", "truffa", "trappola"]
+  },
+  nl: {
+    authority: ["gids", "compleet", "expert", "officieel", "beste", "gecertificeerd", "professioneel"],
+    urgency: ["snel", "nu", "direct", "2026", "vandaag", "stap voor stap"],
+    value: ["gratis", "goedkoop", "gegarandeerd", "bespaar", "rendement", "zonder risico"],
+    curiosity: ["geheim", "exclusief", "tips", "onthuld", "top", "ontdek"],
+    sentimentPositive: ["perfect", "geweldig", "uitstekend", "krachtig", "succes"],
+    sentimentNegative: ["fout", "gevaar", "vermijden", "slechtste", "valkuil"]
+  },
+  pt: {
+    authority: ["guia", "completo", "definitivo", "especialista", "oficial", "melhor", "melhores", "certificado"],
+    urgency: ["rápido", "agora", "imediato", "2026", "hoje", "passo a passo"],
+    value: ["grátis", "gratuito", "econômico", "garantido", "economize", "sem risco"],
+    curiosity: ["segredo", "exclusivo", "revelado", "truques", "top", "descubra"],
+    sentimentPositive: ["incrível", "perfeito", "excelente", "poderoso", "sucesso"],
+    sentimentNegative: ["erro", "perigo", "evitar", "pior", "golpe"]
+  }
+};
+
+class PowerWordsPsychologyEngine {
+  static analyzeTitlePsychology(title, lang = "fr") {
+    const cleanTitle = title.toLowerCase();
+    const dict = MULTILINGUAL_POWER_WORDS[lang] || MULTILINGUAL_POWER_WORDS.fr;
+    const detectedPowerWords = [];
+    let score = 30;
+    const hasAuthority = dict.authority.some((w) => {
+      if (cleanTitle.includes(w)) {
+        detectedPowerWords.push(w);
+        return true;
+      }
+      return false;
+    });
+    if (hasAuthority)
+      score += 20;
+    const hasUrgency = dict.urgency.some((w) => {
+      if (cleanTitle.includes(w)) {
+        detectedPowerWords.push(w);
+        return true;
+      }
+      return false;
+    });
+    if (hasUrgency)
+      score += 15;
+    const hasValue = dict.value.some((w) => {
+      if (cleanTitle.includes(w)) {
+        detectedPowerWords.push(w);
+        return true;
+      }
+      return false;
+    });
+    if (hasValue)
+      score += 15;
+    const hasCuriosity = dict.curiosity.some((w) => {
+      if (cleanTitle.includes(w)) {
+        detectedPowerWords.push(w);
+        return true;
+      }
+      return false;
+    });
+    if (hasCuriosity)
+      score += 10;
+    const hasNumber = /\d+/.test(title);
+    if (hasNumber)
+      score += 10;
+    const currentYear = new Date().getFullYear().toString();
+    const hasYear = title.includes(currentYear) || title.includes("2026");
+    let sentiment = "neutre";
+    const hasPositive = dict.sentimentPositive.some((w) => cleanTitle.includes(w));
+    const hasNegative = dict.sentimentNegative.some((w) => cleanTitle.includes(w));
+    if (hasPositive) {
+      sentiment = "positif";
+    } else if (hasNegative) {
+      sentiment = "negatif";
+    }
+    const recommendations = [];
+    if (!detectedPowerWords.length) {
+      recommendations.push("Ajoutez au moins un mot d'impact (*Power Word*) comme 'Guide Complet', 'Meilleur' ou 'Ultime'.");
+    }
+    if (!hasNumber) {
+      recommendations.push("Intégrez un chiffre ou l'année en cours (ex: '7 astuces', '2026') pour booster le taux de clic de +36%.");
+    }
+    if (title.length < 35) {
+      recommendations.push("Titre trop court : enrichissez votre promesse de valeur pour occuper les 600px de la SERP Google.");
+    }
+    const suggestedTitles = [];
+    if (lang === "fr") {
+      suggestedTitles.push(`${title} : Guide Ultime 2026`);
+      suggestedTitles.push(`Les 5 Meilleurs ${title} (Comparatif & Avis)`);
+      suggestedTitles.push(`${title} — Solution Rapide & Complète`);
+    } else {
+      suggestedTitles.push(`${title}: The Ultimate 2026 Guide`);
+      suggestedTitles.push(`Top 5 Best ${title} (Full Review & Comparison)`);
+      suggestedTitles.push(`${title} — Proven & Fast Method`);
+    }
+    return {
+      score: Math.min(100, score),
+      powerWordsDetected: Array.from(new Set(detectedPowerWords)),
+      sentiment,
+      hasNumber,
+      hasYear,
+      hasCuriosityTrigger: hasCuriosity,
+      hasUrgencyTrigger: hasUrgency,
+      hasAuthorityTrigger: hasAuthority,
+      recommendations,
+      suggestedTitles
+    };
+  }
+  static enrichProgrammaticTitle(service, locationOrCompetitor, type = "geo", lang = "fr") {
+    const year = "2026";
+    if (lang === "fr") {
+      if (type === "geo") {
+        return `Meilleur ${service} à ${locationOrCompetitor} : Guide Complet ${year}`;
+      } else if (type === "vs") {
+        return `${service} vs ${locationOrCompetitor} : Le Comparatif Ultime & Avis`;
+      } else {
+        return `Top 5 Alternatives à ${locationOrCompetitor} : Comparatif ${year}`;
+      }
+    } else if (lang === "en") {
+      if (type === "geo") {
+        return `Best ${service} in ${locationOrCompetitor}: Ultimate ${year} Guide`;
+      } else if (type === "vs") {
+        return `${service} vs ${locationOrCompetitor}: Definitive Comparison`;
+      } else {
+        return `Top 5 Alternatives to ${locationOrCompetitor} (${year} Review)`;
+      }
+    } else if (lang === "es") {
+      if (type === "geo") {
+        return `Mejor ${service} en ${locationOrCompetitor}: Guía Completa ${year}`;
+      } else {
+        return `${service} vs ${locationOrCompetitor}: Comparativa Definitiva`;
+      }
+    } else if (lang === "de") {
+      return `Beste ${service} in ${locationOrCompetitor}: Kompletter Leitfaden ${year}`;
+    } else {
+      return `${service} in ${locationOrCompetitor} (${year})`;
+    }
+  }
+}
 // src/index.ts
 function createLynxSeoEngine(config) {
   return new LynxSeoEngine(config);
@@ -7310,12 +7658,14 @@ export {
   RealReviewsSyncEngine,
   RankMathParityEngine,
   PseoMatrixEngine,
+  PowerWordsPsychologyEngine,
   PSEO_AGENT_SYSTEM_PROMPT,
   OgImageGenerator,
   NGramDensityAnalyzer,
   McpSeoServerHub,
   MasterMarketingEngine,
   MULTILINGUAL_STOP_WORDS,
+  MULTILINGUAL_POWER_WORDS,
   MULTILINGUAL_DISCLAIMERS,
   MULTILINGUAL_BANNED_DISPARAGING_WORDS,
   LynxSeoEngine,

package/dist/power-words-psychology.d.ts

@@ -0,0 +1,35 @@
+/**
+ * 🧠 Multilingual Power Words & Click Psychology Engine
+ * High-Converting CTR Optimizers & Sentiment Analysis across FR, EN, ES, DE, IT
+ */
+export type LanguageCode = "fr" | "en" | "es" | "de" | "it" | "nl" | "pt";
+export interface PsychologyAnalysisResult {
+    score: number;
+    powerWordsDetected: string[];
+    sentiment: "positif" | "negatif" | "neutre";
+    hasNumber: boolean;
+    hasYear: boolean;
+    hasCuriosityTrigger: boolean;
+    hasUrgencyTrigger: boolean;
+    hasAuthorityTrigger: boolean;
+    recommendations: string[];
+    suggestedTitles: string[];
+}
+export declare const MULTILINGUAL_POWER_WORDS: Record<LanguageCode, {
+    authority: string[];
+    urgency: string[];
+    value: string[];
+    curiosity: string[];
+    sentimentPositive: string[];
+    sentimentNegative: string[];
+}>;
+export declare class PowerWordsPsychologyEngine {
+    /**
+     * Analyzes headline/title psychology, CTR triggers, sentiment, and Google SERP potential
+     */
+    static analyzeTitlePsychology(title: string, lang?: LanguageCode): PsychologyAnalysisResult;
+    /**
+     * Automatically enriches a programmatic title with high-converting click psychology power words
+     */
+    static enrichProgrammaticTitle(service: string, locationOrCompetitor: string, type?: "geo" | "vs" | "alt", lang?: LanguageCode): string;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lynxflow/seo-engine",
-  "version": "1.8.1",
+  "version": "1.8.2",
   "description": "High-Performance Multilingual Programmatic SEO & AI Search Engine SDK",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/index.ts

@@ -65,6 +65,7 @@ export * from "./team-rbac";
 export * from "./real-reviews-sync";
 export * from "./google-business-profile";
 export * from "./video-youtube-analyzer";
+export * from "./power-words-psychology";
 
 import { LynxSeoEngine, type EngineConfig } from "./engine";
 import { ApiKeyGuardian } from "./auth-key";

package/src/power-words-psychology.ts

@@ -0,0 +1,260 @@
+/**
+ * 🧠 Multilingual Power Words & Click Psychology Engine
+ * High-Converting CTR Optimizers & Sentiment Analysis across FR, EN, ES, DE, IT
+ */
+
+export type LanguageCode = "fr" | "en" | "es" | "de" | "it" | "nl" | "pt";
+
+export interface PsychologyAnalysisResult {
+  score: number; // 0 to 100
+  powerWordsDetected: string[];
+  sentiment: "positif" | "negatif" | "neutre";
+  hasNumber: boolean;
+  hasYear: boolean;
+  hasCuriosityTrigger: boolean;
+  hasUrgencyTrigger: boolean;
+  hasAuthorityTrigger: boolean;
+  recommendations: string[];
+  suggestedTitles: string[];
+}
+
+export const MULTILINGUAL_POWER_WORDS: Record<LanguageCode, {
+  authority: string[];
+  urgency: string[];
+  value: string[];
+  curiosity: string[];
+  sentimentPositive: string[];
+  sentimentNegative: string[];
+}> = {
+  fr: {
+    authority: [
+      "officiel", "guide", "expert", "complet", "certifié", "ultime", "meilleur", "meilleurs", "comparatif", 
+      "maîtriser", "spécialiste", "leader", "professionnel", "authentique", "infaillible", "reconnu", "démontré"
+    ],
+    urgency: [
+      "rapide", "instantané", "maintenant", "immédiat", "express", "2026", "dernière minute", "urgent", 
+      "dépêchez-vous", "en 5 min", "en 10 min", "aujourd'hui", "débloquer"
+    ],
+    value: [
+      "gratuit", "économique", "rentable", "offert", "sans engagement", "garanti", "facile", "clé en main", 
+      "rentabilité", "gain", "économisez", "inclus", "accessible", "inédit"
+    ],
+    curiosity: [
+      "exclusif", "secret", "astuces", "révélé", "inédit", "top", "méthode", "pourquoi", "comment", 
+      "découvrir", "choc", "incontournable", "mystère", "incroyable"
+    ],
+    sentimentPositive: [
+      "parfait", "incroyable", "magnifique", "puissant", "réussi", "génial", "exceptionnel", "facile", 
+      "meilleur", "succès", "brillant", "splendide", "radieux", "magique", "sublime"
+    ],
+    sentimentNegative: [
+      "erreur", "piège", "danger", "éviter", "pire", "arnaque", "catastrophe", "risqué", "menace", "perte"
+    ]
+  },
+  en: {
+    authority: [
+      "ultimate", "complete", "definitive", "guide", "expert", "official", "proven", "master", "certified", 
+      "best", "top", "authority", "case study", "benchmark", "professional"
+    ],
+    urgency: [
+      "instant", "fast", "quick", "now", "today", "2026", "deadline", "last chance", "step-by-step", 
+      "overnight", "rapid", "minutes"
+    ],
+    value: [
+      "free", "affordable", "guaranteed", "save", "profit", "profitable", "bonus", "cheap", "priceless", 
+      "effortless", "lifetime", "budget"
+    ],
+    curiosity: [
+      "secret", "secrets", "exclusive", "revealed", "hacks", "tricks", "hacks", "behind the scenes", 
+      "uncovered", "surprising", "insider", "confidential", "jaw-dropping"
+    ],
+    sentimentPositive: [
+      "amazing", "awesome", "brilliant", "epic", "legendary", "superb", "stunning", "perfect", "powerful", 
+      "triumph", "miracle", "flawless"
+    ],
+    sentimentNegative: [
+      "mistake", "warning", "deadly", "worst", "danger", "toxic", "destroy", "ruin", "scam", "nightmare"
+    ]
+  },
+  es: {
+    authority: ["guía", "completo", "definitivo", "experto", "oficial", "mejor", "mejores", "certificado", "profesional", "maestro"],
+    urgency: ["rápido", "ahora", "inmediato", "2026", "hoy", "urgente", "en minutos", "paso a paso"],
+    value: ["gratis", "gratuito", "económico", "garantizado", "ahorra", "rentable", "oferta", "sin riesgo"],
+    curiosity: ["secreto", "exclusivo", "revelado", "trucos", "increíble", "top", "método", "descubre"],
+    sentimentPositive: ["increíble", "fantástico", "perfecto", "excelente", "maravilloso", "potente", "éxito"],
+    sentimentNegative: ["error", "peligro", "evitar", "peor", "estafa", "trampa", "arruinar"]
+  },
+  de: {
+    authority: ["leitfaden", "komplett", "experte", "offiziell", "beste", "bester", "zertifiziert", "vergleich", "meister"],
+    urgency: ["schnell", "jetzt", "sofort", "2026", "heute", "schritt-für-schritt", "in 5 minuten"],
+    value: ["kostenlos", "gratis", "sparen", "garantiert", "günstig", "rendite", "ohne risiko"],
+    curiosity: ["geheim", "exklusiv", "tipps", "tricks", "enthüllt", "top", "warum", "entdecken"],
+    sentimentPositive: ["perfekt", "genial", "hervorragend", "leistungsstark", "erfolg", "wunderbar"],
+    sentimentNegative: ["fehler", "gefahr", "vermeiden", "schlimmste", "falle", "risiko"]
+  },
+  it: {
+    authority: ["guida", "completa", "esperto", "ufficiale", "migliore", "migliori", "certificato", "professionale"],
+    urgency: ["veloce", "ora", "subito", "2026", "oggi", "passo dopo passo", "in pochi minuti"],
+    value: ["gratis", "gratuito", "economico", "garantito", "risparmio", "conveniente", "senza rischi"],
+    curiosity: ["segreto", "esclusivo", "trucchi", "rivelato", "top", "metodo", "scopri"],
+    sentimentPositive: ["perfetto", "fantastico", "eccellente", "potente", "successo", "incredibile"],
+    sentimentNegative: ["errore", "pericolo", "evitare", "peggiore", "truffa", "trappola"]
+  },
+  nl: {
+    authority: ["gids", "compleet", "expert", "officieel", "beste", "gecertificeerd", "professioneel"],
+    urgency: ["snel", "nu", "direct", "2026", "vandaag", "stap voor stap"],
+    value: ["gratis", "goedkoop", "gegarandeerd", "bespaar", "rendement", "zonder risico"],
+    curiosity: ["geheim", "exclusief", "tips", "onthuld", "top", "ontdek"],
+    sentimentPositive: ["perfect", "geweldig", "uitstekend", "krachtig", "succes"],
+    sentimentNegative: ["fout", "gevaar", "vermijden", "slechtste", "valkuil"]
+  },
+  pt: {
+    authority: ["guia", "completo", "definitivo", "especialista", "oficial", "melhor", "melhores", "certificado"],
+    urgency: ["rápido", "agora", "imediato", "2026", "hoje", "passo a passo"],
+    value: ["grátis", "gratuito", "econômico", "garantido", "economize", "sem risco"],
+    curiosity: ["segredo", "exclusivo", "revelado", "truques", "top", "descubra"],
+    sentimentPositive: ["incrível", "perfeito", "excelente", "poderoso", "sucesso"],
+    sentimentNegative: ["erro", "perigo", "evitar", "pior", "golpe"]
+  }
+};
+
+export class PowerWordsPsychologyEngine {
+  /**
+   * Analyzes headline/title psychology, CTR triggers, sentiment, and Google SERP potential
+   */
+  static analyzeTitlePsychology(title: string, lang: LanguageCode = "fr"): PsychologyAnalysisResult {
+    const cleanTitle = title.toLowerCase();
+    const dict = MULTILINGUAL_POWER_WORDS[lang] || MULTILINGUAL_POWER_WORDS.fr;
+
+    const detectedPowerWords: string[] = [];
+    let score = 30; // base score
+
+    // 1. Check Authority Triggers
+    const hasAuthority = dict.authority.some(w => {
+      if (cleanTitle.includes(w)) {
+        detectedPowerWords.push(w);
+        return true;
+      }
+      return false;
+    });
+    if (hasAuthority) score += 20;
+
+    // 2. Check Urgency & Timeliness Triggers
+    const hasUrgency = dict.urgency.some(w => {
+      if (cleanTitle.includes(w)) {
+        detectedPowerWords.push(w);
+        return true;
+      }
+      return false;
+    });
+    if (hasUrgency) score += 15;
+
+    // 3. Check Value Triggers
+    const hasValue = dict.value.some(w => {
+      if (cleanTitle.includes(w)) {
+        detectedPowerWords.push(w);
+        return true;
+      }
+      return false;
+    });
+    if (hasValue) score += 15;
+
+    // 4. Check Curiosity & Exclusivity Triggers
+    const hasCuriosity = dict.curiosity.some(w => {
+      if (cleanTitle.includes(w)) {
+        detectedPowerWords.push(w);
+        return true;
+      }
+      return false;
+    });
+    if (hasCuriosity) score += 10;
+
+    // 5. Check Number & Current Year (BuzzSumo & Conductor: +36% CTR)
+    const hasNumber = /\d+/.test(title);
+    if (hasNumber) score += 10;
+
+    const currentYear = new Date().getFullYear().toString();
+    const hasYear = title.includes(currentYear) || title.includes("2026");
+
+    // 6. Sentiment Detection
+    let sentiment: "positif" | "negatif" | "neutre" = "neutre";
+    const hasPositive = dict.sentimentPositive.some(w => cleanTitle.includes(w));
+    const hasNegative = dict.sentimentNegative.some(w => cleanTitle.includes(w));
+    if (hasPositive) {
+      sentiment = "positif";
+    } else if (hasNegative) {
+      sentiment = "negatif";
+    }
+
+    // 7. Recommendations
+    const recommendations: string[] = [];
+    if (!detectedPowerWords.length) {
+      recommendations.push("Ajoutez au moins un mot d'impact (*Power Word*) comme 'Guide Complet', 'Meilleur' ou 'Ultime'.");
+    }
+    if (!hasNumber) {
+      recommendations.push("Intégrez un chiffre ou l'année en cours (ex: '7 astuces', '2026') pour booster le taux de clic de +36%.");
+    }
+    if (title.length < 35) {
+      recommendations.push("Titre trop court : enrichissez votre promesse de valeur pour occuper les 600px de la SERP Google.");
+    }
+
+    // 8. Dynamic High-CTR Suggestions Generator
+    const suggestedTitles: string[] = [];
+    if (lang === "fr") {
+      suggestedTitles.push(`${title} : Guide Ultime 2026`);
+      suggestedTitles.push(`Les 5 Meilleurs ${title} (Comparatif & Avis)`);
+      suggestedTitles.push(`${title} — Solution Rapide & Complète`);
+    } else {
+      suggestedTitles.push(`${title}: The Ultimate 2026 Guide`);
+      suggestedTitles.push(`Top 5 Best ${title} (Full Review & Comparison)`);
+      suggestedTitles.push(`${title} — Proven & Fast Method`);
+    }
+
+    return {
+      score: Math.min(100, score),
+      powerWordsDetected: Array.from(new Set(detectedPowerWords)),
+      sentiment,
+      hasNumber,
+      hasYear,
+      hasCuriosityTrigger: hasCuriosity,
+      hasUrgencyTrigger: hasUrgency,
+      hasAuthorityTrigger: hasAuthority,
+      recommendations,
+      suggestedTitles
+    };
+  }
+
+  /**
+   * Automatically enriches a programmatic title with high-converting click psychology power words
+   */
+  static enrichProgrammaticTitle(service: string, locationOrCompetitor: string, type: "geo" | "vs" | "alt" = "geo", lang: LanguageCode = "fr"): string {
+    const year = "2026";
+    if (lang === "fr") {
+      if (type === "geo") {
+        return `Meilleur ${service} à ${locationOrCompetitor} : Guide Complet ${year}`;
+      } else if (type === "vs") {
+        return `${service} vs ${locationOrCompetitor} : Le Comparatif Ultime & Avis`;
+      } else {
+        return `Top 5 Alternatives à ${locationOrCompetitor} : Comparatif ${year}`;
+      }
+    } else if (lang === "en") {
+      if (type === "geo") {
+        return `Best ${service} in ${locationOrCompetitor}: Ultimate ${year} Guide`;
+      } else if (type === "vs") {
+        return `${service} vs ${locationOrCompetitor}: Definitive Comparison`;
+      } else {
+        return `Top 5 Alternatives to ${locationOrCompetitor} (${year} Review)`;
+      }
+    } else if (lang === "es") {
+      if (type === "geo") {
+        return `Mejor ${service} en ${locationOrCompetitor}: Guía Completa ${year}`;
+      } else {
+        return `${service} vs ${locationOrCompetitor}: Comparativa Definitiva`;
+      }
+    } else if (lang === "de") {
+      return `Beste ${service} in ${locationOrCompetitor}: Kompletter Leitfaden ${year}`;
+    } else {
+      return `${service} in ${locationOrCompetitor} (${year})`;
+    }
+  }
+}