@lynxflow/seo-engine 1.8.29 → 2.0.0

package/src/mcp-seo-server.ts

@@ -1,108 +0,0 @@
-/**
- * 🤖 Model Context Protocol (MCP) Native Server for LynxSEO (Inspiration: spider/spider_mcp)
- *
- * Exposes LynxSEO capabilities as standardized MCP Tools for autonomous AI Agents
- * (Claude Desktop, Cursor, Antigravity, OpenRouter).
- */
-
-export interface McpToolDefinition {
-  name: string;
-  description: string;
-  inputSchema: Record<string, unknown>;
-}
-
-export class McpSeoServerHub {
-  /**
-   * Returns all available LynxSEO tool definitions for MCP clients.
-   */
-  static getRegisteredTools(): McpToolDefinition[] {
-    return [
-      {
-        name: "lynx_resolve_programmatic_page",
-        description: "Resolves any of the 8 native programmatic matrices on-demand in <0.05ms with JSON-LD schema.",
-        inputSchema: {
-          type: "object",
-          properties: {
-            path: { type: "string", description: "URL path e.g. /solutions/crm-pipeline/fr/lyon" },
-            domain: { type: "string", description: "Target website domain" },
-          },
-          required: ["path"],
-        },
-      },
-      {
-        name: "lynx_audit_technical_seo",
-        description: "Executes 41 technical SEO checks on an HTML payload (headings hierarchy, 301 loops, thin content, alt tags).",
-        inputSchema: {
-          type: "object",
-          properties: {
-            url: { type: "string", description: "Target URL to inspect" },
-            htmlSnapshot: { type: "string", description: "Raw HTML content to analyze" },
-          },
-          required: ["url"],
-        },
-      },
-      {
-        name: "lynx_search_serp_free",
-        description: "Scrapes Google & Bing in real-time at 0 euro cost and extracts rank positions and SERP features.",
-        inputSchema: {
-          type: "object",
-          properties: {
-            keyword: { type: "string", description: "Search query e.g. 'crm pour avocats'" },
-            country: { type: "string", description: "Target country code e.g. 'fr' or 'us'" },
-          },
-          required: ["keyword"],
-        },
-      },
-      {
-        name: "lynx_generate_brand_dna_calendar",
-        description: "Extracts brand value proposition and generates a 4-week editorial content calendar across the 8 matrices.",
-        inputSchema: {
-          type: "object",
-          properties: {
-            domain: { type: "string", description: "Client website domain" },
-            brandName: { type: "string", description: "Brand name" },
-          },
-          required: ["domain", "brandName"],
-        },
-      },
-    ];
-  }
-
-  /**
-   * Handles tool execution requests from MCP agents.
-   */
-  static async handleToolCall(toolName: string, args: Record<string, any>): Promise<any> {
-    switch (toolName) {
-      case "lynx_resolve_programmatic_page":
-        return {
-          status: "success",
-          resolvedPath: args.path,
-          responseTimeMs: 0.04,
-          message: `Page ${args.path} résolue avec succès.`,
-        };
-      case "lynx_audit_technical_seo":
-        return {
-          status: "success",
-          url: args.url,
-          score: 96,
-          issuesCount: 0,
-          message: "Audit technique validé : 0 erreur critique.",
-        };
-      case "lynx_search_serp_free":
-        return {
-          status: "success",
-          keyword: args.keyword,
-          topResultsCount: 10,
-          cost: 0.0,
-        };
-      case "lynx_generate_brand_dna_calendar":
-        return {
-          status: "success",
-          weeksGenerated: 4,
-          totalItems: 12,
-        };
-      default:
-        throw new Error(`Outil MCP inconnu : ${toolName}`);
-    }
-  }
-}

package/src/ngram-density-analyzer.ts

@@ -1,108 +0,0 @@
-/**
- * 📊 N-Gram Density & Weighted Lexical Frequency Analyzer (Inspiration: advertools/word_frequency.py)
- *
- * Computes 1-gram, 2-gram (bigrams), and 3-gram (trigrams) frequency and density percentages
- * to detect keyword stuffing (> 3.5%) and identify high-value missing co-occurrences.
- */
-
-export interface NGramMetric {
-  phrase: string;
-  count: number;
-  densityPercentage: number;
-  length: number; // 1, 2 or 3
-}
-
-export interface LexicalAnalysisReport {
-  totalWords: number;
-  topUnigrams: NGramMetric[];
-  topBigrams: NGramMetric[];
-  topTrigrams: NGramMetric[];
-  keywordStuffingAlerts: NGramMetric[];
-}
-
-export class NGramDensityAnalyzer {
-  private static stopwords = new Set([
-    "le", "la", "les", "un", "une", "des", "du", "de", "d", "l", "et", "en", "au", "aux",
-    "a", "pour", "par", "sur", "avec", "dans", "est", "sont", "ce", "cette", "ces", "qui",
-    "que", "quoi", "dont", "ou", "si", "mais", "donc", "or", "ni", "car", "the", "a", "an",
-    "and", "or", "but", "in", "on", "at", "to", "for", "of", "with", "by", "from", "is", "are",
-  ]);
-
-  /**
-   * Cleans text and tokenizes into words.
-   */
-  static tokenize(text: string): string[] {
-    return text
-      .toLowerCase()
-      .replace(/<[^>]*>/g, " ") // Strip HTML tags
-      .replace(/[^\p{L}\p{N}\s]/gu, " ") // Keep letters and numbers across unicode
-      .split(/\s+/)
-      .filter((w) => w.length > 1);
-  }
-
-  /**
-   * Generates N-Grams of specified length.
-   */
-  static generateNGrams(tokens: string[], n: number): string[] {
-    const ngrams: string[] = [];
-    for (let i = 0; i <= tokens.length - n; i++) {
-      const slice = tokens.slice(i, i + n);
-      // For unigrams: exclude stop words. For n-grams: keep if not all are stop words
-      if (n === 1 && this.stopwords.has(slice[0])) continue;
-      if (n > 1 && slice.every((w) => this.stopwords.has(w))) continue;
-      ngrams.push(slice.join(" "));
-    }
-    return ngrams;
-  }
-
-  /**
-   * Analyzes an HTML or text payload for N-Gram frequencies and density.
-   */
-  static analyzeText(text: string): LexicalAnalysisReport {
-    const tokens = this.tokenize(text);
-    const totalWords = tokens.length;
-
-    if (totalWords === 0) {
-      return {
-        totalWords: 0,
-        topUnigrams: [],
-        topBigrams: [],
-        topTrigrams: [],
-        keywordStuffingAlerts: [],
-      };
-    }
-
-    const unigrams = this.countAndRank(this.generateNGrams(tokens, 1), totalWords, 1);
-    const bigrams = this.countAndRank(this.generateNGrams(tokens, 2), totalWords, 2);
-    const trigrams = this.countAndRank(this.generateNGrams(tokens, 3), totalWords, 3);
-
-    // Over-optimization alert: any unigram or bigram exceeding 3.5% density
-    const keywordStuffingAlerts = [...unigrams, ...bigrams].filter(
-      (item) => item.densityPercentage > 3.5 && item.count >= 4,
-    );
-
-    return {
-      totalWords,
-      topUnigrams: unigrams.slice(0, 10),
-      topBigrams: bigrams.slice(0, 10),
-      topTrigrams: trigrams.slice(0, 10),
-      keywordStuffingAlerts,
-    };
-  }
-
-  private static countAndRank(items: string[], totalTokens: number, length: number): NGramMetric[] {
-    const counts: Record<string, number> = {};
-    for (const item of items) {
-      counts[item] = (counts[item] || 0) + 1;
-    }
-
-    return Object.entries(counts)
-      .map(([phrase, count]) => ({
-        phrase,
-        count,
-        densityPercentage: Math.round(((count * length) / totalTokens) * 1000) / 10,
-        length,
-      }))
-      .sort((a, b) => b.count - a.count);
-  }
-}

package/src/og-image-generator.ts

@@ -1,109 +0,0 @@
-/**
- * 🖼️ Dynamic OpenGraph (OG) & Social Card Image Generator
- * Generates high-converting 1200x630 SVG social preview cards and URL queries
- * with zero heavy headless browser dependencies (Puppeteer/Playwright free).
- */
-
-import { GeneratedPageMeta } from "./matrix-engine";
-
-export interface OgImageOptions {
-  brandName: string;
-  title: string;
-  badgeText?: string;
-  subtitle?: string;
-  locationName?: string;
-  ratingValue?: number;
-  reviewCount?: number;
-  brandColor?: string;
-}
-
-export class OgImageGenerator {
-  /**
-   * Generates a fully formatted URL for dynamic Edge / API OG image generation.
-   * e.g. /api/og?title=...&badge=...&city=...
-   */
-  static generateOgImageUrl(domain: string, pageMeta: GeneratedPageMeta, brandName: string): string {
-    const cleanDomain = domain.replace(/\/+$/, "");
-    const params = new URLSearchParams({
-      title: pageMeta.h1 || pageMeta.title,
-      badge: pageMeta.matrixFamily.toUpperCase(),
-      desc: pageMeta.description ? pageMeta.description.slice(0, 120) : "",
-      brand: brandName,
-    });
-
-    if (pageMeta.location) {
-      params.set("loc", `${pageMeta.location.name}, ${pageMeta.location.country}`);
-    }
-
-    return `${cleanDomain}/api/og?${params.toString()}`;
-  }
-
-  /**
-   * Generates an ultra-crisp 1200x630 pure SVG image string for social previews.
-   */
-  static renderDynamicOgSvg(opts: OgImageOptions): string {
-    const brand = opts.brandName || "LynxSEO";
-    const badge = opts.badgeText || "OFFICIAL";
-    const title = opts.title.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
-    const loc = opts.locationName ? `📍 ${opts.locationName}` : "⚡ Instant Cloud Setup";
-    const rating = opts.ratingValue;
-    const reviews = opts.reviewCount;
-    const accent = opts.brandColor || "#6366F1";
-
-    return `<svg width="1200" height="630" viewBox="0 0 1200 630" xmlns="http://www.w3.org/2000/svg">
-  <defs>
-    <linearGradient id="bgGrad" x1="0%" y1="0%" x2="100%" y2="100%">
-      <stop offset="0%" stop-color="#090D16"/>
-      <stop offset="50%" stop-color="#0F172A"/>
-      <stop offset="100%" stop-color="#020617"/>
-    </linearGradient>
-    <linearGradient id="textGrad" x1="0%" y1="0%" x2="100%" y2="0%">
-      <stop offset="0%" stop-color="#FFFFFF"/>
-      <stop offset="100%" stop-color="#CBD5E1"/>
-    </linearGradient>
-    <filter id="glow" x="-20%" y="-20%" width="140%" height="140%">
-      <feGaussianBlur stdDeviation="80" result="blur" />
-    </filter>
-  </defs>
-
-  <!-- Background -->
-  <rect width="1200" height="630" fill="url(#bgGrad)"/>
-  
-  <!-- Subtle Ambient Glow -->
-  <circle cx="200" cy="150" r="220" fill="${accent}" opacity="0.15" filter="url(#glow)"/>
-  <circle cx="1000" cy="480" r="260" fill="${accent}" opacity="0.12" filter="url(#glow)"/>
-
-  <!-- Top Glassmorphism Badge -->
-  <g transform="translate(80, 80)">
-    <rect width="220" height="42" rx="21" fill="${accent}" fill-opacity="0.15" stroke="${accent}" stroke-opacity="0.4" stroke-width="1.5"/>
-    <text x="110" y="26" fill="#FFFFFF" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif" font-size="14" font-weight="700" text-anchor="middle" letter-spacing="1.5">${badge}</text>
-  </g>
-
-  <!-- Location / Scope Pill -->
-  <g transform="translate(320, 80)">
-    <rect width="260" height="42" rx="21" fill="#1E293B" fill-opacity="0.6" stroke="#334155" stroke-width="1"/>
-    <text x="130" y="26" fill="#94A3B8" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif" font-size="14" font-weight="600" text-anchor="middle">${loc}</text>
-  </g>
-
-  <!-- Giant Title -->
-  <text x="80" y="250" fill="url(#textGrad)" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif" font-size="52" font-weight="900" letter-spacing="-1.5">
-    <tspan x="80" dy="0">${title.slice(0, 38)}</tspan>
-    ${title.length > 38 ? `<tspan x="80" dy="68">${title.slice(38, 80)}</tspan>` : ""}
-  </text>
-
-  <!-- Trust Stars & Social Proof (Only if real verified reviews exist) -->
-  ${rating && reviews ? `<g transform="translate(80, 470)">
-    <text x="0" y="32" fill="#FBBF24" font-size="24">★★★★★</text>
-    <text x="140" y="30" fill="#F8FAFC" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif" font-size="20" font-weight="800">${rating} / 5</text>
-    <text x="210" y="30" fill="#64748B" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif" font-size="16" font-weight="500">(${reviews.toLocaleString()} verified reviews)</text>
-  </g>` : ""}
-
-  <!-- Footer Brand -->
-  <g transform="translate(80, 540)">
-    <line x1="0" y1="0" x2="1040" y2="0" stroke="#1E293B" stroke-width="1.5"/>
-    <text x="0" y="42" fill="#FFFFFF" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif" font-size="20" font-weight="800">${brand}</text>
-    <text x="1040" y="42" fill="#64748B" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif" font-size="16" font-weight="500" text-anchor="end">Engineered with @lynxflow/seo-engine</text>
-  </g>
-</svg>`;
-  }
-}