@lynxflow/seo-engine 2.3.0 → 2.5.0

package/dist/keyword-density-guard.d.ts

@@ -0,0 +1,28 @@
+/**
+ * 🛡️ Keyword Density Guard & Section Distribution Heatmap
+ * Ported & optimized from Python keyword_analyzer.py.
+ * Calculates exact keyword density, detects keyword stuffing risks (> 2.2%),
+ * and validates placement across Title, H1, First 100 Words, H2s, and FAQ.
+ */
+export interface KeywordPlacementCheck {
+    location: "title" | "h1" | "first_100_words" | "h2_headings" | "conclusion" | "faq";
+    present: boolean;
+    count: number;
+}
+export interface KeywordAnalysisReport {
+    keyword: string;
+    totalOccurrences: number;
+    totalWords: number;
+    densityPercent: number;
+    status: "too_low" | "optimal" | "stuffing_risk";
+    placements: KeywordPlacementCheck[];
+    consecutiveSentencesWithKeyword: number;
+    stuffingAlert: boolean;
+    recommendations: string[];
+}
+export declare class KeywordDensityGuard {
+    /**
+     * Analyzes keyword density and placement integrity.
+     */
+    static audit(content: string, primaryKeyword: string, metaTitle?: string): KeywordAnalysisReport;
+}

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

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

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

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

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

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

package/package.json

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