@lynxflow/seo-engine 1.8.1 → 1.8.3

package/dist/index.mjs

@@ -3084,10 +3084,13 @@ class ExtendedSchemaGraphBuilder {
     };
   }
   static buildAggregateRating(opts) {
+    if (!opts.ratingValue || !opts.reviewCount || opts.reviewCount <= 0) {
+      return null;
+    }
     return {
       "@type": "AggregateRating",
-      ratingValue: opts.ratingValue ?? 4.9,
-      reviewCount: opts.reviewCount ?? 1280,
+      ratingValue: opts.ratingValue,
+      reviewCount: opts.reviewCount,
       bestRating: opts.bestRating ?? 5,
       worstRating: opts.worstRating ?? 1,
       itemReviewed: {
@@ -3305,8 +3308,8 @@ class OgImageGenerator {
     const badge = opts.badgeText || "OFFICIAL";
     const title = opts.title.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
     const loc = opts.locationName ? `\uD83D\uDCCD ${opts.locationName}` : "⚡ Instant Cloud Setup";
-    const rating = opts.ratingValue ?? 4.9;
-    const reviews = opts.reviewCount ?? 1280;
+    const rating = opts.ratingValue;
+    const reviews = opts.reviewCount;
     const accent = opts.brandColor || "#6366F1";
     return `<svg width="1200" height="630" viewBox="0 0 1200 630" xmlns="http://www.w3.org/2000/svg">
   <defs>
@@ -3349,12 +3352,12 @@ class OgImageGenerator {
     ${title.length > 38 ? `<tspan x="80" dy="68">${title.slice(38, 80)}</tspan>` : ""}
   </text>
 
-  <!-- Trust Stars & Social Proof -->
-  <g transform="translate(80, 470)">
+  <!-- Trust Stars & Social Proof (Only if real verified reviews exist) -->
+  ${rating && reviews ? `<g transform="translate(80, 470)">
     <text x="0" y="32" fill="#FBBF24" font-size="24">★★★★★</text>
     <text x="140" y="30" fill="#F8FAFC" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif" font-size="20" font-weight="800">${rating} / 5</text>
     <text x="210" y="30" fill="#64748B" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif" font-size="16" font-weight="500">(${reviews.toLocaleString()} verified reviews)</text>
-  </g>
+  </g>` : ""}
 
   <!-- Footer Brand -->
   <g transform="translate(80, 540)">
@@ -7232,6 +7235,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 +7661,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.3",
   "description": "High-Performance Multilingual Programmatic SEO & AI Search Engine SDK",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/extended-schemas.ts

@@ -278,7 +278,7 @@ export class ExtendedSchemaGraphBuilder {
   }
 
   /**
-   * 7. AggregateRating (Google Gold Stars in SERPs) - Inspired by santifer-irepair
+   * 7. AggregateRating (Google Gold Stars in SERPs) - Strictly Dynamic (No Fake Defaults)
    */
   static buildAggregateRating(opts: {
     ratingValue?: number;
@@ -286,11 +286,15 @@ export class ExtendedSchemaGraphBuilder {
     bestRating?: number;
     worstRating?: number;
     itemReviewedName: string;
-  }): Record<string, unknown> {
+  }): Record<string, unknown> | null {
+    // Google Strict Compliance: Never emit fake or default hardcoded reviews
+    if (!opts.ratingValue || !opts.reviewCount || opts.reviewCount <= 0) {
+      return null;
+    }
     return {
       "@type": "AggregateRating",
-      ratingValue: opts.ratingValue ?? 4.9,
-      reviewCount: opts.reviewCount ?? 1280,
+      ratingValue: opts.ratingValue,
+      reviewCount: opts.reviewCount,
       bestRating: opts.bestRating ?? 5,
       worstRating: opts.worstRating ?? 1,
       itemReviewed: {

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/og-image-generator.ts

@@ -46,8 +46,8 @@ export class OgImageGenerator {
     const badge = opts.badgeText || "OFFICIAL";
     const title = opts.title.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
     const loc = opts.locationName ? `📍 ${opts.locationName}` : "⚡ Instant Cloud Setup";
-    const rating = opts.ratingValue ?? 4.9;
-    const reviews = opts.reviewCount ?? 1280;
+    const rating = opts.ratingValue;
+    const reviews = opts.reviewCount;
     const accent = opts.brandColor || "#6366F1";
 
     return `<svg width="1200" height="630" viewBox="0 0 1200 630" xmlns="http://www.w3.org/2000/svg">
@@ -91,12 +91,12 @@ export class OgImageGenerator {
     ${title.length > 38 ? `<tspan x="80" dy="68">${title.slice(38, 80)}</tspan>` : ""}
   </text>
 
-  <!-- Trust Stars & Social Proof -->
-  <g transform="translate(80, 470)">
+  <!-- Trust Stars & Social Proof (Only if real verified reviews exist) -->
+  ${rating && reviews ? `<g transform="translate(80, 470)">
     <text x="0" y="32" fill="#FBBF24" font-size="24">★★★★★</text>
     <text x="140" y="30" fill="#F8FAFC" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif" font-size="20" font-weight="800">${rating} / 5</text>
     <text x="210" y="30" fill="#64748B" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif" font-size="16" font-weight="500">(${reviews.toLocaleString()} verified reviews)</text>
-  </g>
+  </g>` : ""}
 
   <!-- Footer Brand -->
   <g transform="translate(80, 540)">