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

package/dist/article-strategic-planner.d.ts

@@ -0,0 +1,35 @@
+/**
+ * 📝 Strategic Section-by-Section Article Planner
+ * Ported & optimized from Python article_planner.py (15.5 KB).
+ * Builds a blueprint with word count targets per section, direct answer snippet cards, CTA intensities, and internal linking map.
+ */
+export type SectionType = "intro" | "how_to" | "comparison" | "explanation" | "faq" | "conclusion";
+export type CtaIntensity = "soft" | "medium" | "strong";
+export interface ArticleSectionPlan {
+    sectionNumber: number;
+    type: SectionType;
+    heading: string;
+    targetWordCount: number;
+    strategicObjective: string;
+    hasFeaturedSnippetTarget: boolean;
+    ctaIntensity?: CtaIntensity;
+    internalLinkAnchors: string[];
+}
+export interface ComprehensiveArticlePlan {
+    topic: string;
+    targetTotalWords: number;
+    estimatedReadingTimeMinutes: number;
+    meta: {
+        titleOptions: string[];
+        metaDescription: string;
+        targetKeywords: string[];
+    };
+    sections: ArticleSectionPlan[];
+    ctaMap: Record<string, number>;
+}
+export declare class ArticleStrategicPlanner {
+    /**
+     * Generates a complete strategic article plan tailored to a target keyword and desired depth.
+     */
+    static planArticle(topic: string, primaryKeyword: string, depth?: "standard" | "exhaustive_pillar"): ComprehensiveArticlePlan;
+}

package/dist/index.d.ts

@@ -128,6 +128,9 @@ import { KeywordDensityGuard } from "./keyword-density-guard";
 import { ContentQualityScorer } from "./content-quality-scorer";
 import { LandingCroChecker } from "./landing-cro-checker";
 import { SocialCommunityInsightsAggregator } from "./social-community-insights";
+import { LandingChannelScorer } from "./landing-channel-scorer";
+import { ArticleStrategicPlanner } from "./article-strategic-planner";
+import { TopicClusterArchitect } from "./topic-cluster-architect";
 export declare function createLynxSeoEngine(config: EngineConfig): LynxSeoEngine;
 export declare const LynxSeo: {
     createEngine: typeof createLynxSeoEngine;
@@ -153,6 +156,9 @@ export declare const LynxSeo: {
     contentQuality: typeof ContentQualityScorer;
     landingCroChecker: typeof LandingCroChecker;
     socialInsights: typeof SocialCommunityInsightsAggregator;
+    channelScorer: typeof LandingChannelScorer;
+    articlePlanner: typeof ArticleStrategicPlanner;
+    topicClusters: typeof TopicClusterArchitect;
     inspectMeta: typeof SiteAuditor.inspectMeta;
     crawlDomain: typeof DeepCrawlerAuditor.crawlAndAuditDomain;
     inspectHtmlSnapshot: typeof DeepCrawlerAuditor.inspectHtmlSnapshot;
@@ -194,6 +200,9 @@ export declare const LynxSeo: {
     marketingSkills: typeof MarketingSkillsEngine;
     regenerationTracker: typeof PageRegenerationTracker;
 };
+export * from "./landing-channel-scorer";
+export * from "./article-strategic-planner";
+export * from "./topic-cluster-architect";
 export * from "./content-quality-scorer";
 export * from "./landing-cro-checker";
 export * from "./social-community-insights";

package/dist/index.js

@@ -11366,6 +11366,226 @@ class SocialCommunityInsightsAggregator {
   }
 }
 
+// src/landing-channel-scorer.ts
+class LandingChannelScorer {
+  static CONFIGS = {
+    seo: { minWords: 1200, optimalWords: 2000, maxWords: 3000, minCtas: 3, optimalCtas: 5, maxDistractions: 6 },
+    ppc: { minWords: 350, optimalWords: 600, maxWords: 900, minCtas: 2, optimalCtas: 3, maxDistractions: 1 }
+  };
+  static scorePage(content, options) {
+    const config = this.CONFIGS[options.channel] || this.CONFIGS.seo;
+    const words = content.split(/\s+/).filter(Boolean);
+    const totalWords = words.length;
+    const ctaMatches = content.match(/(?:start|try|get|claim|demo|free trial|sign up|démarrer|essayer|profiter|obtenir)\s+(?:free|trial|now|today|gratuit|demo)?/gi) || [];
+    const ctaCount = ctaMatches.length;
+    const linkMatches = content.match(/\[.*?\]\(.*?\)/g) || [];
+    const distractionLinksCount = linkMatches.filter((l) => !l.toLowerCase().includes("pricing") && !l.toLowerCase().includes("signup")).length;
+    const hasH1 = /^#\s+.+/m.test(content);
+    const aboveFoldScore = hasH1 && ctaCount >= 1 ? 25 : 12;
+    let ctaScore = 15;
+    if (ctaCount >= config.minCtas && ctaCount <= config.optimalCtas + 2) {
+      ctaScore = 25;
+    } else if (ctaCount === 0) {
+      ctaScore = 0;
+    }
+    const hasProof = /rated|reviews?|avis|clients?|customers?|\d{1,3}(?:,\d{3})*\+/i.test(content);
+    const trustScore = hasProof ? 20 : 5;
+    const hasH2s = (content.match(/^##\s+.+/gm) || []).length >= 2;
+    const structureScore = hasH2s ? 15 : 8;
+    let channelFitScore = 15;
+    const recommendations = [];
+    if (options.channel === "seo") {
+      if (totalWords < config.minWords) {
+        channelFitScore -= 8;
+        recommendations.push(`SEO landing pages need depth (${totalWords}/${config.minWords} words). Expand with FAQ, feature breakdown, and case studies.`);
+      }
+    } else {
+      if (totalWords > config.maxWords) {
+        channelFitScore -= 8;
+        recommendations.push(`PPC landing page is too long (${totalWords} words). Cut text walls down to ~${config.optimalWords} words to maximize instant conversions.`);
+      }
+      if (distractionLinksCount > config.maxDistractions) {
+        channelFitScore -= 7;
+        recommendations.push(`Remove ${distractionLinksCount} navigation/leak links. PPC pages should only offer ONE path to conversion.`);
+      }
+    }
+    if (ctaCount < config.minCtas) {
+      recommendations.push(`Add ${config.minCtas - ctaCount} additional CTA button(s) distributed across the page.`);
+    }
+    if (!hasProof) {
+      recommendations.push("Add social proof indicators (reviews, user counts, client logos).");
+    }
+    const totalScore = Math.max(10, Math.min(100, aboveFoldScore + ctaScore + trustScore + structureScore + channelFitScore));
+    const passed = totalScore >= 70;
+    return {
+      channel: options.channel,
+      score: totalScore,
+      passed,
+      wordCount: totalWords,
+      wordCountTarget: { min: config.minWords, optimal: config.optimalWords, max: config.maxWords },
+      ctaCount,
+      ctaTarget: { min: config.minCtas, optimal: config.optimalWords ? config.optimalCtas : 3 },
+      distractionLinksCount,
+      categoryBreakdown: {
+        aboveTheFold: aboveFoldScore,
+        ctaAlignment: ctaScore,
+        trustSignals: trustScore,
+        structure: structureScore,
+        channelFit: channelFitScore
+      },
+      recommendations
+    };
+  }
+}
+
+// src/article-strategic-planner.ts
+class ArticleStrategicPlanner {
+  static planArticle(topic, primaryKeyword, depth = "standard") {
+    const totalWords = depth === "exhaustive_pillar" ? 3200 : 2200;
+    const readingTime = Math.round(totalWords / 200);
+    const sections = [
+      {
+        sectionNumber: 1,
+        type: "intro",
+        heading: `Introduction & Executive Direct Answer`,
+        targetWordCount: 250,
+        strategicObjective: "Hook the reader with a thought-provoking metric and provide a 40-word Direct Answer for SearchGPT & Gemini AI Overviews.",
+        hasFeaturedSnippetTarget: true,
+        internalLinkAnchors: ["Product Overview", "Platform Features"]
+      },
+      {
+        sectionNumber: 2,
+        type: "explanation",
+        heading: `Why ${primaryKeyword} Matters in 2026`,
+        targetWordCount: depth === "exhaustive_pillar" ? 600 : 450,
+        strategicObjective: "Establish market context, operational bottlenecks of manual workflows, and revenue impact.",
+        hasFeaturedSnippetTarget: false,
+        ctaIntensity: "soft",
+        internalLinkAnchors: ["Pricing & Plans"]
+      },
+      {
+        sectionNumber: 3,
+        type: "comparison",
+        heading: `Top Approaches & Benchmarks Matrix`,
+        targetWordCount: depth === "exhaustive_pillar" ? 750 : 500,
+        strategicObjective: "Present an objective comparison table with speed, latency, feature availability, and pricing.",
+        hasFeaturedSnippetTarget: true,
+        ctaIntensity: "medium",
+        internalLinkAnchors: ["Interactive Calculator", "Case Studies"]
+      },
+      {
+        sectionNumber: 4,
+        type: "how_to",
+        heading: `Step-by-Step Implementation Blueprint`,
+        targetWordCount: depth === "exhaustive_pillar" ? 800 : 550,
+        strategicObjective: "Provide actionable step-by-step tutorial with code snippets, configuration files, and verification criteria.",
+        hasFeaturedSnippetTarget: false,
+        ctaIntensity: "strong",
+        internalLinkAnchors: ["Documentation Hub", "API Reference"]
+      },
+      {
+        sectionNumber: 5,
+        type: "faq",
+        heading: `Frequently Asked Questions about ${primaryKeyword}`,
+        targetWordCount: 350,
+        strategicObjective: "Address top 4 'People Also Ask' search queries to qualify for Google FAQ rich snippet.",
+        hasFeaturedSnippetTarget: true,
+        internalLinkAnchors: []
+      },
+      {
+        sectionNumber: 6,
+        type: "conclusion",
+        heading: `Final Takeaways & Next Steps`,
+        targetWordCount: 150,
+        strategicObjective: "Summarize key findings and present final primary action button.",
+        hasFeaturedSnippetTarget: false,
+        ctaIntensity: "strong",
+        internalLinkAnchors: ["Start Free Trial"]
+      }
+    ];
+    return {
+      topic,
+      targetTotalWords: totalWords,
+      estimatedReadingTimeMinutes: readingTime,
+      meta: {
+        titleOptions: [
+          `${topic}: Complete Guide for 2026`,
+          `How to Master ${topic} (Step-by-Step)`,
+          `The Ultimate ${topic} Blueprint: Speed & Accuracy`
+        ],
+        metaDescription: `Discover how to master ${topic} in 2026. Explore step-by-step implementation, benchmarks, comparison matrices, and FAQ.`,
+        targetKeywords: [primaryKeyword, `${primaryKeyword} guide`, `best ${primaryKeyword} tools`]
+      },
+      sections,
+      ctaMap: {
+        soft: 2,
+        medium: 3,
+        strong: 4
+      }
+    };
+  }
+}
+
+// src/topic-cluster-architect.ts
+class TopicClusterArchitect {
+  static buildCluster(pillarTopic, subTopics) {
+    const pillarSlug = `/${pillarTopic.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "")}`;
+    let totalVolume = 0;
+    const spokes = subTopics.map((st) => {
+      const slug = `${pillarSlug}/${st.name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "")}`;
+      const vol = st.volume || 1200;
+      totalVolume += vol;
+      return {
+        subTopic: st.name,
+        slug,
+        searchIntent: st.intent || "informational",
+        monthlySearchVolume: vol,
+        keywordDifficulty: st.difficulty || 35,
+        targetWordCount: 1800,
+        inboundLinks: [pillarSlug],
+        outboundLinks: [pillarSlug]
+      };
+    });
+    const crossLinks = [];
+    for (const spoke of spokes) {
+      crossLinks.push({
+        fromSlug: spoke.slug,
+        toSlug: pillarSlug,
+        anchorText: `${pillarTopic} Complete Overview`
+      });
+      crossLinks.push({
+        fromSlug: pillarSlug,
+        toSlug: spoke.slug,
+        anchorText: `Deep dive on ${spoke.subTopic}`
+      });
+    }
+    for (let i = 0;i < spokes.length; i++) {
+      const nextSpoke = spokes[(i + 1) % spokes.length];
+      crossLinks.push({
+        fromSlug: spokes[i].slug,
+        toSlug: nextSpoke.slug,
+        anchorText: `Related: ${nextSpoke.subTopic}`
+      });
+      spokes[i].outboundLinks.push(nextSpoke.slug);
+      nextSpoke.inboundLinks.push(spokes[i].slug);
+    }
+    let authority = "emerging";
+    if (spokes.length >= 6 && totalVolume > 5000)
+      authority = "dominant";
+    else if (spokes.length >= 3)
+      authority = "strong";
+    return {
+      pillarTopic,
+      pillarSlug,
+      totalSubSpokes: spokes.length,
+      totalEstimatedSearchVolume: totalVolume,
+      spokes,
+      crossLinkMatrix: crossLinks,
+      clusterAuthorityPotential: authority
+    };
+  }
+}
+
 // src/index.ts
 function createLynxSeoEngine(config) {
   return new LynxSeoEngine(config);
@@ -11394,6 +11614,9 @@ var LynxSeo = {
   contentQuality: ContentQualityScorer,
   landingCroChecker: LandingCroChecker,
   socialInsights: SocialCommunityInsightsAggregator,
+  channelScorer: LandingChannelScorer,
+  articlePlanner: ArticleStrategicPlanner,
+  topicClusters: TopicClusterArchitect,
   inspectMeta: SiteAuditor.inspectMeta,
   crawlDomain: DeepCrawlerAuditor.crawlAndAuditDomain,
   inspectHtmlSnapshot: DeepCrawlerAuditor.inspectHtmlSnapshot,
@@ -11454,6 +11677,7 @@ export {
   UrlyticsEngine,
   UI_ICONS,
   TrustSignalsExtractor,
+  TopicClusterArchitect,
   TokenQuotaManager,
   TechnicalRulesAuditor,
   TeamRbacEngine,
@@ -11499,6 +11723,7 @@ export {
   LlmContentCleaner,
   LegalDisclaimerEngine,
   LandingCroChecker,
+  LandingChannelScorer,
   LagoTokenMeter,
   KnowledgeGraphLinker,
   KnowledgeBankBuilder,
@@ -11533,6 +11758,7 @@ export {
   BacklinksClient,
   BUILT_IN_LOCATIONS_DATABASE,
   BRAND_ICONS,
+  ArticleStrategicPlanner,
   ApiKeyGuardian,
   AiCopilotClient,
   AiBotsLogAnalyzer,

package/dist/index.mjs

@@ -11366,6 +11366,226 @@ class SocialCommunityInsightsAggregator {
   }
 }
 
+// src/landing-channel-scorer.ts
+class LandingChannelScorer {
+  static CONFIGS = {
+    seo: { minWords: 1200, optimalWords: 2000, maxWords: 3000, minCtas: 3, optimalCtas: 5, maxDistractions: 6 },
+    ppc: { minWords: 350, optimalWords: 600, maxWords: 900, minCtas: 2, optimalCtas: 3, maxDistractions: 1 }
+  };
+  static scorePage(content, options) {
+    const config = this.CONFIGS[options.channel] || this.CONFIGS.seo;
+    const words = content.split(/\s+/).filter(Boolean);
+    const totalWords = words.length;
+    const ctaMatches = content.match(/(?:start|try|get|claim|demo|free trial|sign up|démarrer|essayer|profiter|obtenir)\s+(?:free|trial|now|today|gratuit|demo)?/gi) || [];
+    const ctaCount = ctaMatches.length;
+    const linkMatches = content.match(/\[.*?\]\(.*?\)/g) || [];
+    const distractionLinksCount = linkMatches.filter((l) => !l.toLowerCase().includes("pricing") && !l.toLowerCase().includes("signup")).length;
+    const hasH1 = /^#\s+.+/m.test(content);
+    const aboveFoldScore = hasH1 && ctaCount >= 1 ? 25 : 12;
+    let ctaScore = 15;
+    if (ctaCount >= config.minCtas && ctaCount <= config.optimalCtas + 2) {
+      ctaScore = 25;
+    } else if (ctaCount === 0) {
+      ctaScore = 0;
+    }
+    const hasProof = /rated|reviews?|avis|clients?|customers?|\d{1,3}(?:,\d{3})*\+/i.test(content);
+    const trustScore = hasProof ? 20 : 5;
+    const hasH2s = (content.match(/^##\s+.+/gm) || []).length >= 2;
+    const structureScore = hasH2s ? 15 : 8;
+    let channelFitScore = 15;
+    const recommendations = [];
+    if (options.channel === "seo") {
+      if (totalWords < config.minWords) {
+        channelFitScore -= 8;
+        recommendations.push(`SEO landing pages need depth (${totalWords}/${config.minWords} words). Expand with FAQ, feature breakdown, and case studies.`);
+      }
+    } else {
+      if (totalWords > config.maxWords) {
+        channelFitScore -= 8;
+        recommendations.push(`PPC landing page is too long (${totalWords} words). Cut text walls down to ~${config.optimalWords} words to maximize instant conversions.`);
+      }
+      if (distractionLinksCount > config.maxDistractions) {
+        channelFitScore -= 7;
+        recommendations.push(`Remove ${distractionLinksCount} navigation/leak links. PPC pages should only offer ONE path to conversion.`);
+      }
+    }
+    if (ctaCount < config.minCtas) {
+      recommendations.push(`Add ${config.minCtas - ctaCount} additional CTA button(s) distributed across the page.`);
+    }
+    if (!hasProof) {
+      recommendations.push("Add social proof indicators (reviews, user counts, client logos).");
+    }
+    const totalScore = Math.max(10, Math.min(100, aboveFoldScore + ctaScore + trustScore + structureScore + channelFitScore));
+    const passed = totalScore >= 70;
+    return {
+      channel: options.channel,
+      score: totalScore,
+      passed,
+      wordCount: totalWords,
+      wordCountTarget: { min: config.minWords, optimal: config.optimalWords, max: config.maxWords },
+      ctaCount,
+      ctaTarget: { min: config.minCtas, optimal: config.optimalWords ? config.optimalCtas : 3 },
+      distractionLinksCount,
+      categoryBreakdown: {
+        aboveTheFold: aboveFoldScore,
+        ctaAlignment: ctaScore,
+        trustSignals: trustScore,
+        structure: structureScore,
+        channelFit: channelFitScore
+      },
+      recommendations
+    };
+  }
+}
+
+// src/article-strategic-planner.ts
+class ArticleStrategicPlanner {
+  static planArticle(topic, primaryKeyword, depth = "standard") {
+    const totalWords = depth === "exhaustive_pillar" ? 3200 : 2200;
+    const readingTime = Math.round(totalWords / 200);
+    const sections = [
+      {
+        sectionNumber: 1,
+        type: "intro",
+        heading: `Introduction & Executive Direct Answer`,
+        targetWordCount: 250,
+        strategicObjective: "Hook the reader with a thought-provoking metric and provide a 40-word Direct Answer for SearchGPT & Gemini AI Overviews.",
+        hasFeaturedSnippetTarget: true,
+        internalLinkAnchors: ["Product Overview", "Platform Features"]
+      },
+      {
+        sectionNumber: 2,
+        type: "explanation",
+        heading: `Why ${primaryKeyword} Matters in 2026`,
+        targetWordCount: depth === "exhaustive_pillar" ? 600 : 450,
+        strategicObjective: "Establish market context, operational bottlenecks of manual workflows, and revenue impact.",
+        hasFeaturedSnippetTarget: false,
+        ctaIntensity: "soft",
+        internalLinkAnchors: ["Pricing & Plans"]
+      },
+      {
+        sectionNumber: 3,
+        type: "comparison",
+        heading: `Top Approaches & Benchmarks Matrix`,
+        targetWordCount: depth === "exhaustive_pillar" ? 750 : 500,
+        strategicObjective: "Present an objective comparison table with speed, latency, feature availability, and pricing.",
+        hasFeaturedSnippetTarget: true,
+        ctaIntensity: "medium",
+        internalLinkAnchors: ["Interactive Calculator", "Case Studies"]
+      },
+      {
+        sectionNumber: 4,
+        type: "how_to",
+        heading: `Step-by-Step Implementation Blueprint`,
+        targetWordCount: depth === "exhaustive_pillar" ? 800 : 550,
+        strategicObjective: "Provide actionable step-by-step tutorial with code snippets, configuration files, and verification criteria.",
+        hasFeaturedSnippetTarget: false,
+        ctaIntensity: "strong",
+        internalLinkAnchors: ["Documentation Hub", "API Reference"]
+      },
+      {
+        sectionNumber: 5,
+        type: "faq",
+        heading: `Frequently Asked Questions about ${primaryKeyword}`,
+        targetWordCount: 350,
+        strategicObjective: "Address top 4 'People Also Ask' search queries to qualify for Google FAQ rich snippet.",
+        hasFeaturedSnippetTarget: true,
+        internalLinkAnchors: []
+      },
+      {
+        sectionNumber: 6,
+        type: "conclusion",
+        heading: `Final Takeaways & Next Steps`,
+        targetWordCount: 150,
+        strategicObjective: "Summarize key findings and present final primary action button.",
+        hasFeaturedSnippetTarget: false,
+        ctaIntensity: "strong",
+        internalLinkAnchors: ["Start Free Trial"]
+      }
+    ];
+    return {
+      topic,
+      targetTotalWords: totalWords,
+      estimatedReadingTimeMinutes: readingTime,
+      meta: {
+        titleOptions: [
+          `${topic}: Complete Guide for 2026`,
+          `How to Master ${topic} (Step-by-Step)`,
+          `The Ultimate ${topic} Blueprint: Speed & Accuracy`
+        ],
+        metaDescription: `Discover how to master ${topic} in 2026. Explore step-by-step implementation, benchmarks, comparison matrices, and FAQ.`,
+        targetKeywords: [primaryKeyword, `${primaryKeyword} guide`, `best ${primaryKeyword} tools`]
+      },
+      sections,
+      ctaMap: {
+        soft: 2,
+        medium: 3,
+        strong: 4
+      }
+    };
+  }
+}
+
+// src/topic-cluster-architect.ts
+class TopicClusterArchitect {
+  static buildCluster(pillarTopic, subTopics) {
+    const pillarSlug = `/${pillarTopic.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "")}`;
+    let totalVolume = 0;
+    const spokes = subTopics.map((st) => {
+      const slug = `${pillarSlug}/${st.name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "")}`;
+      const vol = st.volume || 1200;
+      totalVolume += vol;
+      return {
+        subTopic: st.name,
+        slug,
+        searchIntent: st.intent || "informational",
+        monthlySearchVolume: vol,
+        keywordDifficulty: st.difficulty || 35,
+        targetWordCount: 1800,
+        inboundLinks: [pillarSlug],
+        outboundLinks: [pillarSlug]
+      };
+    });
+    const crossLinks = [];
+    for (const spoke of spokes) {
+      crossLinks.push({
+        fromSlug: spoke.slug,
+        toSlug: pillarSlug,
+        anchorText: `${pillarTopic} Complete Overview`
+      });
+      crossLinks.push({
+        fromSlug: pillarSlug,
+        toSlug: spoke.slug,
+        anchorText: `Deep dive on ${spoke.subTopic}`
+      });
+    }
+    for (let i = 0;i < spokes.length; i++) {
+      const nextSpoke = spokes[(i + 1) % spokes.length];
+      crossLinks.push({
+        fromSlug: spokes[i].slug,
+        toSlug: nextSpoke.slug,
+        anchorText: `Related: ${nextSpoke.subTopic}`
+      });
+      spokes[i].outboundLinks.push(nextSpoke.slug);
+      nextSpoke.inboundLinks.push(spokes[i].slug);
+    }
+    let authority = "emerging";
+    if (spokes.length >= 6 && totalVolume > 5000)
+      authority = "dominant";
+    else if (spokes.length >= 3)
+      authority = "strong";
+    return {
+      pillarTopic,
+      pillarSlug,
+      totalSubSpokes: spokes.length,
+      totalEstimatedSearchVolume: totalVolume,
+      spokes,
+      crossLinkMatrix: crossLinks,
+      clusterAuthorityPotential: authority
+    };
+  }
+}
+
 // src/index.ts
 function createLynxSeoEngine(config) {
   return new LynxSeoEngine(config);
@@ -11394,6 +11614,9 @@ var LynxSeo = {
   contentQuality: ContentQualityScorer,
   landingCroChecker: LandingCroChecker,
   socialInsights: SocialCommunityInsightsAggregator,
+  channelScorer: LandingChannelScorer,
+  articlePlanner: ArticleStrategicPlanner,
+  topicClusters: TopicClusterArchitect,
   inspectMeta: SiteAuditor.inspectMeta,
   crawlDomain: DeepCrawlerAuditor.crawlAndAuditDomain,
   inspectHtmlSnapshot: DeepCrawlerAuditor.inspectHtmlSnapshot,
@@ -11454,6 +11677,7 @@ export {
   UrlyticsEngine,
   UI_ICONS,
   TrustSignalsExtractor,
+  TopicClusterArchitect,
   TokenQuotaManager,
   TechnicalRulesAuditor,
   TeamRbacEngine,
@@ -11499,6 +11723,7 @@ export {
   LlmContentCleaner,
   LegalDisclaimerEngine,
   LandingCroChecker,
+  LandingChannelScorer,
   LagoTokenMeter,
   KnowledgeGraphLinker,
   KnowledgeBankBuilder,
@@ -11533,6 +11758,7 @@ export {
   BacklinksClient,
   BUILT_IN_LOCATIONS_DATABASE,
   BRAND_ICONS,
+  ArticleStrategicPlanner,
   ApiKeyGuardian,
   AiCopilotClient,
   AiBotsLogAnalyzer,

package/dist/landing-channel-scorer.d.ts

@@ -0,0 +1,41 @@
+/**
+ * 🎯 Dual-Channel Landing Page Scorer (SEO vs. PPC)
+ * Ported & optimized from Python landing_page_scorer.py (28 KB).
+ * Evaluates landing pages with tailored benchmarks for SEO (1,500-2,500 words) vs PPC (400-800 words, zero leak links).
+ */
+export interface ChannelScoringConfig {
+    channel: "seo" | "ppc";
+    conversionGoal?: "trial" | "demo" | "lead";
+}
+export interface ChannelScoringReport {
+    channel: "seo" | "ppc";
+    score: number;
+    passed: boolean;
+    wordCount: number;
+    wordCountTarget: {
+        min: number;
+        optimal: number;
+        max: number;
+    };
+    ctaCount: number;
+    ctaTarget: {
+        min: number;
+        optimal: number;
+    };
+    distractionLinksCount: number;
+    categoryBreakdown: {
+        aboveTheFold: number;
+        ctaAlignment: number;
+        trustSignals: number;
+        structure: number;
+        channelFit: number;
+    };
+    recommendations: string[];
+}
+export declare class LandingChannelScorer {
+    private static readonly CONFIGS;
+    /**
+     * Scores landing page according to the specific acquisition channel.
+     */
+    static scorePage(content: string, options: ChannelScoringConfig): ChannelScoringReport;
+}

package/dist/topic-cluster-architect.d.ts

@@ -0,0 +1,39 @@
+/**
+ * 🕸️ Topic Cluster & Pillar-Spoke Cross-Linking Architect
+ * Ported & optimized from Python research_topic_clusters.py (22 KB).
+ * Builds a complete 1-to-N topic cluster map with pillar hub, long-tail sub-spokes, and bidirectional internal links.
+ */
+export interface TopicSpokeNode {
+    subTopic: string;
+    slug: string;
+    searchIntent: "informational" | "commercial_investigation" | "transactional";
+    monthlySearchVolume: number;
+    keywordDifficulty: number;
+    targetWordCount: number;
+    inboundLinks: string[];
+    outboundLinks: string[];
+}
+export interface TopicClusterTopology {
+    pillarTopic: string;
+    pillarSlug: string;
+    totalSubSpokes: number;
+    totalEstimatedSearchVolume: number;
+    spokes: TopicSpokeNode[];
+    crossLinkMatrix: Array<{
+        fromSlug: string;
+        toSlug: string;
+        anchorText: string;
+    }>;
+    clusterAuthorityPotential: "dominant" | "strong" | "emerging";
+}
+export declare class TopicClusterArchitect {
+    /**
+     * Generates a fully mapped topic cluster with cross-links.
+     */
+    static buildCluster(pillarTopic: string, subTopics: Array<{
+        name: string;
+        volume?: number;
+        difficulty?: number;
+        intent?: "informational" | "commercial_investigation" | "transactional";
+    }>): TopicClusterTopology;
+}

package/package.json

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