@lynxflow/seo-engine 2.3.0 → 2.4.0

package/README.md

@@ -4,7 +4,7 @@ High-Performance Universal Programmatic SEO & Structured Data Engine for Modern
 
 [![TypeScript](https://img.shields.io/badge/TypeScript-Ready-blue.svg)](https://www.typescriptlang.org/)
 [![License](https://img.shields.io/badge/License-Proprietary-green.svg)](LICENSE)
-[![Version](https://img.shields.io/badge/Version-2.3.0-orange.svg)](https://www.npmjs.com/package/@lynxflow/seo-engine)
+[![Version](https://img.shields.io/badge/Version-2.4.0-orange.svg)](https://www.npmjs.com/package/@lynxflow/seo-engine)
 
 ---
 

package/dist/index.d.ts

@@ -119,6 +119,9 @@ import { SerpLengthComparator } from "./serp-length-comparator";
 import { PassiveVoiceComplexityAnalyzer } from "./passive-voice-complexity";
 import { AboveFoldCroAuditor } from "./above-fold-cro-auditor";
 import { ContextTemplatesGenerator } from "./context-templates-generator";
+import { SearchIntentClassifier } from "./search-intent-classifier";
+import { SeoOpportunityPrioritizer } from "./seo-opportunity-prioritizer";
+import { TrustSignalsExtractor } from "./trust-signals-extractor";
 export declare function createLynxSeoEngine(config: EngineConfig): LynxSeoEngine;
 export declare const LynxSeo: {
     createEngine: typeof createLynxSeoEngine;
@@ -135,6 +138,9 @@ export declare const LynxSeo: {
     readabilityComplexity: typeof PassiveVoiceComplexityAnalyzer;
     aboveFoldCro: typeof AboveFoldCroAuditor;
     contextTemplates: typeof ContextTemplatesGenerator;
+    searchIntent: typeof SearchIntentClassifier;
+    opportunityPrioritizer: typeof SeoOpportunityPrioritizer;
+    trustSignals: typeof TrustSignalsExtractor;
     inspectMeta: typeof SiteAuditor.inspectMeta;
     crawlDomain: typeof DeepCrawlerAuditor.crawlAndAuditDomain;
     inspectHtmlSnapshot: typeof DeepCrawlerAuditor.inspectHtmlSnapshot;
@@ -176,6 +182,9 @@ export declare const LynxSeo: {
     marketingSkills: typeof MarketingSkillsEngine;
     regenerationTracker: typeof PageRegenerationTracker;
 };
+export * from "./search-intent-classifier";
+export * from "./seo-opportunity-prioritizer";
+export * from "./trust-signals-extractor";
 export * from "./humanity-ai-scrubber";
 export * from "./serp-length-comparator";
 export * from "./passive-voice-complexity";

package/dist/index.js

@@ -10393,6 +10393,395 @@ ${kwList}
   }
 }
 
+// src/search-intent-classifier.ts
+class SearchIntentClassifier {
+  static INFORMATIONAL_SIGNALS = [
+    "what",
+    "why",
+    "how",
+    "when",
+    "where",
+    "who",
+    "guide",
+    "tutorial",
+    "learn",
+    "tips",
+    "best practices",
+    "explained",
+    "definition",
+    "meaning",
+    "comment",
+    "pourquoi",
+    "qu'est ce que",
+    "tutoriel",
+    "guide",
+    "astuces",
+    "que es",
+    "como",
+    "guia",
+    "was ist",
+    "wie",
+    "anleitung"
+  ];
+  static NAVIGATIONAL_SIGNALS = [
+    "login",
+    "sign in",
+    "website",
+    "official",
+    "home page",
+    "account",
+    "dashboard",
+    "portal",
+    "app",
+    "connexion",
+    "se connecter",
+    "portail",
+    "iniciar sesion",
+    "anmelden",
+    "konto"
+  ];
+  static TRANSACTIONAL_SIGNALS = [
+    "buy",
+    "purchase",
+    "order",
+    "download",
+    "get",
+    "pricing",
+    "cost",
+    "free trial",
+    "sign up",
+    "subscribe",
+    "install",
+    "coupon",
+    "deal",
+    "discount",
+    "cheap",
+    "affordable",
+    "acheter",
+    "commander",
+    "telecharger",
+    "tarif",
+    "prix",
+    "essai gratuit",
+    "inscription",
+    "comprar",
+    "precio",
+    "kaufen",
+    "preise"
+  ];
+  static COMMERCIAL_SIGNALS = [
+    "best",
+    "top",
+    "review",
+    "vs",
+    "versus",
+    "compare",
+    "comparison",
+    "alternative",
+    "alternatives",
+    "like",
+    "similar",
+    "better than",
+    "instead of",
+    "or",
+    "option",
+    "choice",
+    "meilleur",
+    "avis",
+    "comparatif",
+    "alternatives a",
+    "mejor",
+    "opiniones",
+    "beste",
+    "test",
+    "vergleich"
+  ];
+  static classify(keyword, serpFeatures) {
+    const clean = keyword.toLowerCase().trim();
+    const scores = {
+      informational: 0,
+      navigational: 0,
+      transactional: 0,
+      commercial_investigation: 0
+    };
+    const detectedSignals = [];
+    for (const signal of this.INFORMATIONAL_SIGNALS) {
+      if (new RegExp(`\\b${signal}\\b`, "i").test(clean)) {
+        scores.informational += 35;
+        detectedSignals.push(`[info] ${signal}`);
+      }
+    }
+    for (const signal of this.NAVIGATIONAL_SIGNALS) {
+      if (new RegExp(`\\b${signal}\\b`, "i").test(clean)) {
+        scores.navigational += 45;
+        detectedSignals.push(`[nav] ${signal}`);
+      }
+    }
+    for (const signal of this.TRANSACTIONAL_SIGNALS) {
+      if (new RegExp(`\\b${signal}\\b`, "i").test(clean)) {
+        scores.transactional += 40;
+        detectedSignals.push(`[trans] ${signal}`);
+      }
+    }
+    for (const signal of this.COMMERCIAL_SIGNALS) {
+      if (new RegExp(`\\b${signal}\\b`, "i").test(clean)) {
+        scores.commercial_investigation += 40;
+        detectedSignals.push(`[comm] ${signal}`);
+      }
+    }
+    if (serpFeatures && serpFeatures.length > 0) {
+      for (const feature of serpFeatures) {
+        const f = feature.toLowerCase();
+        if (f.includes("shopping") || f.includes("local_pack") || f.includes("ads")) {
+          scores.transactional += 25;
+        } else if (f.includes("snippet") || f.includes("people_also_ask") || f.includes("knowledge")) {
+          scores.informational += 25;
+        } else if (f.includes("carousel") || f.includes("reviews")) {
+          scores.commercial_investigation += 20;
+        }
+      }
+    }
+    let primaryIntent = "informational";
+    let maxScore = scores.informational;
+    if (scores.commercial_investigation > maxScore) {
+      primaryIntent = "commercial_investigation";
+      maxScore = scores.commercial_investigation;
+    }
+    if (scores.transactional > maxScore) {
+      primaryIntent = "transactional";
+      maxScore = scores.transactional;
+    }
+    if (scores.navigational > maxScore) {
+      primaryIntent = "navigational";
+      maxScore = scores.navigational;
+    }
+    if (maxScore === 0) {
+      if (clean.split(" ").length <= 2) {
+        primaryIntent = "navigational";
+      } else {
+        primaryIntent = "informational";
+      }
+      maxScore = 40;
+    }
+    const confidenceScore = Math.min(98, Math.max(45, maxScore));
+    const formatMap = {
+      informational: "Long-form Step-by-Step Guide, FAQ Accordion, Definition Card, or Tutorial Video.",
+      commercial_investigation: "Comparison Matrix Table (VS), Tiered Review Breakdown, Pros/Cons List.",
+      transactional: "High-Converting Landing Page, Pricing Calculator, Frictionless Signup Flow.",
+      navigational: "Direct Brand Portal, Login Page, Dashboard Directory."
+    };
+    return {
+      primaryIntent,
+      confidenceScore,
+      scores,
+      detectedSignals,
+      recommendedContentFormat: formatMap[primaryIntent]
+    };
+  }
+}
+
+// src/seo-opportunity-prioritizer.ts
+class SeoOpportunityPrioritizer {
+  static BENCHMARK_CTR = {
+    1: 0.316,
+    2: 0.157,
+    3: 0.105,
+    4: 0.075,
+    5: 0.059,
+    6: 0.048,
+    7: 0.041,
+    8: 0.035,
+    9: 0.031,
+    10: 0.027,
+    11: 0.018,
+    12: 0.015,
+    13: 0.013,
+    14: 0.012,
+    15: 0.011,
+    16: 0.01,
+    17: 0.009,
+    18: 0.008,
+    19: 0.008,
+    20: 0.007
+  };
+  static evaluate(input) {
+    const pos = input.currentPosition ?? 25;
+    const vol = input.searchVolume || input.monthlyImpressions || 500;
+    const diff = input.difficulty ?? 40;
+    let volumeScore = Math.min(100, Math.round(Math.log10(Math.max(10, vol)) / 4.5 * 100));
+    let positionScore = 0;
+    let archetype = "high_volume_gap";
+    if (pos >= 11 && pos <= 20) {
+      positionScore = 95;
+      archetype = "quick_win";
+    } else if (pos >= 4 && pos <= 10) {
+      positionScore = 85;
+      archetype = "top_3_push";
+    } else if (pos >= 1 && pos <= 3) {
+      positionScore = 40;
+    } else {
+      positionScore = Math.max(10, 70 - (pos - 20) * 1.5);
+    }
+    let intentScore = 60;
+    if (input.intent === "transactional")
+      intentScore = 100;
+    else if (input.intent === "commercial_investigation")
+      intentScore = 85;
+    else if (input.intent === "informational")
+      intentScore = 65;
+    else if (input.intent === "navigational")
+      intentScore = 40;
+    const competitionScore = Math.max(10, 100 - diff);
+    const expectedCtr = this.BENCHMARK_CTR[Math.min(20, Math.max(1, Math.round(pos)))] || 0.005;
+    const actualCtr = input.actualCtr ?? (input.monthlyClicks || 0) / Math.max(1, input.monthlyImpressions || 1);
+    const isUnderperforming = actualCtr < expectedCtr * 0.7;
+    if (isUnderperforming && pos <= 10) {
+      archetype = "underperformer";
+    }
+    const ctrImprovementScore = isUnderperforming ? 90 : 50;
+    const opportunityScore = Math.round(volumeScore * 0.25 + positionScore * 0.25 + intentScore * 0.2 + competitionScore * 0.15 + ctrImprovementScore * 0.15);
+    const targetClicks = Math.round(vol * 0.15);
+    const currentClicks = input.monthlyClicks || Math.round(vol * (input.actualCtr || 0.01));
+    const estimatedClickGain = Math.max(50, targetClicks - currentClicks);
+    let priorityLevel = "low";
+    if (opportunityScore >= 80)
+      priorityLevel = "critical";
+    else if (opportunityScore >= 65)
+      priorityLevel = "high";
+    else if (opportunityScore >= 50)
+      priorityLevel = "medium";
+    let actionPlan = "";
+    if (archetype === "quick_win") {
+      actionPlan = `Quick Win on Position #${pos} (~${estimatedClickGain} clicks/mo upside). Add 2 internal links with exact anchor text and update H2 subheadings to jump to Page 1.`;
+    } else if (archetype === "underperformer") {
+      actionPlan = `Underperforming CTR (${(actualCtr * 100).toFixed(1)}% vs expected ${(expectedCtr * 100).toFixed(1)}%). Rewrite Meta Title and Description with numbers and power words to boost clicks immediately.`;
+    } else if (archetype === "top_3_push") {
+      actionPlan = `Push from Position #${pos} to Top 3. Add rich Schema.org FAQPage and inject 1 AEO direct answer block.`;
+    } else {
+      actionPlan = `Expand topic cluster depth and build 3-5 high-authority backlinks to improve domain topical equity.`;
+    }
+    return {
+      opportunityScore,
+      archetype,
+      estimatedClickGain,
+      factors: {
+        volumeScore,
+        positionScore,
+        intentScore,
+        competitionScore,
+        ctrImprovementScore
+      },
+      priorityLevel,
+      actionPlan
+    };
+  }
+}
+
+// src/trust-signals-extractor.ts
+class TrustSignalsExtractor {
+  static SOCIAL_PROOF_PATTERNS = [
+    /\b(\d{1,3}(?:[,\s]\d{3})*\+?)\s*(?:customers?|users?|businesses?|clients?|teams?|creators?|entreprises?|utilisateurs?)\b/gi,
+    /(?:trusted|used|loved)\s+by\s+(\d{1,3}(?:[,\s]\d{3})*\+?)/gi,
+    /\b(\d+(?:\.\d+)?[kmb])\+?\s*(?:users?|businesses?|downloads?)/gi
+  ];
+  static RESULT_PATTERNS = [
+    /\b(\d+%\s*(?:increase|decrease|growth|improvement|reduction|croissance|gain|economie|économies))\b/gi,
+    /\b(\d+x\s*(?:faster|more|growth|plus vite|plus rapide))\b/gi,
+    /(?:\$|€|£)\s*(\d{1,3}(?:[,\s]\d{3})*(?:\.\d{2})?)\s*(?:saved|économisé|gagné)?/gi
+  ];
+  static RISK_REVERSAL_PATTERNS = [
+    /\b(\d+[- ]days?\s+free\s+trial|free\s+trial|essai\s+gratuit(?:\s+de\s+\d+\s+jours)?)\b/gi,
+    /\b(no\s+credit\s+card\s+required|sans\s+carte\s+bancaire|sans\s+engagement)\b/gi,
+    /\b(cancel\s+anytime|résiliation\s+à\s+tout\s+moment|satisfait\s+ou\s+remboursé|money[- ]back\s+guarantee)\b/gi,
+    /\b(100%\s+free\s+migration|migration\s+gratuite)\b/gi
+  ];
+  static AUTHORITY_PATTERNS = [
+    /(?:featured|seen|mentioned)\s+(?:in|on)\s+([A-Za-z0-9\s,]+)/gi,
+    /(?:vu\s+dans|mentionné\s+par)\s+([A-Za-z0-9\s,]+)/gi,
+    /\b(award[- ]winning|best[- ]rated|élu\s+meilleur|noté\s+4\.\d\/5|rated\s+4\.\d\/5)\b/gi
+  ];
+  static extract(content) {
+    if (!content || content.trim().length === 0) {
+      return {
+        totalSignalsCount: 0,
+        testimonials: [],
+        socialProofCounts: [],
+        specificResults: [],
+        riskReversals: [],
+        authorityMentions: [],
+        trustScore: 0,
+        isSufficientForConversion: false
+      };
+    }
+    const socialProofCounts = [];
+    const specificResults = [];
+    const riskReversals = [];
+    const authorityMentions = [];
+    const testimonials = [];
+    for (const pattern of this.SOCIAL_PROOF_PATTERNS) {
+      const matches = content.match(pattern);
+      if (matches) {
+        matches.forEach((m) => {
+          if (!socialProofCounts.includes(m.trim()))
+            socialProofCounts.push(m.trim());
+        });
+      }
+    }
+    for (const pattern of this.RESULT_PATTERNS) {
+      const matches = content.match(pattern);
+      if (matches) {
+        matches.forEach((m) => {
+          if (!specificResults.includes(m.trim()))
+            specificResults.push(m.trim());
+        });
+      }
+    }
+    for (const pattern of this.RISK_REVERSAL_PATTERNS) {
+      const matches = content.match(pattern);
+      if (matches) {
+        matches.forEach((m) => {
+          if (!riskReversals.includes(m.trim()))
+            riskReversals.push(m.trim());
+        });
+      }
+    }
+    for (const pattern of this.AUTHORITY_PATTERNS) {
+      const matches = content.match(pattern);
+      if (matches) {
+        matches.forEach((m) => {
+          if (!authorityMentions.includes(m.trim()))
+            authorityMentions.push(m.trim());
+        });
+      }
+    }
+    const quoteRegex = /"([^"]{25,250})"\s*(?:—|-|by)\s*\*?([A-Z][a-z]+(?:\s+[A-Z]\.?)?)\*?/g;
+    let quoteMatch;
+    while ((quoteMatch = quoteRegex.exec(content)) !== null) {
+      testimonials.push({
+        quote: quoteMatch[1].trim(),
+        author: quoteMatch[2]?.trim()
+      });
+    }
+    const totalSignalsCount = socialProofCounts.length + specificResults.length + riskReversals.length + authorityMentions.length + testimonials.length;
+    let trustScore = Math.min(100, totalSignalsCount * 18);
+    if (testimonials.length > 0)
+      trustScore = Math.min(100, trustScore + 15);
+    if (riskReversals.length > 0)
+      trustScore = Math.min(100, trustScore + 15);
+    const isSufficientForConversion = trustScore >= 50;
+    return {
+      totalSignalsCount,
+      testimonials,
+      socialProofCounts,
+      specificResults,
+      riskReversals,
+      authorityMentions,
+      trustScore,
+      isSufficientForConversion
+    };
+  }
+}
+
 // src/index.ts
 function createLynxSeoEngine(config) {
   return new LynxSeoEngine(config);
@@ -10412,6 +10801,9 @@ var LynxSeo = {
   readabilityComplexity: PassiveVoiceComplexityAnalyzer,
   aboveFoldCro: AboveFoldCroAuditor,
   contextTemplates: ContextTemplatesGenerator,
+  searchIntent: SearchIntentClassifier,
+  opportunityPrioritizer: SeoOpportunityPrioritizer,
+  trustSignals: TrustSignalsExtractor,
   inspectMeta: SiteAuditor.inspectMeta,
   crawlDomain: DeepCrawlerAuditor.crawlAndAuditDomain,
   inspectHtmlSnapshot: DeepCrawlerAuditor.inspectHtmlSnapshot,
@@ -10471,6 +10863,7 @@ export {
   VideoYouTubeAnalyzer,
   UrlyticsEngine,
   UI_ICONS,
+  TrustSignalsExtractor,
   TokenQuotaManager,
   TechnicalRulesAuditor,
   TeamRbacEngine,
@@ -10482,8 +10875,10 @@ export {
   SerpRankHistoryEngine,
   SerpLengthComparator,
   SerpClient,
+  SeoOpportunityPrioritizer,
   SeoOpportunitiesDecayDetector,
   SemanticCannibalizationDetector,
+  SearchIntentClassifier,
   SchemaGraphBuilder,
   SUPPORTED_CANONICAL_LOCALES,
   SCHEMA_LOCAL_BUSINESS_MAP,

package/dist/index.mjs

@@ -10393,6 +10393,395 @@ ${kwList}
   }
 }
 
+// src/search-intent-classifier.ts
+class SearchIntentClassifier {
+  static INFORMATIONAL_SIGNALS = [
+    "what",
+    "why",
+    "how",
+    "when",
+    "where",
+    "who",
+    "guide",
+    "tutorial",
+    "learn",
+    "tips",
+    "best practices",
+    "explained",
+    "definition",
+    "meaning",
+    "comment",
+    "pourquoi",
+    "qu'est ce que",
+    "tutoriel",
+    "guide",
+    "astuces",
+    "que es",
+    "como",
+    "guia",
+    "was ist",
+    "wie",
+    "anleitung"
+  ];
+  static NAVIGATIONAL_SIGNALS = [
+    "login",
+    "sign in",
+    "website",
+    "official",
+    "home page",
+    "account",
+    "dashboard",
+    "portal",
+    "app",
+    "connexion",
+    "se connecter",
+    "portail",
+    "iniciar sesion",
+    "anmelden",
+    "konto"
+  ];
+  static TRANSACTIONAL_SIGNALS = [
+    "buy",
+    "purchase",
+    "order",
+    "download",
+    "get",
+    "pricing",
+    "cost",
+    "free trial",
+    "sign up",
+    "subscribe",
+    "install",
+    "coupon",
+    "deal",
+    "discount",
+    "cheap",
+    "affordable",
+    "acheter",
+    "commander",
+    "telecharger",
+    "tarif",
+    "prix",
+    "essai gratuit",
+    "inscription",
+    "comprar",
+    "precio",
+    "kaufen",
+    "preise"
+  ];
+  static COMMERCIAL_SIGNALS = [
+    "best",
+    "top",
+    "review",
+    "vs",
+    "versus",
+    "compare",
+    "comparison",
+    "alternative",
+    "alternatives",
+    "like",
+    "similar",
+    "better than",
+    "instead of",
+    "or",
+    "option",
+    "choice",
+    "meilleur",
+    "avis",
+    "comparatif",
+    "alternatives a",
+    "mejor",
+    "opiniones",
+    "beste",
+    "test",
+    "vergleich"
+  ];
+  static classify(keyword, serpFeatures) {
+    const clean = keyword.toLowerCase().trim();
+    const scores = {
+      informational: 0,
+      navigational: 0,
+      transactional: 0,
+      commercial_investigation: 0
+    };
+    const detectedSignals = [];
+    for (const signal of this.INFORMATIONAL_SIGNALS) {
+      if (new RegExp(`\\b${signal}\\b`, "i").test(clean)) {
+        scores.informational += 35;
+        detectedSignals.push(`[info] ${signal}`);
+      }
+    }
+    for (const signal of this.NAVIGATIONAL_SIGNALS) {
+      if (new RegExp(`\\b${signal}\\b`, "i").test(clean)) {
+        scores.navigational += 45;
+        detectedSignals.push(`[nav] ${signal}`);
+      }
+    }
+    for (const signal of this.TRANSACTIONAL_SIGNALS) {
+      if (new RegExp(`\\b${signal}\\b`, "i").test(clean)) {
+        scores.transactional += 40;
+        detectedSignals.push(`[trans] ${signal}`);
+      }
+    }
+    for (const signal of this.COMMERCIAL_SIGNALS) {
+      if (new RegExp(`\\b${signal}\\b`, "i").test(clean)) {
+        scores.commercial_investigation += 40;
+        detectedSignals.push(`[comm] ${signal}`);
+      }
+    }
+    if (serpFeatures && serpFeatures.length > 0) {
+      for (const feature of serpFeatures) {
+        const f = feature.toLowerCase();
+        if (f.includes("shopping") || f.includes("local_pack") || f.includes("ads")) {
+          scores.transactional += 25;
+        } else if (f.includes("snippet") || f.includes("people_also_ask") || f.includes("knowledge")) {
+          scores.informational += 25;
+        } else if (f.includes("carousel") || f.includes("reviews")) {
+          scores.commercial_investigation += 20;
+        }
+      }
+    }
+    let primaryIntent = "informational";
+    let maxScore = scores.informational;
+    if (scores.commercial_investigation > maxScore) {
+      primaryIntent = "commercial_investigation";
+      maxScore = scores.commercial_investigation;
+    }
+    if (scores.transactional > maxScore) {
+      primaryIntent = "transactional";
+      maxScore = scores.transactional;
+    }
+    if (scores.navigational > maxScore) {
+      primaryIntent = "navigational";
+      maxScore = scores.navigational;
+    }
+    if (maxScore === 0) {
+      if (clean.split(" ").length <= 2) {
+        primaryIntent = "navigational";
+      } else {
+        primaryIntent = "informational";
+      }
+      maxScore = 40;
+    }
+    const confidenceScore = Math.min(98, Math.max(45, maxScore));
+    const formatMap = {
+      informational: "Long-form Step-by-Step Guide, FAQ Accordion, Definition Card, or Tutorial Video.",
+      commercial_investigation: "Comparison Matrix Table (VS), Tiered Review Breakdown, Pros/Cons List.",
+      transactional: "High-Converting Landing Page, Pricing Calculator, Frictionless Signup Flow.",
+      navigational: "Direct Brand Portal, Login Page, Dashboard Directory."
+    };
+    return {
+      primaryIntent,
+      confidenceScore,
+      scores,
+      detectedSignals,
+      recommendedContentFormat: formatMap[primaryIntent]
+    };
+  }
+}
+
+// src/seo-opportunity-prioritizer.ts
+class SeoOpportunityPrioritizer {
+  static BENCHMARK_CTR = {
+    1: 0.316,
+    2: 0.157,
+    3: 0.105,
+    4: 0.075,
+    5: 0.059,
+    6: 0.048,
+    7: 0.041,
+    8: 0.035,
+    9: 0.031,
+    10: 0.027,
+    11: 0.018,
+    12: 0.015,
+    13: 0.013,
+    14: 0.012,
+    15: 0.011,
+    16: 0.01,
+    17: 0.009,
+    18: 0.008,
+    19: 0.008,
+    20: 0.007
+  };
+  static evaluate(input) {
+    const pos = input.currentPosition ?? 25;
+    const vol = input.searchVolume || input.monthlyImpressions || 500;
+    const diff = input.difficulty ?? 40;
+    let volumeScore = Math.min(100, Math.round(Math.log10(Math.max(10, vol)) / 4.5 * 100));
+    let positionScore = 0;
+    let archetype = "high_volume_gap";
+    if (pos >= 11 && pos <= 20) {
+      positionScore = 95;
+      archetype = "quick_win";
+    } else if (pos >= 4 && pos <= 10) {
+      positionScore = 85;
+      archetype = "top_3_push";
+    } else if (pos >= 1 && pos <= 3) {
+      positionScore = 40;
+    } else {
+      positionScore = Math.max(10, 70 - (pos - 20) * 1.5);
+    }
+    let intentScore = 60;
+    if (input.intent === "transactional")
+      intentScore = 100;
+    else if (input.intent === "commercial_investigation")
+      intentScore = 85;
+    else if (input.intent === "informational")
+      intentScore = 65;
+    else if (input.intent === "navigational")
+      intentScore = 40;
+    const competitionScore = Math.max(10, 100 - diff);
+    const expectedCtr = this.BENCHMARK_CTR[Math.min(20, Math.max(1, Math.round(pos)))] || 0.005;
+    const actualCtr = input.actualCtr ?? (input.monthlyClicks || 0) / Math.max(1, input.monthlyImpressions || 1);
+    const isUnderperforming = actualCtr < expectedCtr * 0.7;
+    if (isUnderperforming && pos <= 10) {
+      archetype = "underperformer";
+    }
+    const ctrImprovementScore = isUnderperforming ? 90 : 50;
+    const opportunityScore = Math.round(volumeScore * 0.25 + positionScore * 0.25 + intentScore * 0.2 + competitionScore * 0.15 + ctrImprovementScore * 0.15);
+    const targetClicks = Math.round(vol * 0.15);
+    const currentClicks = input.monthlyClicks || Math.round(vol * (input.actualCtr || 0.01));
+    const estimatedClickGain = Math.max(50, targetClicks - currentClicks);
+    let priorityLevel = "low";
+    if (opportunityScore >= 80)
+      priorityLevel = "critical";
+    else if (opportunityScore >= 65)
+      priorityLevel = "high";
+    else if (opportunityScore >= 50)
+      priorityLevel = "medium";
+    let actionPlan = "";
+    if (archetype === "quick_win") {
+      actionPlan = `Quick Win on Position #${pos} (~${estimatedClickGain} clicks/mo upside). Add 2 internal links with exact anchor text and update H2 subheadings to jump to Page 1.`;
+    } else if (archetype === "underperformer") {
+      actionPlan = `Underperforming CTR (${(actualCtr * 100).toFixed(1)}% vs expected ${(expectedCtr * 100).toFixed(1)}%). Rewrite Meta Title and Description with numbers and power words to boost clicks immediately.`;
+    } else if (archetype === "top_3_push") {
+      actionPlan = `Push from Position #${pos} to Top 3. Add rich Schema.org FAQPage and inject 1 AEO direct answer block.`;
+    } else {
+      actionPlan = `Expand topic cluster depth and build 3-5 high-authority backlinks to improve domain topical equity.`;
+    }
+    return {
+      opportunityScore,
+      archetype,
+      estimatedClickGain,
+      factors: {
+        volumeScore,
+        positionScore,
+        intentScore,
+        competitionScore,
+        ctrImprovementScore
+      },
+      priorityLevel,
+      actionPlan
+    };
+  }
+}
+
+// src/trust-signals-extractor.ts
+class TrustSignalsExtractor {
+  static SOCIAL_PROOF_PATTERNS = [
+    /\b(\d{1,3}(?:[,\s]\d{3})*\+?)\s*(?:customers?|users?|businesses?|clients?|teams?|creators?|entreprises?|utilisateurs?)\b/gi,
+    /(?:trusted|used|loved)\s+by\s+(\d{1,3}(?:[,\s]\d{3})*\+?)/gi,
+    /\b(\d+(?:\.\d+)?[kmb])\+?\s*(?:users?|businesses?|downloads?)/gi
+  ];
+  static RESULT_PATTERNS = [
+    /\b(\d+%\s*(?:increase|decrease|growth|improvement|reduction|croissance|gain|economie|économies))\b/gi,
+    /\b(\d+x\s*(?:faster|more|growth|plus vite|plus rapide))\b/gi,
+    /(?:\$|€|£)\s*(\d{1,3}(?:[,\s]\d{3})*(?:\.\d{2})?)\s*(?:saved|économisé|gagné)?/gi
+  ];
+  static RISK_REVERSAL_PATTERNS = [
+    /\b(\d+[- ]days?\s+free\s+trial|free\s+trial|essai\s+gratuit(?:\s+de\s+\d+\s+jours)?)\b/gi,
+    /\b(no\s+credit\s+card\s+required|sans\s+carte\s+bancaire|sans\s+engagement)\b/gi,
+    /\b(cancel\s+anytime|résiliation\s+à\s+tout\s+moment|satisfait\s+ou\s+remboursé|money[- ]back\s+guarantee)\b/gi,
+    /\b(100%\s+free\s+migration|migration\s+gratuite)\b/gi
+  ];
+  static AUTHORITY_PATTERNS = [
+    /(?:featured|seen|mentioned)\s+(?:in|on)\s+([A-Za-z0-9\s,]+)/gi,
+    /(?:vu\s+dans|mentionné\s+par)\s+([A-Za-z0-9\s,]+)/gi,
+    /\b(award[- ]winning|best[- ]rated|élu\s+meilleur|noté\s+4\.\d\/5|rated\s+4\.\d\/5)\b/gi
+  ];
+  static extract(content) {
+    if (!content || content.trim().length === 0) {
+      return {
+        totalSignalsCount: 0,
+        testimonials: [],
+        socialProofCounts: [],
+        specificResults: [],
+        riskReversals: [],
+        authorityMentions: [],
+        trustScore: 0,
+        isSufficientForConversion: false
+      };
+    }
+    const socialProofCounts = [];
+    const specificResults = [];
+    const riskReversals = [];
+    const authorityMentions = [];
+    const testimonials = [];
+    for (const pattern of this.SOCIAL_PROOF_PATTERNS) {
+      const matches = content.match(pattern);
+      if (matches) {
+        matches.forEach((m) => {
+          if (!socialProofCounts.includes(m.trim()))
+            socialProofCounts.push(m.trim());
+        });
+      }
+    }
+    for (const pattern of this.RESULT_PATTERNS) {
+      const matches = content.match(pattern);
+      if (matches) {
+        matches.forEach((m) => {
+          if (!specificResults.includes(m.trim()))
+            specificResults.push(m.trim());
+        });
+      }
+    }
+    for (const pattern of this.RISK_REVERSAL_PATTERNS) {
+      const matches = content.match(pattern);
+      if (matches) {
+        matches.forEach((m) => {
+          if (!riskReversals.includes(m.trim()))
+            riskReversals.push(m.trim());
+        });
+      }
+    }
+    for (const pattern of this.AUTHORITY_PATTERNS) {
+      const matches = content.match(pattern);
+      if (matches) {
+        matches.forEach((m) => {
+          if (!authorityMentions.includes(m.trim()))
+            authorityMentions.push(m.trim());
+        });
+      }
+    }
+    const quoteRegex = /"([^"]{25,250})"\s*(?:—|-|by)\s*\*?([A-Z][a-z]+(?:\s+[A-Z]\.?)?)\*?/g;
+    let quoteMatch;
+    while ((quoteMatch = quoteRegex.exec(content)) !== null) {
+      testimonials.push({
+        quote: quoteMatch[1].trim(),
+        author: quoteMatch[2]?.trim()
+      });
+    }
+    const totalSignalsCount = socialProofCounts.length + specificResults.length + riskReversals.length + authorityMentions.length + testimonials.length;
+    let trustScore = Math.min(100, totalSignalsCount * 18);
+    if (testimonials.length > 0)
+      trustScore = Math.min(100, trustScore + 15);
+    if (riskReversals.length > 0)
+      trustScore = Math.min(100, trustScore + 15);
+    const isSufficientForConversion = trustScore >= 50;
+    return {
+      totalSignalsCount,
+      testimonials,
+      socialProofCounts,
+      specificResults,
+      riskReversals,
+      authorityMentions,
+      trustScore,
+      isSufficientForConversion
+    };
+  }
+}
+
 // src/index.ts
 function createLynxSeoEngine(config) {
   return new LynxSeoEngine(config);
@@ -10412,6 +10801,9 @@ var LynxSeo = {
   readabilityComplexity: PassiveVoiceComplexityAnalyzer,
   aboveFoldCro: AboveFoldCroAuditor,
   contextTemplates: ContextTemplatesGenerator,
+  searchIntent: SearchIntentClassifier,
+  opportunityPrioritizer: SeoOpportunityPrioritizer,
+  trustSignals: TrustSignalsExtractor,
   inspectMeta: SiteAuditor.inspectMeta,
   crawlDomain: DeepCrawlerAuditor.crawlAndAuditDomain,
   inspectHtmlSnapshot: DeepCrawlerAuditor.inspectHtmlSnapshot,
@@ -10471,6 +10863,7 @@ export {
   VideoYouTubeAnalyzer,
   UrlyticsEngine,
   UI_ICONS,
+  TrustSignalsExtractor,
   TokenQuotaManager,
   TechnicalRulesAuditor,
   TeamRbacEngine,
@@ -10482,8 +10875,10 @@ export {
   SerpRankHistoryEngine,
   SerpLengthComparator,
   SerpClient,
+  SeoOpportunityPrioritizer,
   SeoOpportunitiesDecayDetector,
   SemanticCannibalizationDetector,
+  SearchIntentClassifier,
   SchemaGraphBuilder,
   SUPPORTED_CANONICAL_LOCALES,
   SCHEMA_LOCAL_BUSINESS_MAP,

package/dist/search-intent-classifier.d.ts

@@ -0,0 +1,28 @@
+/**
+ * 🎯 Search Intent Classifier & SERP Feature Intent Mapper
+ * Ported & optimized from Python search_intent_analyzer.py.
+ * Classifies queries as: Informational, Navigational, Transactional, or Commercial Investigation.
+ */
+export type QueryIntentClassification = "informational" | "navigational" | "transactional" | "commercial_investigation";
+export interface SearchIntentResult {
+    primaryIntent: QueryIntentClassification;
+    confidenceScore: number;
+    scores: {
+        informational: number;
+        navigational: number;
+        transactional: number;
+        commercial_investigation: number;
+    };
+    detectedSignals: string[];
+    recommendedContentFormat: string;
+}
+export declare class SearchIntentClassifier {
+    private static readonly INFORMATIONAL_SIGNALS;
+    private static readonly NAVIGATIONAL_SIGNALS;
+    private static readonly TRANSACTIONAL_SIGNALS;
+    private static readonly COMMERCIAL_SIGNALS;
+    /**
+     * Classifies query intent in < 0.01ms.
+     */
+    static classify(keyword: string, serpFeatures?: string[]): SearchIntentResult;
+}

package/dist/seo-opportunity-prioritizer.d.ts

@@ -0,0 +1,37 @@
+/**
+ * 📈 Multi-Factor SEO Opportunity Prioritizer
+ * Ported & optimized from Python opportunity_scorer.py.
+ * Computes an 8-factor Opportunity Score (0-100) using real CTR curves & GSC ranking proximity.
+ */
+export type OpportunityArchetype = "quick_win" | "top_3_push" | "high_volume_gap" | "underperformer" | "declining";
+export interface OpportunityInput {
+    keyword: string;
+    currentPosition?: number;
+    monthlyImpressions?: number;
+    monthlyClicks?: number;
+    actualCtr?: number;
+    searchVolume?: number;
+    difficulty?: number;
+    intent?: "informational" | "commercial_investigation" | "transactional" | "navigational";
+}
+export interface OpportunityScoreResult {
+    opportunityScore: number;
+    archetype: OpportunityArchetype;
+    estimatedClickGain: number;
+    factors: {
+        volumeScore: number;
+        positionScore: number;
+        intentScore: number;
+        competitionScore: number;
+        ctrImprovementScore: number;
+    };
+    priorityLevel: "critical" | "high" | "medium" | "low";
+    actionPlan: string;
+}
+export declare class SeoOpportunityPrioritizer {
+    private static readonly BENCHMARK_CTR;
+    /**
+     * Calculates comprehensive opportunity score for content prioritization.
+     */
+    static evaluate(input: OpportunityInput): OpportunityScoreResult;
+}

package/dist/trust-signals-extractor.d.ts

@@ -0,0 +1,28 @@
+/**
+ * 🛡️ Trust Signals & Social Proof Extractor
+ * Ported & optimized from Python trust_signal_analyzer.py.
+ * Extracts testimonials, customer numbers, percentage growth stats, risk reversals, and media mentions.
+ */
+export interface ExtractedTrustSignals {
+    totalSignalsCount: number;
+    testimonials: Array<{
+        quote: string;
+        author?: string;
+    }>;
+    socialProofCounts: string[];
+    specificResults: string[];
+    riskReversals: string[];
+    authorityMentions: string[];
+    trustScore: number;
+    isSufficientForConversion: boolean;
+}
+export declare class TrustSignalsExtractor {
+    private static readonly SOCIAL_PROOF_PATTERNS;
+    private static readonly RESULT_PATTERNS;
+    private static readonly RISK_REVERSAL_PATTERNS;
+    private static readonly AUTHORITY_PATTERNS;
+    /**
+     * Scans text or HTML and extracts all verifiable trust signals.
+     */
+    static extract(content: string): ExtractedTrustSignals;
+}

package/package.json

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