@lynxflow/seo-engine 1.6.2 → 1.6.3

package/dist/free-public-tools.d.ts

@@ -0,0 +1,74 @@
+/**
+ * 🛠️ Free Public Interactive Tools & Lead Magnets Suite
+ * Inspired by Ahrefs, Semrush, Moz, and WordStream free tool ecosystems.
+ *
+ * Provides 6 zero-dependency interactive calculators and simulators that can be embedded
+ * on public programmatic pages to maximize dwell time, engagement, backlink acquisition, and user conversion.
+ */
+export interface SerpSimulatorResult {
+    title: string;
+    truncatedTitle: string;
+    titlePixelWidth: number;
+    isTitleTruncated: boolean;
+    description: string;
+    truncatedDescription: string;
+    isDescriptionTruncated: boolean;
+    urlPreview: string;
+    estimatedCtrScore: number;
+    recommendations: string[];
+}
+export interface RoiCalculatorResult {
+    hoursSavedWeekly: number;
+    hoursSavedMonthly: number;
+    monthlyCostSavings: number;
+    annualCostSavings: number;
+    roiPercentage: number;
+    breakEvenDays: number;
+}
+export interface DensityAnalysisResult {
+    totalWords: number;
+    characterCount: number;
+    readingTimeMinutes: number;
+    topKeywords: {
+        word: string;
+        count: number;
+        densityPercent: number;
+    }[];
+    seoReadabilityScore: number;
+}
+export declare class FreePublicToolsEngine {
+    /**
+     * 1. Google SERP Preview & CTR Optimizer Simulator (Ahrefs / Moz Parity)
+     */
+    static simulateSerpSnippet(input: {
+        title: string;
+        description: string;
+        url: string;
+        targetKeyword?: string;
+    }): SerpSimulatorResult;
+    /**
+     * 2. Free ROI & Time-Saved Automation Calculator
+     */
+    static calculateRoi(input: {
+        hoursSpentPerWeek: number;
+        hourlyRateOrSalary: number;
+        teamMembersCount?: number;
+        softwareMonthlyPrice?: number;
+    }): RoiCalculatorResult;
+    /**
+     * 3. Instant Keyword Density & Readability Analyzer
+     */
+    static analyzeTextDensity(text: string, language?: string): DensityAnalysisResult;
+    /**
+     * 4. Free SEO Slug Cleanser Helper
+     */
+    static cleanSlugTool(input: string, lang?: string): {
+        original: string;
+        cleanSlug: string;
+        charSavings: number;
+    };
+    /**
+     * 5. Free Schema.org Generator Helper
+     */
+    static generateSampleSchema(type: "localBusiness" | "softwareApp" | "faq", name: string, url: string): Record<string, unknown>;
+}

package/dist/index.d.ts

@@ -18,6 +18,7 @@ export * from "./i18n-detector";
 export * from "./brand-icons";
 export * from "./ui-icons";
 export * from "./og-image-generator";
+export * from "./free-public-tools";
 export * from "./urlytics-engine";
 export * from "./keyword-permutator";
 export * from "./llm-prompt";

package/dist/index.js

@@ -92,6 +92,7 @@ __export(exports_src, {
   I18nDetector: () => I18nDetector,
   HyperswitchGateway: () => HyperswitchGateway,
   GeoMeshLinkingEngine: () => GeoMeshLinkingEngine,
+  FreePublicToolsEngine: () => FreePublicToolsEngine,
   ExtendedSchemaGraphBuilder: () => ExtendedSchemaGraphBuilder,
   EmbeddableSeoWidgetGenerator: () => EmbeddableSeoWidgetGenerator,
   DeepCrawlerAuditor: () => DeepCrawlerAuditor,
@@ -3926,6 +3927,38 @@ class PseoMatrixEngine {
     }
     if (data.calculators) {
       allPages.push(...this.generateCalculatorMatrix(domain, data.calculators, options));
+    } else if (options.enableFreeTools !== false) {
+      const defaultCalculators = [
+        {
+          slug: "serp-preview-simulator",
+          title: "Google SERP Snippet Preview & CTR Simulator",
+          formulaDescription: "Simulate desktop and mobile Google search appearance and optimize CTR",
+          savingsMetric: "Search Click-Through Rate",
+          inputs: ["pageTitle", "metaDescription", "targetKeyword"]
+        },
+        {
+          slug: "roi-calculator",
+          title: "Automation ROI & Time-Saved Calculator",
+          formulaDescription: "Calculate weekly operational hours recovered and monthly budget saved",
+          savingsMetric: "Monthly Net Financial Savings",
+          inputs: ["hoursSpentWeekly", "hourlyRate", "teamMembers"]
+        },
+        {
+          slug: "seo-slug-generator",
+          title: "SEO URL Slug Cleaner & Optimizer",
+          formulaDescription: "Strip stop words, dates, and noise characters for high-CTR clean URLs",
+          savingsMetric: "URL Cleanliness & Readability",
+          inputs: ["rawTitle", "language"]
+        },
+        {
+          slug: "keyword-density-checker",
+          title: "Live Keyword Density & Readability Analyzer",
+          formulaDescription: "Analyze n-gram frequency, reading time, and content depth",
+          savingsMetric: "Content Optimization Score",
+          inputs: ["articleText"]
+        }
+      ];
+      allPages.push(...this.generateCalculatorMatrix(domain, defaultCalculators, options));
     }
     for (const p of allPages) {
       if (!p.ogImageUrl) {
@@ -4288,6 +4321,140 @@ function resolveFeatureIcon(featureText) {
   }
   return "zap";
 }
+// src/free-public-tools.ts
+class FreePublicToolsEngine {
+  static simulateSerpSnippet(input) {
+    const title = (input.title || "").trim();
+    const description = (input.description || "").trim();
+    const url = (input.url || "https://example.com").trim();
+    const kw = (input.targetKeyword || "").toLowerCase().trim();
+    const titlePixelWidth = title.length * 9.5;
+    const maxTitlePixels = 580;
+    const maxDescChars = 158;
+    const isTitleTruncated = titlePixelWidth > maxTitlePixels;
+    const truncatedTitle = isTitleTruncated ? title.slice(0, 56) + "..." : title;
+    const isDescriptionTruncated = description.length > maxDescChars;
+    const truncatedDescription = isDescriptionTruncated ? description.slice(0, 155) + "..." : description;
+    let ctrScore = 50;
+    const recommendations = [];
+    if (title.length >= 40 && title.length <= 60) {
+      ctrScore += 20;
+    } else if (title.length < 30) {
+      recommendations.push("Le titre est trop court (< 30 car.). Ajoutez des précisions pour booster le clic.");
+    } else if (isTitleTruncated) {
+      ctrScore -= 10;
+      recommendations.push("Le titre dépasse 580px et sera tronqué sur Google Desktop.");
+    }
+    if (kw && title.toLowerCase().includes(kw)) {
+      ctrScore += 15;
+    } else if (kw) {
+      recommendations.push(`Le mot-clé principal "${kw}" est absent du titre.`);
+    }
+    if (description.length >= 120 && description.length <= 158) {
+      ctrScore += 15;
+    } else if (description.length < 80) {
+      recommendations.push("La méta-description est trop courte (< 80 car.).");
+    }
+    return {
+      title,
+      truncatedTitle,
+      titlePixelWidth: Math.round(titlePixelWidth),
+      isTitleTruncated,
+      description,
+      truncatedDescription,
+      isDescriptionTruncated,
+      urlPreview: url,
+      estimatedCtrScore: Math.min(Math.max(ctrScore, 10), 100),
+      recommendations
+    };
+  }
+  static calculateRoi(input) {
+    const hours = Math.max(input.hoursSpentPerWeek || 5, 1);
+    const rate = Math.max(input.hourlyRateOrSalary || 35, 1);
+    const team = Math.max(input.teamMembersCount || 1, 1);
+    const softwareCost = input.softwareMonthlyPrice ?? 49;
+    const hoursSavedWeekly = Math.round(hours * 0.75 * team * 10) / 10;
+    const hoursSavedMonthly = Math.round(hoursSavedWeekly * 4.33);
+    const monthlyGrossSavings = hoursSavedMonthly * rate;
+    const monthlyNetSavings = Math.max(monthlyGrossSavings - softwareCost, 0);
+    const annualCostSavings = monthlyNetSavings * 12;
+    const roiPercentage = softwareCost > 0 ? Math.round(monthlyNetSavings / softwareCost * 100) : 1000;
+    const breakEvenDays = monthlyGrossSavings > 0 ? Math.max(Math.round(softwareCost / (monthlyGrossSavings / 30)), 1) : 30;
+    return {
+      hoursSavedWeekly,
+      hoursSavedMonthly,
+      monthlyCostSavings: Math.round(monthlyNetSavings),
+      annualCostSavings: Math.round(annualCostSavings),
+      roiPercentage,
+      breakEvenDays
+    };
+  }
+  static analyzeTextDensity(text, language = "fr") {
+    if (!text || typeof text !== "string") {
+      return { totalWords: 0, characterCount: 0, readingTimeMinutes: 0, topKeywords: [], seoReadabilityScore: 0 };
+    }
+    const clean = text.toLowerCase().replace(/[^a-z0-9à-ÿ\s]/g, " ");
+    const words = clean.split(/\s+/).filter((w) => w.length > 2);
+    const totalWords = words.length;
+    const characterCount = text.length;
+    const readingTimeMinutes = Math.max(Math.round(totalWords / 200 * 10) / 10, 0.5);
+    const stopWords = new Set(["pour", "dans", "avec", "sur", "les", "des", "une", "que", "qui", "est", "par", "the", "and", "for", "with", "this", "that"]);
+    const frequencyMap = new Map;
+    for (const w of words) {
+      if (!stopWords.has(w)) {
+        frequencyMap.set(w, (frequencyMap.get(w) || 0) + 1);
+      }
+    }
+    const sorted = Array.from(frequencyMap.entries()).sort((a, b) => b[1] - a[1]);
+    const topKeywords = sorted.slice(0, 8).map(([word, count]) => ({
+      word,
+      count,
+      densityPercent: totalWords > 0 ? Math.round(count / totalWords * 1000) / 10 : 0
+    }));
+    let seoReadabilityScore = 70;
+    if (totalWords >= 600)
+      seoReadabilityScore += 20;
+    else if (totalWords < 300)
+      seoReadabilityScore -= 25;
+    return {
+      totalWords,
+      characterCount,
+      readingTimeMinutes,
+      topKeywords,
+      seoReadabilityScore: Math.min(Math.max(seoReadabilityScore, 10), 100)
+    };
+  }
+  static cleanSlugTool(input, lang = "fr") {
+    const clean = cleanSeoSlug(input, { language: lang });
+    return {
+      original: input,
+      cleanSlug: clean,
+      charSavings: Math.max(input.length - clean.length, 0)
+    };
+  }
+  static generateSampleSchema(type, name, url) {
+    if (type === "localBusiness") {
+      return ExtendedSchemaGraphBuilder.buildLocalBusiness({
+        name,
+        url,
+        city: "Paris",
+        country: "France"
+      });
+    }
+    if (type === "faq") {
+      return ExtendedSchemaGraphBuilder.buildFAQPage([
+        { question: `Comment fonctionne ${name} ?`, answer: `${name} automatise vos opérations en quelques clics.` },
+        { question: `Quel est le tarif de ${name} ?`, answer: `Un essai gratuit de 14 jours est disponible sans carte bancaire.` }
+      ]);
+    }
+    return ExtendedSchemaGraphBuilder.buildSoftwareApplication({
+      name,
+      description: `Solution logicielle professionnelle ${name}`,
+      url,
+      priceMonthly: 29
+    });
+  }
+}
 // src/urlytics-engine.ts
 class UrlyticsEngine {
   static parseUrl(rawUrl) {
@@ -4706,22 +4873,26 @@ The SDK equips applications with 9 enterprise-grade SEO engines:
    - \`renderDynamicOgSvg(opts)\`: Generates high-converting 1200x630 SVG social cards with glassmorphism badges, star ratings, and gradient backdrops.
    - \`generateOgImageUrl(domain, pageMeta, brandName)\`: Edge-ready query URL for \`app/api/og/route.ts\`.
 
-7. **\uD83C\uDFDB️ Google Schema.org Rich Graphs (\`ExtendedSchemaGraphBuilder\`):**
+7. **\uD83D\uDEE0️ Free Public Interactive Tools & Lead Magnets (\`FreePublicToolsEngine\`):**
+   - Ahrefs/Semrush-style high-intent public calculators: Google SERP Preview Simulator, Automation ROI Calculator, Keyword Density Analyzer, and Schema.org Generator.
+   - Boosts dwell time, organic backlinks, and visitor-to-customer conversion.
+
+8. **\uD83C\uDFDB️ Google Schema.org Rich Graphs (\`ExtendedSchemaGraphBuilder\`):**
    - \`buildAggregateRating\` (Google Gold Stars 4.9★), \`buildAggregateOffer\` (price ranges), \`buildLocalBusiness\` (GPS & opening hours), \`buildSoftwareApplication\`, \`buildHowTo\`, \`buildFAQPage\`, \`buildBreadcrumbs\`.
 
-8. **\uD83D\uDD0D URL Decomposition & Analysis (\`UrlyticsEngine\`):**
+9. **\uD83D\uDD0D URL Decomposition & Analysis (\`UrlyticsEngine\`):**
    - Deep structural directory decomposition, depth tracking, query parameter analysis, and slug tokenization (inspired by advertools).
 
-9. **⚡ SEM Keyword Combinator (\`KeywordPermutatorEngine\`):**
+10. **⚡ SEM Keyword Combinator (\`KeywordPermutatorEngine\`):**
    - Combinatorial matrix generation: Products × Modifiers × Locations with match types (\`[exact]\`, \`"phrase"\`, \`+broad\`) and intent classification.
 
-10. **⚖️ Legal & Editorial Compliance (\`LegalDisclaimerEngine\`):**
+11. **⚖️ Legal & Editorial Compliance (\`LegalDisclaimerEngine\`):**
    - 7 SeedRank-grade disclaimer templates, 90-day staleness verification, and multi-language anti-disparagement guardian.
 
-11. **\uD83D\uDCCA Telemetry & Cloud Metering (\`matrixEngine.getTelemetryPayload\` & \`LynxAnalyticsClient\`):**
+12. **\uD83D\uDCCA Telemetry & Cloud Metering (\`matrixEngine.getTelemetryPayload\` & \`LynxAnalyticsClient\`):**
    - Synchronizes total programmatic pages, indexed hubs, and AI bot crawl hits (GPTBot, ClaudeBot, PerplexityBot) with the LynxSEO Studio dashboard.
 
-12. **\uD83E\uDDF9 URL Slug Engine & Schema.org Graphs:**
+13. **\uD83E\uDDF9 URL Slug Engine & Schema.org Graphs:**
    - \`cleanSeoSlug(text, { language })\`: Strips accents, stop words across 10+ languages, and non-alphanumeric noise.
    - Outputs Google-validated Schema.org JSON-LD graphs with 0 syntax errors.
 `.trim();

package/dist/index.mjs

@@ -3815,6 +3815,38 @@ class PseoMatrixEngine {
     }
     if (data.calculators) {
       allPages.push(...this.generateCalculatorMatrix(domain, data.calculators, options));
+    } else if (options.enableFreeTools !== false) {
+      const defaultCalculators = [
+        {
+          slug: "serp-preview-simulator",
+          title: "Google SERP Snippet Preview & CTR Simulator",
+          formulaDescription: "Simulate desktop and mobile Google search appearance and optimize CTR",
+          savingsMetric: "Search Click-Through Rate",
+          inputs: ["pageTitle", "metaDescription", "targetKeyword"]
+        },
+        {
+          slug: "roi-calculator",
+          title: "Automation ROI & Time-Saved Calculator",
+          formulaDescription: "Calculate weekly operational hours recovered and monthly budget saved",
+          savingsMetric: "Monthly Net Financial Savings",
+          inputs: ["hoursSpentWeekly", "hourlyRate", "teamMembers"]
+        },
+        {
+          slug: "seo-slug-generator",
+          title: "SEO URL Slug Cleaner & Optimizer",
+          formulaDescription: "Strip stop words, dates, and noise characters for high-CTR clean URLs",
+          savingsMetric: "URL Cleanliness & Readability",
+          inputs: ["rawTitle", "language"]
+        },
+        {
+          slug: "keyword-density-checker",
+          title: "Live Keyword Density & Readability Analyzer",
+          formulaDescription: "Analyze n-gram frequency, reading time, and content depth",
+          savingsMetric: "Content Optimization Score",
+          inputs: ["articleText"]
+        }
+      ];
+      allPages.push(...this.generateCalculatorMatrix(domain, defaultCalculators, options));
     }
     for (const p of allPages) {
       if (!p.ogImageUrl) {
@@ -4177,6 +4209,140 @@ function resolveFeatureIcon(featureText) {
   }
   return "zap";
 }
+// src/free-public-tools.ts
+class FreePublicToolsEngine {
+  static simulateSerpSnippet(input) {
+    const title = (input.title || "").trim();
+    const description = (input.description || "").trim();
+    const url = (input.url || "https://example.com").trim();
+    const kw = (input.targetKeyword || "").toLowerCase().trim();
+    const titlePixelWidth = title.length * 9.5;
+    const maxTitlePixels = 580;
+    const maxDescChars = 158;
+    const isTitleTruncated = titlePixelWidth > maxTitlePixels;
+    const truncatedTitle = isTitleTruncated ? title.slice(0, 56) + "..." : title;
+    const isDescriptionTruncated = description.length > maxDescChars;
+    const truncatedDescription = isDescriptionTruncated ? description.slice(0, 155) + "..." : description;
+    let ctrScore = 50;
+    const recommendations = [];
+    if (title.length >= 40 && title.length <= 60) {
+      ctrScore += 20;
+    } else if (title.length < 30) {
+      recommendations.push("Le titre est trop court (< 30 car.). Ajoutez des précisions pour booster le clic.");
+    } else if (isTitleTruncated) {
+      ctrScore -= 10;
+      recommendations.push("Le titre dépasse 580px et sera tronqué sur Google Desktop.");
+    }
+    if (kw && title.toLowerCase().includes(kw)) {
+      ctrScore += 15;
+    } else if (kw) {
+      recommendations.push(`Le mot-clé principal "${kw}" est absent du titre.`);
+    }
+    if (description.length >= 120 && description.length <= 158) {
+      ctrScore += 15;
+    } else if (description.length < 80) {
+      recommendations.push("La méta-description est trop courte (< 80 car.).");
+    }
+    return {
+      title,
+      truncatedTitle,
+      titlePixelWidth: Math.round(titlePixelWidth),
+      isTitleTruncated,
+      description,
+      truncatedDescription,
+      isDescriptionTruncated,
+      urlPreview: url,
+      estimatedCtrScore: Math.min(Math.max(ctrScore, 10), 100),
+      recommendations
+    };
+  }
+  static calculateRoi(input) {
+    const hours = Math.max(input.hoursSpentPerWeek || 5, 1);
+    const rate = Math.max(input.hourlyRateOrSalary || 35, 1);
+    const team = Math.max(input.teamMembersCount || 1, 1);
+    const softwareCost = input.softwareMonthlyPrice ?? 49;
+    const hoursSavedWeekly = Math.round(hours * 0.75 * team * 10) / 10;
+    const hoursSavedMonthly = Math.round(hoursSavedWeekly * 4.33);
+    const monthlyGrossSavings = hoursSavedMonthly * rate;
+    const monthlyNetSavings = Math.max(monthlyGrossSavings - softwareCost, 0);
+    const annualCostSavings = monthlyNetSavings * 12;
+    const roiPercentage = softwareCost > 0 ? Math.round(monthlyNetSavings / softwareCost * 100) : 1000;
+    const breakEvenDays = monthlyGrossSavings > 0 ? Math.max(Math.round(softwareCost / (monthlyGrossSavings / 30)), 1) : 30;
+    return {
+      hoursSavedWeekly,
+      hoursSavedMonthly,
+      monthlyCostSavings: Math.round(monthlyNetSavings),
+      annualCostSavings: Math.round(annualCostSavings),
+      roiPercentage,
+      breakEvenDays
+    };
+  }
+  static analyzeTextDensity(text, language = "fr") {
+    if (!text || typeof text !== "string") {
+      return { totalWords: 0, characterCount: 0, readingTimeMinutes: 0, topKeywords: [], seoReadabilityScore: 0 };
+    }
+    const clean = text.toLowerCase().replace(/[^a-z0-9à-ÿ\s]/g, " ");
+    const words = clean.split(/\s+/).filter((w) => w.length > 2);
+    const totalWords = words.length;
+    const characterCount = text.length;
+    const readingTimeMinutes = Math.max(Math.round(totalWords / 200 * 10) / 10, 0.5);
+    const stopWords = new Set(["pour", "dans", "avec", "sur", "les", "des", "une", "que", "qui", "est", "par", "the", "and", "for", "with", "this", "that"]);
+    const frequencyMap = new Map;
+    for (const w of words) {
+      if (!stopWords.has(w)) {
+        frequencyMap.set(w, (frequencyMap.get(w) || 0) + 1);
+      }
+    }
+    const sorted = Array.from(frequencyMap.entries()).sort((a, b) => b[1] - a[1]);
+    const topKeywords = sorted.slice(0, 8).map(([word, count]) => ({
+      word,
+      count,
+      densityPercent: totalWords > 0 ? Math.round(count / totalWords * 1000) / 10 : 0
+    }));
+    let seoReadabilityScore = 70;
+    if (totalWords >= 600)
+      seoReadabilityScore += 20;
+    else if (totalWords < 300)
+      seoReadabilityScore -= 25;
+    return {
+      totalWords,
+      characterCount,
+      readingTimeMinutes,
+      topKeywords,
+      seoReadabilityScore: Math.min(Math.max(seoReadabilityScore, 10), 100)
+    };
+  }
+  static cleanSlugTool(input, lang = "fr") {
+    const clean = cleanSeoSlug(input, { language: lang });
+    return {
+      original: input,
+      cleanSlug: clean,
+      charSavings: Math.max(input.length - clean.length, 0)
+    };
+  }
+  static generateSampleSchema(type, name, url) {
+    if (type === "localBusiness") {
+      return ExtendedSchemaGraphBuilder.buildLocalBusiness({
+        name,
+        url,
+        city: "Paris",
+        country: "France"
+      });
+    }
+    if (type === "faq") {
+      return ExtendedSchemaGraphBuilder.buildFAQPage([
+        { question: `Comment fonctionne ${name} ?`, answer: `${name} automatise vos opérations en quelques clics.` },
+        { question: `Quel est le tarif de ${name} ?`, answer: `Un essai gratuit de 14 jours est disponible sans carte bancaire.` }
+      ]);
+    }
+    return ExtendedSchemaGraphBuilder.buildSoftwareApplication({
+      name,
+      description: `Solution logicielle professionnelle ${name}`,
+      url,
+      priceMonthly: 29
+    });
+  }
+}
 // src/urlytics-engine.ts
 class UrlyticsEngine {
   static parseUrl(rawUrl) {
@@ -4595,22 +4761,26 @@ The SDK equips applications with 9 enterprise-grade SEO engines:
    - \`renderDynamicOgSvg(opts)\`: Generates high-converting 1200x630 SVG social cards with glassmorphism badges, star ratings, and gradient backdrops.
    - \`generateOgImageUrl(domain, pageMeta, brandName)\`: Edge-ready query URL for \`app/api/og/route.ts\`.
 
-7. **\uD83C\uDFDB️ Google Schema.org Rich Graphs (\`ExtendedSchemaGraphBuilder\`):**
+7. **\uD83D\uDEE0️ Free Public Interactive Tools & Lead Magnets (\`FreePublicToolsEngine\`):**
+   - Ahrefs/Semrush-style high-intent public calculators: Google SERP Preview Simulator, Automation ROI Calculator, Keyword Density Analyzer, and Schema.org Generator.
+   - Boosts dwell time, organic backlinks, and visitor-to-customer conversion.
+
+8. **\uD83C\uDFDB️ Google Schema.org Rich Graphs (\`ExtendedSchemaGraphBuilder\`):**
    - \`buildAggregateRating\` (Google Gold Stars 4.9★), \`buildAggregateOffer\` (price ranges), \`buildLocalBusiness\` (GPS & opening hours), \`buildSoftwareApplication\`, \`buildHowTo\`, \`buildFAQPage\`, \`buildBreadcrumbs\`.
 
-8. **\uD83D\uDD0D URL Decomposition & Analysis (\`UrlyticsEngine\`):**
+9. **\uD83D\uDD0D URL Decomposition & Analysis (\`UrlyticsEngine\`):**
    - Deep structural directory decomposition, depth tracking, query parameter analysis, and slug tokenization (inspired by advertools).
 
-9. **⚡ SEM Keyword Combinator (\`KeywordPermutatorEngine\`):**
+10. **⚡ SEM Keyword Combinator (\`KeywordPermutatorEngine\`):**
    - Combinatorial matrix generation: Products × Modifiers × Locations with match types (\`[exact]\`, \`"phrase"\`, \`+broad\`) and intent classification.
 
-10. **⚖️ Legal & Editorial Compliance (\`LegalDisclaimerEngine\`):**
+11. **⚖️ Legal & Editorial Compliance (\`LegalDisclaimerEngine\`):**
    - 7 SeedRank-grade disclaimer templates, 90-day staleness verification, and multi-language anti-disparagement guardian.
 
-11. **\uD83D\uDCCA Telemetry & Cloud Metering (\`matrixEngine.getTelemetryPayload\` & \`LynxAnalyticsClient\`):**
+12. **\uD83D\uDCCA Telemetry & Cloud Metering (\`matrixEngine.getTelemetryPayload\` & \`LynxAnalyticsClient\`):**
    - Synchronizes total programmatic pages, indexed hubs, and AI bot crawl hits (GPTBot, ClaudeBot, PerplexityBot) with the LynxSEO Studio dashboard.
 
-12. **\uD83E\uDDF9 URL Slug Engine & Schema.org Graphs:**
+13. **\uD83E\uDDF9 URL Slug Engine & Schema.org Graphs:**
    - \`cleanSeoSlug(text, { language })\`: Strips accents, stop words across 10+ languages, and non-alphanumeric noise.
    - Outputs Google-validated Schema.org JSON-LD graphs with 0 syntax errors.
 `.trim();
@@ -6811,6 +6981,7 @@ export {
   I18nDetector,
   HyperswitchGateway,
   GeoMeshLinkingEngine,
+  FreePublicToolsEngine,
   ExtendedSchemaGraphBuilder,
   EmbeddableSeoWidgetGenerator,
   DeepCrawlerAuditor,

package/dist/matrix-engine.d.ts

@@ -95,6 +95,7 @@ export interface PseoCalculator {
     title: string;
     formulaDescription: string;
     savingsMetric: string;
+    inputs?: string[];
 }
 export interface SchemaOrgGraph {
     "@context": "https://schema.org";
@@ -132,6 +133,7 @@ export interface MatrixOptions {
     countries?: string[] | string;
     territories?: string[] | string;
     cleanDirectRoutes?: boolean;
+    enableFreeTools?: boolean;
     minPopulationToIndex?: number;
     defaultCurrency?: string;
     defaultCurrencySymbol?: string;

package/package.json

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

package/src/engine.test.ts

@@ -10,6 +10,7 @@ import { renderBrandIconSvg } from "./brand-icons";
 import { I18nDetector } from "./i18n-detector";
 import { renderUiIconSvg, resolveFeatureIcon } from "./ui-icons";
 import { OgImageGenerator } from "./og-image-generator";
+import { FreePublicToolsEngine } from "./free-public-tools";
 
 describe("Multilingual SEO Slug Engine (10+ Languages)", () => {
   it("English: Strips stop words and years", () => {
@@ -306,4 +307,34 @@ describe("Audited Reference Engines (Advertools, Santifer, Seonaut)", () => {
     expect(page?.ogImageUrl).toContain("/api/og?");
     expect(page?.ogImageUrl).toContain("brand=Acme");
   });
+
+  it("FreePublicToolsEngine: Simulates SERP, calculates ROI, and analyzes density", () => {
+    const serp = FreePublicToolsEngine.simulateSerpSnippet({
+      title: "Autopost Facebook & Instagram Tool 2026",
+      description: "Automate your social media scheduling across all major networks with AI copilot and analytics.",
+      url: "https://acme.com/autopost-facebook",
+      targetKeyword: "autopost",
+    });
+    expect(serp.estimatedCtrScore).toBeGreaterThan(50);
+    expect(serp.titlePixelWidth).toBeGreaterThan(0);
+
+    const roi = FreePublicToolsEngine.calculateRoi({
+      hoursSpentPerWeek: 10,
+      hourlyRateOrSalary: 50,
+      teamMembersCount: 2,
+      softwareMonthlyPrice: 79,
+    });
+    expect(roi.monthlyCostSavings).toBeGreaterThan(1000);
+    expect(roi.roiPercentage).toBeGreaterThan(100);
+
+    const density = FreePublicToolsEngine.analyzeTextDensity(
+      "Autopost Facebook automatise vos réseaux sociaux. Notre outil autopost vous fait gagner du temps avec autopost.",
+      "fr",
+    );
+    expect(density.totalWords).toBeGreaterThan(5);
+    expect(density.topKeywords[0].word).toBe("autopost");
+
+    const schema = FreePublicToolsEngine.generateSampleSchema("softwareApp", "Acme", "https://acme.com");
+    expect(schema["@type"]).toBe("SoftwareApplication");
+  });
 });

package/src/free-public-tools.ts

@@ -0,0 +1,224 @@
+/**
+ * 🛠️ Free Public Interactive Tools & Lead Magnets Suite
+ * Inspired by Ahrefs, Semrush, Moz, and WordStream free tool ecosystems.
+ *
+ * Provides 6 zero-dependency interactive calculators and simulators that can be embedded
+ * on public programmatic pages to maximize dwell time, engagement, backlink acquisition, and user conversion.
+ */
+
+import { cleanSeoSlug } from "./slug-engine";
+import { ExtendedSchemaGraphBuilder } from "./extended-schemas";
+
+export interface SerpSimulatorResult {
+  title: string;
+  truncatedTitle: string;
+  titlePixelWidth: number;
+  isTitleTruncated: boolean;
+  description: string;
+  truncatedDescription: string;
+  isDescriptionTruncated: boolean;
+  urlPreview: string;
+  estimatedCtrScore: number; // 0 to 100
+  recommendations: string[];
+}
+
+export interface RoiCalculatorResult {
+  hoursSavedWeekly: number;
+  hoursSavedMonthly: number;
+  monthlyCostSavings: number;
+  annualCostSavings: number;
+  roiPercentage: number;
+  breakEvenDays: number;
+}
+
+export interface DensityAnalysisResult {
+  totalWords: number;
+  characterCount: number;
+  readingTimeMinutes: number;
+  topKeywords: { word: string; count: number; densityPercent: number }[];
+  seoReadabilityScore: number; // 0 to 100
+}
+
+export class FreePublicToolsEngine {
+  /**
+   * 1. Google SERP Preview & CTR Optimizer Simulator (Ahrefs / Moz Parity)
+   */
+  static simulateSerpSnippet(input: {
+    title: string;
+    description: string;
+    url: string;
+    targetKeyword?: string;
+  }): SerpSimulatorResult {
+    const title = (input.title || "").trim();
+    const description = (input.description || "").trim();
+    const url = (input.url || "https://example.com").trim();
+    const kw = (input.targetKeyword || "").toLowerCase().trim();
+
+    // Average pixel width estimation (approx 10px per char on Arial 20px)
+    const titlePixelWidth = title.length * 9.5;
+    const maxTitlePixels = 580; // Google Desktop breakpoint
+    const maxDescChars = 158;
+
+    const isTitleTruncated = titlePixelWidth > maxTitlePixels;
+    const truncatedTitle = isTitleTruncated ? title.slice(0, 56) + "..." : title;
+
+    const isDescriptionTruncated = description.length > maxDescChars;
+    const truncatedDescription = isDescriptionTruncated ? description.slice(0, 155) + "..." : description;
+
+    let ctrScore = 50;
+    const recommendations: string[] = [];
+
+    // Title checks
+    if (title.length >= 40 && title.length <= 60) {
+      ctrScore += 20;
+    } else if (title.length < 30) {
+      recommendations.push("Le titre est trop court (< 30 car.). Ajoutez des précisions pour booster le clic.");
+    } else if (isTitleTruncated) {
+      ctrScore -= 10;
+      recommendations.push("Le titre dépasse 580px et sera tronqué sur Google Desktop.");
+    }
+
+    // Keyword presence
+    if (kw && title.toLowerCase().includes(kw)) {
+      ctrScore += 15;
+    } else if (kw) {
+      recommendations.push(`Le mot-clé principal "${kw}" est absent du titre.`);
+    }
+
+    // Description checks
+    if (description.length >= 120 && description.length <= 158) {
+      ctrScore += 15;
+    } else if (description.length < 80) {
+      recommendations.push("La méta-description est trop courte (< 80 car.).");
+    }
+
+    return {
+      title,
+      truncatedTitle,
+      titlePixelWidth: Math.round(titlePixelWidth),
+      isTitleTruncated,
+      description,
+      truncatedDescription,
+      isDescriptionTruncated,
+      urlPreview: url,
+      estimatedCtrScore: Math.min(Math.max(ctrScore, 10), 100),
+      recommendations,
+    };
+  }
+
+  /**
+   * 2. Free ROI & Time-Saved Automation Calculator
+   */
+  static calculateRoi(input: {
+    hoursSpentPerWeek: number;
+    hourlyRateOrSalary: number;
+    teamMembersCount?: number;
+    softwareMonthlyPrice?: number;
+  }): RoiCalculatorResult {
+    const hours = Math.max(input.hoursSpentPerWeek || 5, 1);
+    const rate = Math.max(input.hourlyRateOrSalary || 35, 1);
+    const team = Math.max(input.teamMembersCount || 1, 1);
+    const softwareCost = input.softwareMonthlyPrice ?? 49;
+
+    // Assuming automation saves ~75% of manual operational time
+    const hoursSavedWeekly = Math.round(hours * 0.75 * team * 10) / 10;
+    const hoursSavedMonthly = Math.round(hoursSavedWeekly * 4.33);
+
+    const monthlyGrossSavings = hoursSavedMonthly * rate;
+    const monthlyNetSavings = Math.max(monthlyGrossSavings - softwareCost, 0);
+    const annualCostSavings = monthlyNetSavings * 12;
+
+    const roiPercentage = softwareCost > 0 ? Math.round((monthlyNetSavings / softwareCost) * 100) : 1000;
+    const breakEvenDays = monthlyGrossSavings > 0 ? Math.max(Math.round((softwareCost / (monthlyGrossSavings / 30))), 1) : 30;
+
+    return {
+      hoursSavedWeekly,
+      hoursSavedMonthly,
+      monthlyCostSavings: Math.round(monthlyNetSavings),
+      annualCostSavings: Math.round(annualCostSavings),
+      roiPercentage,
+      breakEvenDays,
+    };
+  }
+
+  /**
+   * 3. Instant Keyword Density & Readability Analyzer
+   */
+  static analyzeTextDensity(text: string, language: string = "fr"): DensityAnalysisResult {
+    if (!text || typeof text !== "string") {
+      return { totalWords: 0, characterCount: 0, readingTimeMinutes: 0, topKeywords: [], seoReadabilityScore: 0 };
+    }
+
+    const clean = text.toLowerCase().replace(/[^a-z0-9à-ÿ\s]/g, " ");
+    const words = clean.split(/\s+/).filter((w) => w.length > 2);
+    const totalWords = words.length;
+    const characterCount = text.length;
+    const readingTimeMinutes = Math.max(Math.round((totalWords / 200) * 10) / 10, 0.5);
+
+    const stopWords = new Set(["pour", "dans", "avec", "sur", "les", "des", "une", "que", "qui", "est", "par", "the", "and", "for", "with", "this", "that"]);
+    const frequencyMap = new Map<string, number>();
+
+    for (const w of words) {
+      if (!stopWords.has(w)) {
+        frequencyMap.set(w, (frequencyMap.get(w) || 0) + 1);
+      }
+    }
+
+    const sorted = Array.from(frequencyMap.entries()).sort((a, b) => b[1] - a[1]);
+    const topKeywords = sorted.slice(0, 8).map(([word, count]) => ({
+      word,
+      count,
+      densityPercent: totalWords > 0 ? Math.round((count / totalWords) * 1000) / 10 : 0,
+    }));
+
+    let seoReadabilityScore = 70;
+    if (totalWords >= 600) seoReadabilityScore += 20;
+    else if (totalWords < 300) seoReadabilityScore -= 25;
+
+    return {
+      totalWords,
+      characterCount,
+      readingTimeMinutes,
+      topKeywords,
+      seoReadabilityScore: Math.min(Math.max(seoReadabilityScore, 10), 100),
+    };
+  }
+
+  /**
+   * 4. Free SEO Slug Cleanser Helper
+   */
+  static cleanSlugTool(input: string, lang: string = "fr"): { original: string; cleanSlug: string; charSavings: number } {
+    const clean = cleanSeoSlug(input, { language: lang });
+    return {
+      original: input,
+      cleanSlug: clean,
+      charSavings: Math.max(input.length - clean.length, 0),
+    };
+  }
+
+  /**
+   * 5. Free Schema.org Generator Helper
+   */
+  static generateSampleSchema(type: "localBusiness" | "softwareApp" | "faq", name: string, url: string): Record<string, unknown> {
+    if (type === "localBusiness") {
+      return ExtendedSchemaGraphBuilder.buildLocalBusiness({
+        name,
+        url,
+        city: "Paris",
+        country: "France",
+      });
+    }
+    if (type === "faq") {
+      return ExtendedSchemaGraphBuilder.buildFAQPage([
+        { question: `Comment fonctionne ${name} ?`, answer: `${name} automatise vos opérations en quelques clics.` },
+        { question: `Quel est le tarif de ${name} ?`, answer: `Un essai gratuit de 14 jours est disponible sans carte bancaire.` },
+      ]);
+    }
+    return ExtendedSchemaGraphBuilder.buildSoftwareApplication({
+      name,
+      description: `Solution logicielle professionnelle ${name}`,
+      url,
+      priceMonthly: 29,
+    });
+  }
+}

package/src/index.ts

@@ -19,6 +19,7 @@ export * from "./i18n-detector";
 export * from "./brand-icons";
 export * from "./ui-icons";
 export * from "./og-image-generator";
+export * from "./free-public-tools";
 export * from "./urlytics-engine";
 export * from "./keyword-permutator";
 export * from "./llm-prompt";

package/src/llm-prompt.ts

@@ -283,22 +283,26 @@ The SDK equips applications with 9 enterprise-grade SEO engines:
    - \`renderDynamicOgSvg(opts)\`: Generates high-converting 1200x630 SVG social cards with glassmorphism badges, star ratings, and gradient backdrops.
    - \`generateOgImageUrl(domain, pageMeta, brandName)\`: Edge-ready query URL for \`app/api/og/route.ts\`.
 
-7. **🏛️ Google Schema.org Rich Graphs (\`ExtendedSchemaGraphBuilder\`):**
+7. **🛠️ Free Public Interactive Tools & Lead Magnets (\`FreePublicToolsEngine\`):**
+   - Ahrefs/Semrush-style high-intent public calculators: Google SERP Preview Simulator, Automation ROI Calculator, Keyword Density Analyzer, and Schema.org Generator.
+   - Boosts dwell time, organic backlinks, and visitor-to-customer conversion.
+
+8. **🏛️ Google Schema.org Rich Graphs (\`ExtendedSchemaGraphBuilder\`):**
    - \`buildAggregateRating\` (Google Gold Stars 4.9★), \`buildAggregateOffer\` (price ranges), \`buildLocalBusiness\` (GPS & opening hours), \`buildSoftwareApplication\`, \`buildHowTo\`, \`buildFAQPage\`, \`buildBreadcrumbs\`.
 
-8. **🔍 URL Decomposition & Analysis (\`UrlyticsEngine\`):**
+9. **🔍 URL Decomposition & Analysis (\`UrlyticsEngine\`):**
    - Deep structural directory decomposition, depth tracking, query parameter analysis, and slug tokenization (inspired by advertools).
 
-9. **⚡ SEM Keyword Combinator (\`KeywordPermutatorEngine\`):**
+10. **⚡ SEM Keyword Combinator (\`KeywordPermutatorEngine\`):**
    - Combinatorial matrix generation: Products × Modifiers × Locations with match types (\`[exact]\`, \`"phrase"\`, \`+broad\`) and intent classification.
 
-10. **⚖️ Legal & Editorial Compliance (\`LegalDisclaimerEngine\`):**
+11. **⚖️ Legal & Editorial Compliance (\`LegalDisclaimerEngine\`):**
    - 7 SeedRank-grade disclaimer templates, 90-day staleness verification, and multi-language anti-disparagement guardian.
 
-11. **📊 Telemetry & Cloud Metering (\`matrixEngine.getTelemetryPayload\` & \`LynxAnalyticsClient\`):**
+12. **📊 Telemetry & Cloud Metering (\`matrixEngine.getTelemetryPayload\` & \`LynxAnalyticsClient\`):**
    - Synchronizes total programmatic pages, indexed hubs, and AI bot crawl hits (GPTBot, ClaudeBot, PerplexityBot) with the LynxSEO Studio dashboard.
 
-12. **🧹 URL Slug Engine & Schema.org Graphs:**
+13. **🧹 URL Slug Engine & Schema.org Graphs:**
    - \`cleanSeoSlug(text, { language })\`: Strips accents, stop words across 10+ languages, and non-alphanumeric noise.
    - Outputs Google-validated Schema.org JSON-LD graphs with 0 syntax errors.
 `.trim();

package/src/matrix-engine.ts

@@ -125,6 +125,7 @@ export interface PseoCalculator {
   title: string;
   formulaDescription: string;
   savingsMetric: string;
+  inputs?: string[];
 }
 
 export interface SchemaOrgGraph {
@@ -162,6 +163,7 @@ export interface MatrixOptions {
   countries?: string[] | string; // e.g. ["france", "spain"] or "europe" or "international"
   territories?: string[] | string; // Alias for countries
   cleanDirectRoutes?: boolean; // When true (default), eliminates parasite words (/solutions/, etc.) for direct /{service}/{city}
+  enableFreeTools?: boolean; // When true (default), auto-generates 5 high-converting interactive tools like Ahrefs
   minPopulationToIndex?: number;
   defaultCurrency?: string;
   defaultCurrencySymbol?: string;
@@ -824,6 +826,38 @@ export class PseoMatrixEngine {
     }
     if (data.calculators) {
       allPages.push(...this.generateCalculatorMatrix(domain, data.calculators, options));
+    } else if (options.enableFreeTools !== false) {
+      const defaultCalculators: PseoCalculator[] = [
+        {
+          slug: "serp-preview-simulator",
+          title: "Google SERP Snippet Preview & CTR Simulator",
+          formulaDescription: "Simulate desktop and mobile Google search appearance and optimize CTR",
+          savingsMetric: "Search Click-Through Rate",
+          inputs: ["pageTitle", "metaDescription", "targetKeyword"],
+        },
+        {
+          slug: "roi-calculator",
+          title: "Automation ROI & Time-Saved Calculator",
+          formulaDescription: "Calculate weekly operational hours recovered and monthly budget saved",
+          savingsMetric: "Monthly Net Financial Savings",
+          inputs: ["hoursSpentWeekly", "hourlyRate", "teamMembers"],
+        },
+        {
+          slug: "seo-slug-generator",
+          title: "SEO URL Slug Cleaner & Optimizer",
+          formulaDescription: "Strip stop words, dates, and noise characters for high-CTR clean URLs",
+          savingsMetric: "URL Cleanliness & Readability",
+          inputs: ["rawTitle", "language"],
+        },
+        {
+          slug: "keyword-density-checker",
+          title: "Live Keyword Density & Readability Analyzer",
+          formulaDescription: "Analyze n-gram frequency, reading time, and content depth",
+          savingsMetric: "Content Optimization Score",
+          inputs: ["articleText"],
+        },
+      ];
+      allPages.push(...this.generateCalculatorMatrix(domain, defaultCalculators, options));
     }
 
     for (const p of allPages) {