@lynxflow/seo-engine 2.5.0 → 2.6.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.5.0-orange.svg)](https://www.npmjs.com/package/@lynxflow/seo-engine)
+[![Version](https://img.shields.io/badge/Version-2.6.0-orange.svg)](https://www.npmjs.com/package/@lynxflow/seo-engine)
 
 ---
 

package/dist/content-quality-scorer.d.ts

@@ -0,0 +1,40 @@
+/**
+ * 💎 Multi-Dimensional Content Quality Scorer
+ * Ported & optimized from Python content_scorer.py (31 KB).
+ * Evaluates 5 dimensions: Humanity/Voice (30%), Specificity (25%), Structure Balance (20%), SEO Compliance (15%), Readability (10%).
+ * Composite quality threshold: >= 70 to pass.
+ */
+export interface DimensionScoreBreakdown {
+    score: number;
+    weight: number;
+    weightedScore: number;
+    strengths: string[];
+    issues: string[];
+}
+export interface ContentQualityReport {
+    compositeScore: number;
+    passesQualityThreshold: boolean;
+    grade: "A+" | "A" | "B" | "C" | "F";
+    dimensions: {
+        humanity: DimensionScoreBreakdown;
+        specificity: DimensionScoreBreakdown;
+        structureBalance: DimensionScoreBreakdown;
+        seoCompliance: DimensionScoreBreakdown;
+        readability: DimensionScoreBreakdown;
+    };
+    proseToListRatio: number;
+    topPriorityFixes: string[];
+}
+export declare class ContentQualityScorer {
+    private static readonly VAGUE_WORDS;
+    private static readonly SPECIFICITY_DATA_PATTERNS;
+    private static readonly CONVERSATIONAL_DEVICES;
+    /**
+     * Scores content across all 5 dimensions.
+     */
+    static scoreContent(content: string, metadata?: {
+        metaTitle?: string;
+        primaryKeyword?: string;
+    }): ContentQualityReport;
+    private static emptyReport;
+}

package/dist/index.d.ts

@@ -125,6 +125,9 @@ import { TrustSignalsExtractor } from "./trust-signals-extractor";
 import { CompetitorGapBlueprintEngine } from "./competitor-gap-blueprint";
 import { EngagementHookAnalyzer } from "./engagement-hook-analyzer";
 import { KeywordDensityGuard } from "./keyword-density-guard";
+import { ContentQualityScorer } from "./content-quality-scorer";
+import { LandingCroChecker } from "./landing-cro-checker";
+import { SocialCommunityInsightsAggregator } from "./social-community-insights";
 export declare function createLynxSeoEngine(config: EngineConfig): LynxSeoEngine;
 export declare const LynxSeo: {
     createEngine: typeof createLynxSeoEngine;
@@ -147,6 +150,9 @@ export declare const LynxSeo: {
     competitorGap: typeof CompetitorGapBlueprintEngine;
     engagementHook: typeof EngagementHookAnalyzer;
     keywordDensity: typeof KeywordDensityGuard;
+    contentQuality: typeof ContentQualityScorer;
+    landingCroChecker: typeof LandingCroChecker;
+    socialInsights: typeof SocialCommunityInsightsAggregator;
     inspectMeta: typeof SiteAuditor.inspectMeta;
     crawlDomain: typeof DeepCrawlerAuditor.crawlAndAuditDomain;
     inspectHtmlSnapshot: typeof DeepCrawlerAuditor.inspectHtmlSnapshot;
@@ -188,6 +194,9 @@ export declare const LynxSeo: {
     marketingSkills: typeof MarketingSkillsEngine;
     regenerationTracker: typeof PageRegenerationTracker;
 };
+export * from "./content-quality-scorer";
+export * from "./landing-cro-checker";
+export * from "./social-community-insights";
 export * from "./competitor-gap-blueprint";
 export * from "./engagement-hook-analyzer";
 export * from "./keyword-density-guard";

package/dist/index.js

@@ -11049,6 +11049,323 @@ class KeywordDensityGuard {
   }
 }
 
+// src/content-quality-scorer.ts
+class ContentQualityScorer {
+  static VAGUE_WORDS = [
+    /\b(?:many|some|various|numerous|several|often|sometimes|usually|generally|typically|significantly|substantial|greatly|very|really|quite|relatively)\b/gi
+  ];
+  static SPECIFICITY_DATA_PATTERNS = [
+    /\b\d{1,3}%\b/g,
+    /(?:\$|€|£)\s*[\d,]+(?:\.\d{2})?\b/g,
+    /\b\d{4}\b/g,
+    /\b\d+(?:,\d{3})*\s*(?:users?|customers?|businesses?|downloads?|hours?|minutes?)\b/gi,
+    /\"[^\"]{10,120}\"/g
+  ];
+  static CONVERSATIONAL_DEVICES = [
+    /\([^)]{5,40}\)/g,
+    /\?(?:\s|$)/g,
+    /\b(?:don't|can't|won't|you're|you've|it's|that's|here's|let's|we've|we're|I've)\b/gi,
+    /(?:^|\.\s+)(?:Look|Here['’]s the thing|The truth is|Sound familiar|Trust me|Regardez|En clair)/gi
+  ];
+  static scoreContent(content, metadata) {
+    if (!content || content.trim().length === 0) {
+      return this.emptyReport();
+    }
+    const words = content.split(/\s+/).filter(Boolean);
+    const totalWords = words.length;
+    let conversationalHits = 0;
+    for (const pat of this.CONVERSATIONAL_DEVICES) {
+      conversationalHits += (content.match(pat) || []).length;
+    }
+    const humanityRaw = Math.min(100, Math.round(conversationalHits / Math.max(1, totalWords / 80) * 60) + 30);
+    const humanityScore = Math.max(20, Math.min(100, humanityRaw));
+    let dataPointsCount = 0;
+    for (const pat of this.SPECIFICITY_DATA_PATTERNS) {
+      dataPointsCount += (content.match(pat) || []).length;
+    }
+    let vagueWordsCount = 0;
+    for (const pat of this.VAGUE_WORDS) {
+      vagueWordsCount += (content.match(pat) || []).length;
+    }
+    const specificityRatio = dataPointsCount / Math.max(1, vagueWordsCount * 0.5 + 2);
+    const specificityScore = Math.max(25, Math.min(100, Math.round(specificityRatio * 35 + 40)));
+    const lines = content.split(`
+`).map((l) => l.trim()).filter(Boolean);
+    const listLines = lines.filter((l) => l.startsWith("-") || l.startsWith("*") || l.startsWith("1.") || l.startsWith("2.")).length;
+    const proseLines = lines.filter((l) => !l.startsWith("#") && !l.startsWith("-") && !l.startsWith("*") && !l.startsWith("1.")).length;
+    const totalContentLines = Math.max(1, listLines + proseLines);
+    const proseRatio = Math.round(proseLines / totalContentLines * 100) / 100;
+    let structureScore = 85;
+    const structureIssues = [];
+    if (proseRatio < 0.4) {
+      structureScore = 50;
+      structureIssues.push("Too list-heavy (> 60% bullet points). Add explanatory narrative prose paragraphs between lists.");
+    } else if (proseRatio > 0.85) {
+      structureScore = 65;
+      structureIssues.push("Too prose-heavy (> 85% text walls). Break up long sections with bullet lists, comparison tables, or callouts.");
+    }
+    let seoScore = 80;
+    const seoIssues = [];
+    const hasH1 = lines.some((l) => l.startsWith("# "));
+    const h2Count = lines.filter((l) => l.startsWith("## ")).length;
+    if (!hasH1) {
+      seoScore -= 25;
+      seoIssues.push("Missing H1 title heading.");
+    }
+    if (h2Count < 2) {
+      seoScore -= 20;
+      seoIssues.push("Fewer than 2 H2 subheadings found. Structure content with clear sub-topics.");
+    }
+    if (metadata?.primaryKeyword && !content.toLowerCase().includes(metadata.primaryKeyword.toLowerCase())) {
+      seoScore -= 20;
+      seoIssues.push(`Target keyword "${metadata.primaryKeyword}" is missing from body text.`);
+    }
+    const avgSentenceLength = Math.round(totalWords / Math.max(1, content.split(/[.?!]/).length) * 10) / 10;
+    let readabilityScore = 85;
+    const readIssues = [];
+    if (avgSentenceLength > 20) {
+      readabilityScore = 55;
+      readIssues.push(`Average sentence length is ${avgSentenceLength} words (Target: 13-17 words).`);
+    }
+    const composite = Math.round(humanityScore * 0.3 + specificityScore * 0.25 + structureScore * 0.2 + seoScore * 0.15 + readabilityScore * 0.1);
+    const passes = composite >= 70;
+    let grade = "F";
+    if (composite >= 90)
+      grade = "A+";
+    else if (composite >= 80)
+      grade = "A";
+    else if (composite >= 70)
+      grade = "B";
+    else if (composite >= 55)
+      grade = "C";
+    const topFixes = [
+      ...structureIssues,
+      ...seoIssues,
+      ...readIssues
+    ];
+    if (specificityScore < 70) {
+      topFixes.push("Inject verified data points (specific dollar amounts, percentage improvements, dates) instead of vague generalities.");
+    }
+    if (humanityScore < 70) {
+      topFixes.push("Adopt a conversational tone: add contractions (you're, it's), rhetorical questions, and casual transition words.");
+    }
+    return {
+      compositeScore: composite,
+      passesQualityThreshold: passes,
+      grade,
+      dimensions: {
+        humanity: {
+          score: humanityScore,
+          weight: 0.3,
+          weightedScore: Math.round(humanityScore * 0.3),
+          strengths: humanityScore >= 75 ? ["Conversational tone", "Natural pacing"] : [],
+          issues: humanityScore < 75 ? ["Sounds slightly robotic or formal"] : []
+        },
+        specificity: {
+          score: specificityScore,
+          weight: 0.25,
+          weightedScore: Math.round(specificityScore * 0.25),
+          strengths: specificityScore >= 75 ? ["High hard-data density", "Concrete benchmarks"] : [],
+          issues: specificityScore < 75 ? ["Excessive vague words (many, several, often)"] : []
+        },
+        structureBalance: {
+          score: structureScore,
+          weight: 0.2,
+          weightedScore: Math.round(structureScore * 0.2),
+          strengths: structureScore >= 75 ? ["Balanced mix of prose and scannable lists"] : [],
+          issues: structureIssues
+        },
+        seoCompliance: {
+          score: seoScore,
+          weight: 0.15,
+          weightedScore: Math.round(seoScore * 0.15),
+          strengths: seoScore >= 75 ? ["Proper H1/H2 hierarchy"] : [],
+          issues: seoIssues
+        },
+        readability: {
+          score: readabilityScore,
+          weight: 0.1,
+          weightedScore: Math.round(readabilityScore * 0.1),
+          strengths: readabilityScore >= 75 ? ["Punchy sentence lengths"] : [],
+          issues: readIssues
+        }
+      },
+      proseToListRatio: proseRatio,
+      topPriorityFixes: topFixes
+    };
+  }
+  static emptyReport() {
+    return {
+      compositeScore: 0,
+      passesQualityThreshold: false,
+      grade: "F",
+      dimensions: {
+        humanity: { score: 0, weight: 0.3, weightedScore: 0, strengths: [], issues: [] },
+        specificity: { score: 0, weight: 0.25, weightedScore: 0, strengths: [], issues: [] },
+        structureBalance: { score: 0, weight: 0.2, weightedScore: 0, strengths: [], issues: [] },
+        seoCompliance: { score: 0, weight: 0.15, weightedScore: 0, strengths: [], issues: [] },
+        readability: { score: 0, weight: 0.1, weightedScore: 0, strengths: [], issues: [] }
+      },
+      proseToListRatio: 0,
+      topPriorityFixes: ["Provide text content to score."]
+    };
+  }
+}
+
+// src/landing-cro-checker.ts
+class LandingCroChecker {
+  static auditLandingPage(content, config = {}) {
+    const checks = [];
+    const lines = content.split(`
+`).map((l) => l.trim()).filter(Boolean);
+    const h1 = lines.find((l) => l.startsWith("# "))?.replace("# ", "") || "";
+    const h1Words = h1.split(/\s+/).filter(Boolean).length;
+    const isH1Clear = h1Words >= 4 && h1Words <= 14;
+    checks.push({
+      id: "h1_length",
+      name: "Headline Length & Outcome Focus",
+      category: "headline",
+      passed: isH1Clear,
+      importance: "critical",
+      feedback: isH1Clear ? "H1 is clear, outcome-focused, and scannable in < 3s." : "H1 is missing or too long/vague."
+    });
+    const hasValueProp = /save|boost|cut|grow|automate|increase|réduire|augmenter|gagner/i.test(content);
+    checks.push({
+      id: "value_prop_benefit",
+      name: "Concrete Benefit & Outcome",
+      category: "value_prop",
+      passed: hasValueProp,
+      importance: "critical",
+      feedback: hasValueProp ? "Explicit outcome/benefit articulated in content." : "Lacks explicit outcome/benefit statements."
+    });
+    const hasReviews = /rated|reviews?|avis|clients?|customers?|businesses?|\d{1,3}(?:,\d{3})*\+/i.test(content);
+    checks.push({
+      id: "social_proof_ratings",
+      name: "Customer Reviews & Numbers",
+      category: "social_proof",
+      passed: hasReviews,
+      importance: "important",
+      feedback: hasReviews ? "Social proof count or star rating present." : "No social proof numbers found."
+    });
+    const hasActionCta = /(?:start|try|get|claim|démarrer|essayer|profiter|obtenir)\s+(?:free|trial|now|today|gratuit)/i.test(content);
+    checks.push({
+      id: "cta_action_verb",
+      name: "High-Contrast Outcome CTA",
+      category: "ctas",
+      passed: hasActionCta,
+      importance: "critical",
+      feedback: hasActionCta ? "High-converting action verb present in CTA." : "CTA is generic or missing action verb."
+    });
+    const hasFaq = /faq|frequently asked|questions|foire aux questions/i.test(content);
+    checks.push({
+      id: "faq_objection_handling",
+      name: "Objection Handling & FAQ Section",
+      category: "objection_handling",
+      passed: hasFaq,
+      importance: "important",
+      feedback: hasFaq ? "FAQ section handles user hesitations." : "Missing FAQ / objection handling section."
+    });
+    const hasRiskReversal = /no credit card|cancel anytime|money-back|sans carte|sans engagement|garantie/i.test(content);
+    checks.push({
+      id: "risk_reversal_guarantee",
+      name: "Zero-Risk Micro-Copy",
+      category: "risk_reversal",
+      passed: hasRiskReversal,
+      importance: "important",
+      feedback: hasRiskReversal ? "Risk reversal micro-copy found near CTA." : "No risk reversal guarantee found."
+    });
+    const hasUrgency = /today|now|instant|limited|aujourd'hui|maintenant|immédiat/i.test(content);
+    checks.push({
+      id: "urgency_trigger",
+      name: "Immediate Access & Momentum",
+      category: "urgency",
+      passed: hasUrgency,
+      importance: "enhancement",
+      feedback: hasUrgency ? "Presents immediate access momentum." : "Lacks urgency or immediacy trigger."
+    });
+    const hasSubheadings = lines.filter((l) => l.startsWith("## ")).length >= 3;
+    checks.push({
+      id: "structure_scannability",
+      name: "Visual Hierarchy & H2 Subheadings",
+      category: "structure",
+      passed: hasSubheadings,
+      importance: "important",
+      feedback: hasSubheadings ? "Clean visual hierarchy with 3+ H2 sections." : "Fewer than 3 H2 subheadings found."
+    });
+    const totalChecks = checks.length;
+    const passedChecks = checks.filter((c) => c.passed).length;
+    const criticalFailures = checks.filter((c) => !c.passed && c.importance === "critical");
+    const warnings = checks.filter((c) => !c.passed && c.importance === "important");
+    const overallCroScore = Math.round(passedChecks / totalChecks * 100);
+    const passes = overallCroScore >= 70 && criticalFailures.length === 0;
+    let grade = "F";
+    if (overallCroScore >= 90)
+      grade = "A+";
+    else if (overallCroScore >= 80)
+      grade = "A";
+    else if (overallCroScore >= 70)
+      grade = "B";
+    else if (overallCroScore >= 55)
+      grade = "C";
+    const categoryScores = {};
+    for (const check of checks) {
+      if (!categoryScores[check.category]) {
+        categoryScores[check.category] = { score: 0, passedCount: 0, totalCount: 0 };
+      }
+      categoryScores[check.category].totalCount++;
+      if (check.passed)
+        categoryScores[check.category].passedCount++;
+    }
+    for (const cat in categoryScores) {
+      categoryScores[cat].score = Math.round(categoryScores[cat].passedCount / categoryScores[cat].totalCount * 100);
+    }
+    const roadmap = checks.filter((c) => !c.passed).map((c) => `[${c.importance.toUpperCase()}] ${c.category}: ${c.feedback}`);
+    return {
+      overallCroScore,
+      passesCroAudit: passes,
+      grade,
+      criticalFailuresCount: criticalFailures.length,
+      warningsCount: warnings.length,
+      checks,
+      categoryScores,
+      conversionRoadmap: roadmap
+    };
+  }
+}
+
+// src/social-community-insights.ts
+class SocialCommunityInsightsAggregator {
+  static aggregate(topic, rawInsights) {
+    const painPoints = [];
+    const realLanguage = [];
+    const quotables = [];
+    for (const item of rawInsights) {
+      if (item.type === "pain_point" || item.type === "complaint") {
+        if (!painPoints.includes(item.quotableText)) {
+          painPoints.push(item.quotableText);
+        }
+      }
+      if (item.quotableText) {
+        quotables.push(`"${item.quotableText}" (${item.source})`);
+      }
+      for (const phrase of item.userVocabulary) {
+        if (!realLanguage.includes(phrase)) {
+          realLanguage.push(phrase);
+        }
+      }
+    }
+    const recommendedAngle = painPoints.length > 0 ? `Address the #1 community frustration: "${painPoints[0]}" by demonstrating immediate resolution in the hero hook.` : `Highlight community-tested best practices and back every recommendation with verified user metrics.`;
+    return {
+      topic,
+      totalInsights: rawInsights.length,
+      painPoints,
+      realLanguagePhrases: realLanguage,
+      quotableExcerpts: quotables,
+      recommendedAngleForCopy: recommendedAngle
+    };
+  }
+}
+
 // src/index.ts
 function createLynxSeoEngine(config) {
   return new LynxSeoEngine(config);
@@ -11074,6 +11391,9 @@ var LynxSeo = {
   competitorGap: CompetitorGapBlueprintEngine,
   engagementHook: EngagementHookAnalyzer,
   keywordDensity: KeywordDensityGuard,
+  contentQuality: ContentQualityScorer,
+  landingCroChecker: LandingCroChecker,
+  socialInsights: SocialCommunityInsightsAggregator,
   inspectMeta: SiteAuditor.inspectMeta,
   crawlDomain: DeepCrawlerAuditor.crawlAndAuditDomain,
   inspectHtmlSnapshot: DeepCrawlerAuditor.inspectHtmlSnapshot,
@@ -11140,6 +11460,7 @@ export {
   SocialVideoSeoAnalyticsEngine,
   SocialTrendSeoGenerator,
   SocialGrowthSuite,
+  SocialCommunityInsightsAggregator,
   SocialAdsSocialSeoEngine,
   SiteAuditor,
   SerpRankHistoryEngine,
@@ -11177,6 +11498,7 @@ export {
   LynxAnalyticsClient,
   LlmContentCleaner,
   LegalDisclaimerEngine,
+  LandingCroChecker,
   LagoTokenMeter,
   KnowledgeGraphLinker,
   KnowledgeBankBuilder,
@@ -11204,6 +11526,7 @@ export {
   CroCopywritingEngine,
   CopywritingFrameworksMaster,
   ContextTemplatesGenerator,
+  ContentQualityScorer,
   CompetitorGapBlueprintEngine,
   CONTENT_AI_40_TOOLS,
   BrandDnaCalendarEngine,

package/dist/index.mjs

@@ -11049,6 +11049,323 @@ class KeywordDensityGuard {
   }
 }
 
+// src/content-quality-scorer.ts
+class ContentQualityScorer {
+  static VAGUE_WORDS = [
+    /\b(?:many|some|various|numerous|several|often|sometimes|usually|generally|typically|significantly|substantial|greatly|very|really|quite|relatively)\b/gi
+  ];
+  static SPECIFICITY_DATA_PATTERNS = [
+    /\b\d{1,3}%\b/g,
+    /(?:\$|€|£)\s*[\d,]+(?:\.\d{2})?\b/g,
+    /\b\d{4}\b/g,
+    /\b\d+(?:,\d{3})*\s*(?:users?|customers?|businesses?|downloads?|hours?|minutes?)\b/gi,
+    /\"[^\"]{10,120}\"/g
+  ];
+  static CONVERSATIONAL_DEVICES = [
+    /\([^)]{5,40}\)/g,
+    /\?(?:\s|$)/g,
+    /\b(?:don't|can't|won't|you're|you've|it's|that's|here's|let's|we've|we're|I've)\b/gi,
+    /(?:^|\.\s+)(?:Look|Here['’]s the thing|The truth is|Sound familiar|Trust me|Regardez|En clair)/gi
+  ];
+  static scoreContent(content, metadata) {
+    if (!content || content.trim().length === 0) {
+      return this.emptyReport();
+    }
+    const words = content.split(/\s+/).filter(Boolean);
+    const totalWords = words.length;
+    let conversationalHits = 0;
+    for (const pat of this.CONVERSATIONAL_DEVICES) {
+      conversationalHits += (content.match(pat) || []).length;
+    }
+    const humanityRaw = Math.min(100, Math.round(conversationalHits / Math.max(1, totalWords / 80) * 60) + 30);
+    const humanityScore = Math.max(20, Math.min(100, humanityRaw));
+    let dataPointsCount = 0;
+    for (const pat of this.SPECIFICITY_DATA_PATTERNS) {
+      dataPointsCount += (content.match(pat) || []).length;
+    }
+    let vagueWordsCount = 0;
+    for (const pat of this.VAGUE_WORDS) {
+      vagueWordsCount += (content.match(pat) || []).length;
+    }
+    const specificityRatio = dataPointsCount / Math.max(1, vagueWordsCount * 0.5 + 2);
+    const specificityScore = Math.max(25, Math.min(100, Math.round(specificityRatio * 35 + 40)));
+    const lines = content.split(`
+`).map((l) => l.trim()).filter(Boolean);
+    const listLines = lines.filter((l) => l.startsWith("-") || l.startsWith("*") || l.startsWith("1.") || l.startsWith("2.")).length;
+    const proseLines = lines.filter((l) => !l.startsWith("#") && !l.startsWith("-") && !l.startsWith("*") && !l.startsWith("1.")).length;
+    const totalContentLines = Math.max(1, listLines + proseLines);
+    const proseRatio = Math.round(proseLines / totalContentLines * 100) / 100;
+    let structureScore = 85;
+    const structureIssues = [];
+    if (proseRatio < 0.4) {
+      structureScore = 50;
+      structureIssues.push("Too list-heavy (> 60% bullet points). Add explanatory narrative prose paragraphs between lists.");
+    } else if (proseRatio > 0.85) {
+      structureScore = 65;
+      structureIssues.push("Too prose-heavy (> 85% text walls). Break up long sections with bullet lists, comparison tables, or callouts.");
+    }
+    let seoScore = 80;
+    const seoIssues = [];
+    const hasH1 = lines.some((l) => l.startsWith("# "));
+    const h2Count = lines.filter((l) => l.startsWith("## ")).length;
+    if (!hasH1) {
+      seoScore -= 25;
+      seoIssues.push("Missing H1 title heading.");
+    }
+    if (h2Count < 2) {
+      seoScore -= 20;
+      seoIssues.push("Fewer than 2 H2 subheadings found. Structure content with clear sub-topics.");
+    }
+    if (metadata?.primaryKeyword && !content.toLowerCase().includes(metadata.primaryKeyword.toLowerCase())) {
+      seoScore -= 20;
+      seoIssues.push(`Target keyword "${metadata.primaryKeyword}" is missing from body text.`);
+    }
+    const avgSentenceLength = Math.round(totalWords / Math.max(1, content.split(/[.?!]/).length) * 10) / 10;
+    let readabilityScore = 85;
+    const readIssues = [];
+    if (avgSentenceLength > 20) {
+      readabilityScore = 55;
+      readIssues.push(`Average sentence length is ${avgSentenceLength} words (Target: 13-17 words).`);
+    }
+    const composite = Math.round(humanityScore * 0.3 + specificityScore * 0.25 + structureScore * 0.2 + seoScore * 0.15 + readabilityScore * 0.1);
+    const passes = composite >= 70;
+    let grade = "F";
+    if (composite >= 90)
+      grade = "A+";
+    else if (composite >= 80)
+      grade = "A";
+    else if (composite >= 70)
+      grade = "B";
+    else if (composite >= 55)
+      grade = "C";
+    const topFixes = [
+      ...structureIssues,
+      ...seoIssues,
+      ...readIssues
+    ];
+    if (specificityScore < 70) {
+      topFixes.push("Inject verified data points (specific dollar amounts, percentage improvements, dates) instead of vague generalities.");
+    }
+    if (humanityScore < 70) {
+      topFixes.push("Adopt a conversational tone: add contractions (you're, it's), rhetorical questions, and casual transition words.");
+    }
+    return {
+      compositeScore: composite,
+      passesQualityThreshold: passes,
+      grade,
+      dimensions: {
+        humanity: {
+          score: humanityScore,
+          weight: 0.3,
+          weightedScore: Math.round(humanityScore * 0.3),
+          strengths: humanityScore >= 75 ? ["Conversational tone", "Natural pacing"] : [],
+          issues: humanityScore < 75 ? ["Sounds slightly robotic or formal"] : []
+        },
+        specificity: {
+          score: specificityScore,
+          weight: 0.25,
+          weightedScore: Math.round(specificityScore * 0.25),
+          strengths: specificityScore >= 75 ? ["High hard-data density", "Concrete benchmarks"] : [],
+          issues: specificityScore < 75 ? ["Excessive vague words (many, several, often)"] : []
+        },
+        structureBalance: {
+          score: structureScore,
+          weight: 0.2,
+          weightedScore: Math.round(structureScore * 0.2),
+          strengths: structureScore >= 75 ? ["Balanced mix of prose and scannable lists"] : [],
+          issues: structureIssues
+        },
+        seoCompliance: {
+          score: seoScore,
+          weight: 0.15,
+          weightedScore: Math.round(seoScore * 0.15),
+          strengths: seoScore >= 75 ? ["Proper H1/H2 hierarchy"] : [],
+          issues: seoIssues
+        },
+        readability: {
+          score: readabilityScore,
+          weight: 0.1,
+          weightedScore: Math.round(readabilityScore * 0.1),
+          strengths: readabilityScore >= 75 ? ["Punchy sentence lengths"] : [],
+          issues: readIssues
+        }
+      },
+      proseToListRatio: proseRatio,
+      topPriorityFixes: topFixes
+    };
+  }
+  static emptyReport() {
+    return {
+      compositeScore: 0,
+      passesQualityThreshold: false,
+      grade: "F",
+      dimensions: {
+        humanity: { score: 0, weight: 0.3, weightedScore: 0, strengths: [], issues: [] },
+        specificity: { score: 0, weight: 0.25, weightedScore: 0, strengths: [], issues: [] },
+        structureBalance: { score: 0, weight: 0.2, weightedScore: 0, strengths: [], issues: [] },
+        seoCompliance: { score: 0, weight: 0.15, weightedScore: 0, strengths: [], issues: [] },
+        readability: { score: 0, weight: 0.1, weightedScore: 0, strengths: [], issues: [] }
+      },
+      proseToListRatio: 0,
+      topPriorityFixes: ["Provide text content to score."]
+    };
+  }
+}
+
+// src/landing-cro-checker.ts
+class LandingCroChecker {
+  static auditLandingPage(content, config = {}) {
+    const checks = [];
+    const lines = content.split(`
+`).map((l) => l.trim()).filter(Boolean);
+    const h1 = lines.find((l) => l.startsWith("# "))?.replace("# ", "") || "";
+    const h1Words = h1.split(/\s+/).filter(Boolean).length;
+    const isH1Clear = h1Words >= 4 && h1Words <= 14;
+    checks.push({
+      id: "h1_length",
+      name: "Headline Length & Outcome Focus",
+      category: "headline",
+      passed: isH1Clear,
+      importance: "critical",
+      feedback: isH1Clear ? "H1 is clear, outcome-focused, and scannable in < 3s." : "H1 is missing or too long/vague."
+    });
+    const hasValueProp = /save|boost|cut|grow|automate|increase|réduire|augmenter|gagner/i.test(content);
+    checks.push({
+      id: "value_prop_benefit",
+      name: "Concrete Benefit & Outcome",
+      category: "value_prop",
+      passed: hasValueProp,
+      importance: "critical",
+      feedback: hasValueProp ? "Explicit outcome/benefit articulated in content." : "Lacks explicit outcome/benefit statements."
+    });
+    const hasReviews = /rated|reviews?|avis|clients?|customers?|businesses?|\d{1,3}(?:,\d{3})*\+/i.test(content);
+    checks.push({
+      id: "social_proof_ratings",
+      name: "Customer Reviews & Numbers",
+      category: "social_proof",
+      passed: hasReviews,
+      importance: "important",
+      feedback: hasReviews ? "Social proof count or star rating present." : "No social proof numbers found."
+    });
+    const hasActionCta = /(?:start|try|get|claim|démarrer|essayer|profiter|obtenir)\s+(?:free|trial|now|today|gratuit)/i.test(content);
+    checks.push({
+      id: "cta_action_verb",
+      name: "High-Contrast Outcome CTA",
+      category: "ctas",
+      passed: hasActionCta,
+      importance: "critical",
+      feedback: hasActionCta ? "High-converting action verb present in CTA." : "CTA is generic or missing action verb."
+    });
+    const hasFaq = /faq|frequently asked|questions|foire aux questions/i.test(content);
+    checks.push({
+      id: "faq_objection_handling",
+      name: "Objection Handling & FAQ Section",
+      category: "objection_handling",
+      passed: hasFaq,
+      importance: "important",
+      feedback: hasFaq ? "FAQ section handles user hesitations." : "Missing FAQ / objection handling section."
+    });
+    const hasRiskReversal = /no credit card|cancel anytime|money-back|sans carte|sans engagement|garantie/i.test(content);
+    checks.push({
+      id: "risk_reversal_guarantee",
+      name: "Zero-Risk Micro-Copy",
+      category: "risk_reversal",
+      passed: hasRiskReversal,
+      importance: "important",
+      feedback: hasRiskReversal ? "Risk reversal micro-copy found near CTA." : "No risk reversal guarantee found."
+    });
+    const hasUrgency = /today|now|instant|limited|aujourd'hui|maintenant|immédiat/i.test(content);
+    checks.push({
+      id: "urgency_trigger",
+      name: "Immediate Access & Momentum",
+      category: "urgency",
+      passed: hasUrgency,
+      importance: "enhancement",
+      feedback: hasUrgency ? "Presents immediate access momentum." : "Lacks urgency or immediacy trigger."
+    });
+    const hasSubheadings = lines.filter((l) => l.startsWith("## ")).length >= 3;
+    checks.push({
+      id: "structure_scannability",
+      name: "Visual Hierarchy & H2 Subheadings",
+      category: "structure",
+      passed: hasSubheadings,
+      importance: "important",
+      feedback: hasSubheadings ? "Clean visual hierarchy with 3+ H2 sections." : "Fewer than 3 H2 subheadings found."
+    });
+    const totalChecks = checks.length;
+    const passedChecks = checks.filter((c) => c.passed).length;
+    const criticalFailures = checks.filter((c) => !c.passed && c.importance === "critical");
+    const warnings = checks.filter((c) => !c.passed && c.importance === "important");
+    const overallCroScore = Math.round(passedChecks / totalChecks * 100);
+    const passes = overallCroScore >= 70 && criticalFailures.length === 0;
+    let grade = "F";
+    if (overallCroScore >= 90)
+      grade = "A+";
+    else if (overallCroScore >= 80)
+      grade = "A";
+    else if (overallCroScore >= 70)
+      grade = "B";
+    else if (overallCroScore >= 55)
+      grade = "C";
+    const categoryScores = {};
+    for (const check of checks) {
+      if (!categoryScores[check.category]) {
+        categoryScores[check.category] = { score: 0, passedCount: 0, totalCount: 0 };
+      }
+      categoryScores[check.category].totalCount++;
+      if (check.passed)
+        categoryScores[check.category].passedCount++;
+    }
+    for (const cat in categoryScores) {
+      categoryScores[cat].score = Math.round(categoryScores[cat].passedCount / categoryScores[cat].totalCount * 100);
+    }
+    const roadmap = checks.filter((c) => !c.passed).map((c) => `[${c.importance.toUpperCase()}] ${c.category}: ${c.feedback}`);
+    return {
+      overallCroScore,
+      passesCroAudit: passes,
+      grade,
+      criticalFailuresCount: criticalFailures.length,
+      warningsCount: warnings.length,
+      checks,
+      categoryScores,
+      conversionRoadmap: roadmap
+    };
+  }
+}
+
+// src/social-community-insights.ts
+class SocialCommunityInsightsAggregator {
+  static aggregate(topic, rawInsights) {
+    const painPoints = [];
+    const realLanguage = [];
+    const quotables = [];
+    for (const item of rawInsights) {
+      if (item.type === "pain_point" || item.type === "complaint") {
+        if (!painPoints.includes(item.quotableText)) {
+          painPoints.push(item.quotableText);
+        }
+      }
+      if (item.quotableText) {
+        quotables.push(`"${item.quotableText}" (${item.source})`);
+      }
+      for (const phrase of item.userVocabulary) {
+        if (!realLanguage.includes(phrase)) {
+          realLanguage.push(phrase);
+        }
+      }
+    }
+    const recommendedAngle = painPoints.length > 0 ? `Address the #1 community frustration: "${painPoints[0]}" by demonstrating immediate resolution in the hero hook.` : `Highlight community-tested best practices and back every recommendation with verified user metrics.`;
+    return {
+      topic,
+      totalInsights: rawInsights.length,
+      painPoints,
+      realLanguagePhrases: realLanguage,
+      quotableExcerpts: quotables,
+      recommendedAngleForCopy: recommendedAngle
+    };
+  }
+}
+
 // src/index.ts
 function createLynxSeoEngine(config) {
   return new LynxSeoEngine(config);
@@ -11074,6 +11391,9 @@ var LynxSeo = {
   competitorGap: CompetitorGapBlueprintEngine,
   engagementHook: EngagementHookAnalyzer,
   keywordDensity: KeywordDensityGuard,
+  contentQuality: ContentQualityScorer,
+  landingCroChecker: LandingCroChecker,
+  socialInsights: SocialCommunityInsightsAggregator,
   inspectMeta: SiteAuditor.inspectMeta,
   crawlDomain: DeepCrawlerAuditor.crawlAndAuditDomain,
   inspectHtmlSnapshot: DeepCrawlerAuditor.inspectHtmlSnapshot,
@@ -11140,6 +11460,7 @@ export {
   SocialVideoSeoAnalyticsEngine,
   SocialTrendSeoGenerator,
   SocialGrowthSuite,
+  SocialCommunityInsightsAggregator,
   SocialAdsSocialSeoEngine,
   SiteAuditor,
   SerpRankHistoryEngine,
@@ -11177,6 +11498,7 @@ export {
   LynxAnalyticsClient,
   LlmContentCleaner,
   LegalDisclaimerEngine,
+  LandingCroChecker,
   LagoTokenMeter,
   KnowledgeGraphLinker,
   KnowledgeBankBuilder,
@@ -11204,6 +11526,7 @@ export {
   CroCopywritingEngine,
   CopywritingFrameworksMaster,
   ContextTemplatesGenerator,
+  ContentQualityScorer,
   CompetitorGapBlueprintEngine,
   CONTENT_AI_40_TOOLS,
   BrandDnaCalendarEngine,

package/dist/landing-cro-checker.d.ts

@@ -0,0 +1,36 @@
+/**
+ * 📊 Comprehensive Landing Page CRO Checker
+ * Ported & optimized from Python cro_checker.py (23 KB).
+ * Evaluates 8 landing page conversion categories with pass/fail criteria and grade rating.
+ */
+export interface CroCheckItem {
+    id: string;
+    name: string;
+    category: "headline" | "value_prop" | "social_proof" | "ctas" | "objection_handling" | "risk_reversal" | "urgency" | "structure";
+    passed: boolean;
+    importance: "critical" | "important" | "enhancement";
+    feedback: string;
+}
+export interface LandingCroAuditResult {
+    overallCroScore: number;
+    passesCroAudit: boolean;
+    grade: "A+" | "A" | "B" | "C" | "F";
+    criticalFailuresCount: number;
+    warningsCount: number;
+    checks: CroCheckItem[];
+    categoryScores: Record<string, {
+        score: number;
+        passedCount: number;
+        totalCount: number;
+    }>;
+    conversionRoadmap: string[];
+}
+export declare class LandingCroChecker {
+    /**
+     * Runs the 8-category CRO checklist against landing page content or markup.
+     */
+    static auditLandingPage(content: string, config?: {
+        pageType?: "seo" | "ppc";
+        conversionGoal?: "trial" | "demo" | "lead";
+    }): LandingCroAuditResult;
+}

package/dist/social-community-insights.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 👥 Social Community Insights & Real-Voice Vocabulary Aggregator
+ * Ported & optimized from Python social_research_aggregator.py.
+ * Aggregates pain points, success stories, and authentic user vocabulary from Reddit, YouTube, and community forums.
+ */
+export interface CommunityInsightItem {
+    source: "reddit" | "youtube" | "community_forum";
+    type: "pain_point" | "success_story" | "complaint" | "recommendation" | "real_slang";
+    titleOrThread: string;
+    quotableText: string;
+    userVocabulary: string[];
+    upvotesOrViews?: number;
+}
+export interface CommunityResearchSummary {
+    topic: string;
+    totalInsights: number;
+    painPoints: string[];
+    realLanguagePhrases: string[];
+    quotableExcerpts: string[];
+    recommendedAngleForCopy: string;
+}
+export declare class SocialCommunityInsightsAggregator {
+    /**
+     * Aggregates social insights and structures high-converting copywriting angles.
+     */
+    static aggregate(topic: string, rawInsights: CommunityInsightItem[]): CommunityResearchSummary;
+}

package/package.json

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