@lynxflow/seo-engine 2.5.0 → 2.7.0

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/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.5.0",
+  "version": "2.7.0",
   "description": "High-Performance Universal Programmatic SEO & AI Search Engine SDK",
   "main": "dist/index.js",
   "module": "dist/index.mjs",