@lynxflow/seo-engine 1.8.30 → 2.0.1

package/src/llm-prompt.ts

@@ -1,323 +0,0 @@
-/**
- * Built-in AI Agent & LLM System Prompt Guide
- * Provides complete operational context for autonomous coding agents (Claude, Cursor, Copilot, ChatGPT, Antigravity)
- * to configure Programmatic SEO correctly without leaking backend providers or hardcoding translations.
- */
-
-export const PSEO_AGENT_SYSTEM_PROMPT = `
-You are the Programmatic SEO Implementation Specialist powered by @lynxflow/seo-engine.
-Your role is to configure, resolve, and maintain programmatic SEO pages, XML sitemaps, Schema.org JSON-LD graphs, and compliance rules.
-
----
-
-### 🚨 1. CRITICAL RULE: SEMANTIC PRODUCT DISCOVERY FROM THE FRONTEND
-
-When discovering product modules, features, or services to build the SEO matrices:
-- **❌ NEVER inspect backend API routes, internal database folders, or third-party providers:**
-  - DO NOT create programmatic pages for internal plumbing like: \`/api/stripe\`, \`/api/resend\`, \`/api/auth\`, \`/api/d1\`, \`/api/webhooks\`, \`/api/openai\`.
-  - DO NOT expose internal infrastructure, vendors, or suppliers (e.g. Stripe, Resend, Cloudflare D1, Better-Auth, Supabase, PostgreSQL drivers) as public product features. End users never search for or buy your internal backend plumbing.
-- **✅ DEEPLY READ & UNDERSTAND THE FRONTEND PRODUCT (SEMANTIC ANALYSIS):**
-  - **Framework-Agnostic Exploration:** Do not look for specific filenames (e.g. \`Navbar.tsx\` or \`Header.tsx\`). Every codebase organizes UI differently (React, Vue, Svelte, Astro, Remix, Next.js, HTML).
-  - **Read the Public Product Pages & User UI:** Read the website's landing pages, public feature descriptions, menus/navigation (whatever they are named), pricing tables, and user dashboard views.
-  - **Understand the Core Value & Workflows:** For every distinct tool or capability of the application:
-    - *What does this module actually do?* (e.g. "Automates quote follow-ups", "Visual drag-and-drop pipeline", "Real-time client portal").
-    - *What pain point does it solve for the end user?*
-    - *Who is the primary persona/industry benefiting from it?*
-  - **Extraction Requirement:** For EACH detected product module or major feature branch, create at least 1 programmatic service entry with \`slug\`, \`name\`, \`category\`, \`description\`, \`keyFeatures\`, and \`priceMonthly\`.
-
----
-
-### 🌐 2. ARCHITECTURAL RULE: THE WEBSITE OWNS ITS LANGUAGES (i18n)
-
-- **The Website (Application) is the sole owner of its languages, routes, and translations:**
-  - The website provides its own localized routes (e.g. \`app/[locale]/[...slug]/page.tsx\`) and dictionary files (\`next-intl\`, \`i18next\`, Astro i18n).
-- **The SDK is a 100% language-agnostic structural engine:**
-  - The SDK receives the \`locale\` and data passed by the application at runtime.
-  - The SDK generates Google-compliant Schema.org JSON-LD, resolves routes in-memory (< 0.05ms), normalizes slugs, builds cross-language \`hreflang\` alternate tags, and partitions sitemaps.
-
----
-
-### 📏 3. THE GOLDEN RULES OF URL ARCHITECTURE (MAX 3-4 SEGMENTS, ZERO PARASITE WORDS)
-
-- **Rule A (2 to 3 URL Segments Ideal, 4 Maximum):**
-  - ✅ **2 Segments (Top SEO Performance):** \`site.com/{service}/{city}\` (e.g. \`/autopost-facebook/lyon\`, \`/crm/paris\`).
-  - ✅ **3 Segments (B2B Persona/Hub):** \`site.com/for/{target}/{city}\` or \`site.com/{locale}/{service}/{city}\`.
-  - ❌ **Never 5 to 6 Segments:** Avoid \`/solutions/ai/autopost/facebook/fr/lyon\`.
-- **Rule B (Eliminate All Parasite Noise Words):**
-  - Banish generic wrapper words like \`/solutions/\`, \`/pages/\`, \`/items/\`. Go direct to user search intent: What you do + Platform + Location.
-- **Rule C (The SDK Does 100% of the Heavy Lifting):**
-  - The developer/AI only registers 3-4 product features and target cities in \`lib/seo.ts\`.
-  - The SDK automatically resolves routes in memory via \`matrixEngine.resolvePage(params.slug)\`, generates complete Schema.org graphs (LocalBusiness, AggregateRating, AggregateOffer), creates AEO summaries, builds FAQ accordions, and manages mesh linking in < 0.05ms.
-
----
-
-### 🏆 4. THE ARCHITECTURAL PLAYBOOK OF SAAS TITANS (7M+ PAGES WITH 0 DB BOTTLENECKS)
-
-How category leaders generate millions of high-converting pages without server saturation:
-
-1. **Proven Formulas of SaaS Giants:**
-   - ⚡ **Zapier (~25 Million pages):** \`App A × App B\` (e.g. "Connect WhatsApp to Shopify", "Sync Sheets with Notion").
-   - 🎨 **Canva (~50 Million pages):** \`Template Type × Industry/Theme × Format × Locale\` (e.g. "Restaurant Menu Italian A4").
-   - 💸 **Wise (~15 Million pages):** \`Currency Pair × Country × Dynamic Rate Calculator\`.
-   - 📊 **G2 & Capterra (~10 Million pages):** \`App A vs App B\` / \`Alternative to App X for [Role]\`.
-
-2. **The 4 Pillars of Zero-Latency (< 0.05ms) Resolution:**
-   - **0 Bytes in Database:** Never generate physical static files or query heavy databases per request. Pages are resolved mathematically in RAM upon arrival.
-   - **1 Single Universal Catch-All Route:** \`app/[...slug]/page.tsx\` handles all matrices through one lightweight layout.
-   - **Edge Caching & ISR:** The rendered HTML is instantly cached at the CDN/Edge on first request.
-   - **Automatic Siloing & Mesh Linking:**
-     - Links to 3 neighboring geographic cities for the same service.
-     - Links to 4 related professions/industries in the same target category.
-     - Complete Schema.org BreadcrumbList navigation.
-   - **Sharded XML Sitemaps:** Split into 50,000 URL chunks with a master sitemap index.
-   - **Dynamic \`/llms.txt\` Feed:** High-density Markdown stream enabling direct indexing by ChatGPT Search & Perplexity.
-
----
-
-### 🛠️ 5. AI AGENT IMPLEMENTATION PROTOCOL (STEP-BY-STEP)
-
-When setting up programmatic SEO in any codebase, the AI Agent MUST generate these exact 4 files:
-
-#### File 1: Configuration & Dataset (\`lib/seo.ts\`)
-\`\`\`typescript
-import { PseoMatrixEngine } from "@lynxflow/seo-engine";
-
-export const matrixEngine = new PseoMatrixEngine();
-
-export const SEO_CONFIG = {
-  brandName: "Acme",
-  language: "fr",
-  countries: ["france", "belgique", "suisse"], // Or "europe" / "international". The SDK automatically provides verified cities!
-  cleanDirectRoutes: true, // Eliminates parasite words (/solutions/, etc.)
-  minPopulationToIndex: 15_000,
-};
-
-// Discovered EXCLUSIVELY from Frontend UI components
-// NOTE: DO NOT list cities manually! The SDK auto-provisions them based on your target countries/scope.
-export const PSEO_DATASET = {
-  services: [
-    // 1 per major frontend feature branch
-    { slug: "autopost-facebook", name: "Autopost Facebook & Instagram", category: "Social Media", keyFeatures: ["AI Scheduling", "Visual Calendar", "Auto-Hashtags"], description: "Automated social media posting engine" },
-  ],
-  targets: [
-    { slug: "agences", name: "Marketing Agencies", type: "industry", painPoints: ["Manual Posting"], benefits: ["10x Output"] },
-  ],
-  integrations: [
-    { slug: "shopify", name: "Shopify", category: "E-Commerce", syncFeatures: ["Catalog sync"] },
-  ],
-  templates: [
-    { slug: "social-calendar-excel", title: "Social Media Calendar", topic: "Social Media", format: "excel", benefits: ["Instant setup"] },
-  ],
-  glossaryTerms: [
-    { slug: "engagement-rate", term: "Engagement Rate", shortDefinition: "Percentage of audience interacting with content" },
-  ],
-};
-\`\`\`
-
-#### File 2: Ultra-Modern Dynamic Catch-All Route (\`app/[...slug]/page.tsx\`)
-\`\`\`tsx
-import { notFound } from "next/navigation";
-import Link from "next/link";
-import { matrixEngine, SEO_CONFIG, PSEO_DATASET } from "@/lib/seo";
-import { renderBrandIconSvg } from "@lynxflow/seo-engine";
-
-export async function generateMetadata({ params }: { params: { slug: string[] } }) {
-  const domain = process.env.NEXT_PUBLIC_SITE_URL || "https://example.com";
-  const page = matrixEngine.resolvePage(params.slug, domain, PSEO_DATASET, SEO_CONFIG);
-  if (!page) return {};
-  return { title: page.title, description: page.description, alternates: { canonical: page.canonicalUrl }, robots: page.robots };
-}
-
-export default async function ProgrammaticPage({ params }: { params: { slug: string[] } }) {
-  const domain = process.env.NEXT_PUBLIC_SITE_URL || "https://example.com";
-  const page = matrixEngine.resolvePage(params.slug, domain, PSEO_DATASET, SEO_CONFIG);
-  if (!page) notFound();
-
-  // Automatic Brand Icon Detection
-  const brandSvg = renderBrandIconSvg(page.integration?.name || page.competitor?.name || page.service?.name || "");
-
-  return (
-    <article className="min-h-screen bg-background text-foreground transition-colors duration-200">
-      {/* 1. Official Google Schema.org JSON-LD */}
-      <script type="application/ld+json" dangerouslySetInnerHTML={{ __html: JSON.stringify(page.schemaGraph) }} />
-
-      <main className="max-w-5xl mx-auto px-4 sm:px-6 lg:px-8 py-12 md:py-16 space-y-12">
-        {/* 2. Hero Section with Glassmorphism Badge */}
-        <header className="space-y-6 text-center md:text-left">
-          <div className="inline-flex items-center gap-2 px-3 py-1 rounded-full text-xs font-semibold bg-primary/10 text-primary border border-primary/20 backdrop-blur-md">
-            {brandSvg && <span dangerouslySetInnerHTML={{ __html: brandSvg }} className="w-4 h-4 flex items-center" />}
-            <span>{page.matrixFamily.toUpperCase()}</span>
-          </div>
-
-          <h1 className="text-4xl sm:text-5xl lg:text-6xl font-black tracking-tight leading-tight">
-            {page.h1}
-          </h1>
-          <p className="text-lg sm:text-xl text-muted-foreground max-w-3xl leading-relaxed">
-            {page.description}
-          </p>
-        </header>
-
-        {/* 3. AEO / GEO Direct-Answer Callout Box (Optimized for ChatGPT & Perplexity Citations) */}
-        <section className="p-6 md:p-8 rounded-2xl bg-card border border-border shadow-sm space-y-3" data-geo-extract="true">
-          <div className="flex items-center gap-2 text-primary font-bold text-sm">
-            <span>⚡</span>
-            <span>Direct Summary & Key Takeaways</span>
-          </div>
-          <p className="text-base text-card-foreground leading-relaxed">
-            {page.description}
-          </p>
-        </section>
-
-        {/* 4. Interactive Value & Feature Grid */}
-        <section className="grid grid-cols-1 md:grid-cols-3 gap-6">
-          {(page.service?.keyFeatures || ["Real-time Sync", "Bank-grade Security", "Zero Lock-in"]).map((feat, idx) => (
-            <div key={idx} className="p-6 rounded-xl bg-card/60 border border-border/80 hover:border-primary/50 transition duration-200 space-y-2">
-              <div className="w-8 h-8 rounded-lg bg-primary/10 text-primary flex items-center justify-center font-bold text-sm">
-                0{idx + 1}
-              </div>
-              <h3 className="font-bold text-lg">{feat}</h3>
-              <p className="text-sm text-muted-foreground">Automated workflows engineered for high-performance scale.</p>
-            </div>
-          ))}
-        </section>
-
-        {/* 5. Geodesic Mesh Linking Footer (Prevents Orphan Pages & Spreads PageRank) */}
-        {page.neighboringLinks && page.neighboringLinks.length > 0 && (
-          <nav className="pt-8 border-t border-border space-y-4">
-            <h3 className="text-sm font-semibold uppercase tracking-wider text-muted-foreground">Nearby & Related Hubs</h3>
-            <div className="flex flex-wrap gap-2">
-              {page.neighboringLinks.map((link, idx) => (
-                <Link key={idx} href={link.url} className="px-3 py-1.5 rounded-lg text-xs font-medium bg-secondary text-secondary-foreground hover:bg-primary hover:text-primary-foreground transition duration-150">
-                  {link.name}
-                </Link>
-              ))}
-            </div>
-          </nav>
-        )}
-
-        {/* 6. SeedRank Legal Compliance Notice */}
-        {page.disclaimerText && (
-          <aside className="p-4 rounded-lg bg-muted/40 border border-border text-xs text-muted-foreground leading-relaxed">
-            {page.disclaimerText}
-          </aside>
-        )}
-      </main>
-    </article>
-  );
-}
-\`\`\`
-
-#### File 3: Dynamic XML Sitemap (\`app/sitemap.ts\`)
-\`\`\`typescript
-import { MetadataRoute } from "next";
-import { matrixEngine, SEO_CONFIG, PSEO_DATASET } from "@/lib/seo";
-
-export default function sitemap(): MetadataRoute.Sitemap {
-  const domain = process.env.NEXT_PUBLIC_SITE_URL || "https://example.com";
-  return matrixEngine.generateAllMatrices(domain, PSEO_DATASET, SEO_CONFIG)
-    .filter((p) => p.robots.includes("index"))
-    .map((p) => ({
-      url: p.canonicalUrl,
-      lastModified: new Date(),
-      changeFrequency: "weekly",
-      priority: 0.8,
-    }));
-}
-\`\`\`
-
-#### File 4: Dynamic AI Search Markdown Feed (\`app/llms.txt/route.ts\`)
-\`\`\`typescript
-import { NextResponse } from "next/server";
-import { matrixEngine, SEO_CONFIG, PSEO_DATASET } from "@/lib/seo";
-
-export async function GET() {
-  const domain = process.env.NEXT_PUBLIC_SITE_URL || "https://example.com";
-  // ⚡ 1-Line high-density Markdown feed for ChatGPT Search & Perplexity
-  const markdown = matrixEngine.generateLlmsTxt(domain, PSEO_DATASET, SEO_CONFIG);
-  return new NextResponse(markdown, { headers: { "Content-Type": "text/plain; charset=utf-8" } });
-}
-\`\`\`
-
-#### File 5: Dynamic AI Search & Bot Rules (\`app/robots.ts\` or \`public/robots.txt\`)
-\`\`\`typescript
-import { MetadataRoute } from "next";
-import { matrixEngine } from "@/lib/seo";
-
-export default function robots(): MetadataRoute.Robots {
-  const domain = process.env.NEXT_PUBLIC_SITE_URL || "https://example.com";
-  return {
-    rules: [
-      { userAgent: "*", allow: "/", disallow: ["/api/", "/admin/"] },
-      { userAgent: ["GPTBot", "ClaudeBot", "PerplexityBot", "Applebot"], allow: "/" },
-    ],
-    sitemap: \`\${domain}/sitemap.xml\`,
-  };
-}
-\`\`\`
-
----
-
-### 🧰 6. THE COMPLETE LYNXSEO STUDIO ENGINE & TOOL SUITE
-
-The SDK equips applications with 9 enterprise-grade SEO engines:
-
-1. **⚡ In-Memory Programmatic Matrix Engine (\`matrixEngine\`):**
-   - \`resolvePage(slug, domain, data, config)\`: Resolves full programmatic pages in < 0.05ms in local RAM.
-   - \`resolveServicePage(serviceSlug, citySlug, ...)\`: Dedicated routing for \`app/[service]/[city]/page.tsx\`.
-   - \`generateSitemapXml()\`, \`generateLlmsTxt()\`, \`generateRobotsTxt()\`.
-
-2. **🌍 Built-in Global Demographics (\`built-in-locations.ts\`):**
-   - Automatically provisions verified cities, populations, GPS coordinates, and currencies across France, Spain, Germany, UK, US, Belgium, Switzerland, Italy, Canada, Europe, and International markets. Zero manual city typing.
-
-3. **🌐 Dynamic i18n Detector (\`I18nDetector\`):**
-   - Seamless auto-detection and normalization across \`next-intl\`, \`i18next\`, \`paraglide\`, and \`astro:i18n\`. Adapts Google schemas and local currencies automatically.
-
-4. **🎨 Vector Brand & Social Icons (\`renderBrandIconSvg\`):**
-   - Zero-dependency official SVG vectors for 30+ brands (Facebook, Instagram, LinkedIn, Shopify, Slack, WhatsApp, Google, GitHub, TikTok, YouTube).
-
-5. **✨ Standard UI & Feature Icons (\`renderUiIconSvg\`, \`resolveFeatureIcon\`):**
-   - Zero-dependency Lucide-style vector icons (shield, zap, chart, calendar, users, rocket, sparkles, check, lock, clock, phone, mapPin, euro).
-   - Semantic keyword auto-resolver: Automatically maps feature copy to the most relevant icon.
-
-6. **🖼️ Dynamic OpenGraph (OG) Image Generator (\`OgImageGenerator\`):**
-   - \`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. **🛠️ 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\`.
-
-9. **🔍 URL Decomposition & Analysis (\`UrlyticsEngine\`):**
-   - Deep structural directory decomposition, depth tracking, query parameter analysis, and slug tokenization (inspired by advertools).
-
-10. **⚡ SEM Keyword Combinator (\`KeywordPermutatorEngine\`):**
-   - Combinatorial matrix generation: Products × Modifiers × Locations with match types (\`[exact]\`, \`"phrase"\`, \`+broad\`) and intent classification.
-
-11. **⚖️ Legal & Editorial Compliance (\`LegalDisclaimerEngine\`):**
-   - 7 SeedRank-grade disclaimer templates, 90-day staleness verification, and multi-language anti-disparagement guardian.
-
-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.
-
-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();
-
-/**
- * Returns the complete LLM guidance prompt for AI agents and developer copilots.
- */
-export function getSeoAgentPrompt(customContext?: { brandName?: string; domain?: string }): string {
-  if (!customContext) return PSEO_AGENT_SYSTEM_PROMPT;
-
-  return `
-${PSEO_AGENT_SYSTEM_PROMPT}
-
-### 🏢 Current Project Context:
-- Brand Name: ${customContext.brandName || "Our Platform"}
-- Domain: ${customContext.domain || "https://example.com"}
-`.trim();
-}

package/src/master-marketing-engine.ts

@@ -1,314 +0,0 @@
-/**
- * 👑 Master Marketing Engine (LynxSEO × marketingskills)
- *
- * Implements the complete 50-Skill Marketing & Growth Architecture:
- * 1. Directory Submissions Engine (ProductHunt, G2, AlternativeTo, Futurepedia, SaaSHub...)
- * 2. Grand Slam Offer & Value Stack Builder (Alex Hormozi framework)
- * 3. Viral Referral & Affiliate Growth Loops
- * 4. Multi-Touch Attribution Engine (First, Last, Linear, W-Shaped)
- * 5. Competitor Battlecards & Displacement Generator
- * 6. Churn Prevention & Retention Engine
- * 7. Onboarding & Lifecycle Drip Sequencer
- */
-
-export interface DirectorySubmissionProfile {
-  directoryName: string;
-  category: "tier1_launch" | "saas_directories" | "ai_directories" | "review_platforms";
-  submissionUrl: string;
-  domainRating: number;
-  dofollow: boolean;
-  requiredFields: {
-    title60Chars: string;
-    tagline: string;
-    shortDescription: string;
-    fullDescription: string;
-    tags: string[];
-    suggestedLandingPagePath: string;
-  };
-}
-
-export interface GrandSlamOffer {
-  productName: string;
-  dreamOutcome: string;
-  perceivedLikelihoodScore: number; // 1-10
-  timeDelayMinutes: number;
-  effortScore: number; // 1-10 (lower is better)
-  valueScore: number; // calculated
-  corePrice: number;
-  bonusStack: { title: string; perceivedValueEur: number; description: string }[];
-  totalPerceivedValueEur: number;
-  guaranteeText: string;
-  scarcityText: string;
-}
-
-export interface CompetitorBattlecard {
-  competitorName: string;
-  competitorPriceMonthly: number;
-  lynxSeoPriceMonthly: number;
-  annualSavingsEur: number;
-  keyWeaknessesToExploit: string[];
-  ourUnfairAdvantages: string[];
-  killerSwitchingArgument: string;
-  objectionHandlers: { objection: string; winningResponse: string }[];
-}
-
-export class MasterMarketingEngine {
-  /**
-   * 1. Generates 40+ customized directory submissions formatted for ProductHunt, G2, SaaSHub, Futurepedia...
-   */
-  static generateDirectoryListings(domain = "lynxintel.io", brandName = "LynxSEO"): DirectorySubmissionProfile[] {
-    return [
-      {
-        directoryName: "Product Hunt",
-        category: "tier1_launch",
-        submissionUrl: "https://www.producthunt.com/posts/new",
-        domainRating: 91,
-        dofollow: true,
-        requiredFields: {
-          title60Chars: `${brandName} — AI & Programmatic SEO in < 0.05ms`,
-          tagline: "Generate 500k landing pages & get cited by ChatGPT & Perplexity",
-          shortDescription: "Zero-database programmatic SEO engine that deploys 8 rich matrices with real-time AI bot tracking.",
-          fullDescription: `${brandName} is the all-in-one programmatic SEO and AI Search (GEO) platform. It solves the 8 programmatic matrices in-memory, injects Google Schema.org and .geo-direct-answer blocks, and tracks rankings and AI crawlers at zero extra tool cost.`,
-          tags: ["SEO", "Artificial Intelligence", "Marketing", "SaaS", "Developer Tools"],
-          suggestedLandingPagePath: `https://${domain}/?ref=producthunt`,
-        },
-      },
-      {
-        directoryName: "AlternativeTo",
-        category: "saas_directories",
-        submissionUrl: "https://alternativeto.net/software/submit/",
-        domainRating: 84,
-        dofollow: true,
-        requiredFields: {
-          title60Chars: `${brandName} — Open Source Alternative to Semrush & Ahrefs`,
-          tagline: "Free rank tracking, 41 technical SEO rules, and programmatic pages",
-          shortDescription: "A modern alternative to legacy SEO tools with built-in AI search optimization and zero SQL overhead.",
-          fullDescription: `Replace expensive subscriptions with ${brandName}. Features include 8 combinatorial programmatic matrices, automated mesh linking, SERP tracking, and AI crawler logs analysis.`,
-          tags: ["SEO Tools", "Keyword Research", "Website Analytics", "Open Source"],
-          suggestedLandingPagePath: `https://${domain}/alternatives/alternative-a-semrush?ref=alternativeto`,
-        },
-      },
-      {
-        directoryName: "Futurepedia",
-        category: "ai_directories",
-        submissionUrl: "https://www.futurepedia.io/submit-tool",
-        domainRating: 78,
-        dofollow: true,
-        requiredFields: {
-          title60Chars: `${brandName} — Generative Engine Optimization (GEO) & pSEO`,
-          tagline: "Optimize your brand for ChatGPT Search, Perplexity and Googlebot",
-          shortDescription: "Automated direct answer synthesis and Schema.org knowledge graph linker for AI search dominance.",
-          fullDescription: `${brandName} prepares your website for the AI search era. Generates .geo-direct-answer blocks, tracks AI bot visits, and extracts Google Knowledge Graph entities.`,
-          tags: ["SEO", "Generative AI", "Content Creation", "Productivity"],
-          suggestedLandingPagePath: `https://${domain}/solutions/geo-optimization?ref=futurepedia`,
-        },
-      },
-      {
-        directoryName: "SaaSHub",
-        category: "saas_directories",
-        submissionUrl: "https://www.saashub.com/submit",
-        domainRating: 77,
-        dofollow: true,
-        requiredFields: {
-          title60Chars: `${brandName} — High-Speed Programmatic SEO Platform`,
-          tagline: "Scalable landing pages for modern web frameworks",
-          shortDescription: "TypeScript SDK and SaaS cockpit for Next.js, Astro, and Shopify programmatic SEO.",
-          fullDescription: `Build high-converting local and B2B comparison landing pages in minutes with ${brandName}. Includes automated internal crosslinking and tiered indexing.`,
-          tags: ["SEO", "Web Development", "Marketing Automation"],
-          suggestedLandingPagePath: `https://${domain}/?ref=saashub`,
-        },
-      },
-    ];
-  }
-
-  /**
-   * 2. Builds a Grand Slam Offer (Alex Hormozi Value Equation).
-   */
-  static buildGrandSlamOffer(serviceName = "LynxSEO Growth"): GrandSlamOffer {
-    const bonusStack = [
-      {
-        title: "Pack 41 Règles d'Audit Technique Automatisées",
-        perceivedValueEur: 490,
-        description: "Détection immédiate des ruptures de balises H1-H3, boucles de redirections et cannibalisation.",
-      },
-      {
-        title: "Moteur de Maillage Géographique Mesh Linking",
-        perceivedValueEur: 750,
-        description: "Algorithme géodésique reliant automatiquement les 4 villes voisines les plus proches.",
-      },
-      {
-        title: "Widget de Conversion WhatsApp & Formulaires CRO",
-        perceivedValueEur: 350,
-        description: "Bouton d'acquisition directe pour capturer les prospects mobiles sans friction.",
-      },
-      {
-        title: "Calendrier Éditorial Brand DNA sur 4 Semaines",
-        perceivedValueEur: 600,
-        description: "12 pages et articles planifiés sur-mesure d'après l'ADN de votre marque.",
-      },
-    ];
-
-    const totalBonusValue = bonusStack.reduce((acc, b) => acc + b.perceivedValueEur, 0);
-    const corePrice = 149;
-
-    // Value equation: (Dream outcome (10) * Likelihood (9)) / (Time delay (1) * Effort (2)) = 45.0
-    const valueScore = Math.round(((10 * 9) / (1 * 2)) * 10) / 10;
-
-    return {
-      productName: serviceName,
-      dreamOutcome: "Dominance n°1 sur Google et ChatGPT Search avec 500k pages programmatiques actives",
-      perceivedLikelihoodScore: 9,
-      timeDelayMinutes: 10,
-      effortScore: 2,
-      valueScore,
-      corePrice,
-      bonusStack,
-      totalPerceivedValueEur: corePrice + totalBonusValue,
-      guaranteeText: "Garantie 30 jours satisfait ou remboursé intégralement, sans aucune question.",
-      scarcityText: "Accès immédiat avec 10 000 crédits IA offerts pour les 100 premières inscriptions.",
-    };
-  }
-
-  /**
-   * 3. Generates Competitor Battlecard (Semrush, Ahrefs, HubSpot, Jasper).
-   */
-  static generateCompetitorBattlecard(competitor: "semrush" | "ahrefs" | "jasper"): CompetitorBattlecard {
-    const competitorData = {
-      semrush: {
-        name: "Semrush",
-        price: 249,
-        weaknesses: [
-          "Coût prohibitif (249 €/mois + 150 € par utilisateur supplémentaire)",
-          "Aucun générateur de pages programmatiques pSEO (juste de l'analyse passive)",
-          "Aucun tracking des bots IA (ChatGPT Search, PerplexityBot)",
-          "Interface lourde et complexe pour les équipes non-expertes",
-        ],
-        advantages: [
-          "Moteur pSEO 8 matrices intégré en direct (< 0.05ms)",
-          "Suivi des positions SERP et audit 41 règles à 0 € de surcoût API",
-          "Détection et analytics des moteurs IA (ChatGPT, Claude, Perplexity)",
-          "SDK TypeScript universel pour Next.js, Astro, Shopify",
-        ],
-        switchArg: "Pour le prix d'un seul mois de Semrush, vous obtenez 2 mois de LynxSEO avec la génération de 500 000 pages programmatiques incluses.",
-      },
-      ahrefs: {
-        name: "Ahrefs",
-        price: 199,
-        weaknesses: [
-          "Système de crédits ultra-strict qui bloque rapidement les audits",
-          "Pas de serveur MCP pour connecter vos agents IA (Claude / Cursor)",
-          "Aucune optimisation directe de la synthèse AEO / GEO",
-        ],
-        advantages: [
-          "Serveur MCP natif pour piloter votre SEO directement depuis Claude et Cursor",
-          "Générateur de flux RSS 2.0 & sitemaps partitionnés à 45 000 URLs",
-          "Maillage interne contextuel automatisé avec scoring sémantique",
-        ],
-        switchArg: "Passez d'un outil d'observation passif à un moteur d'action autonome piloté par IA.",
-      },
-      jasper: {
-        name: "Jasper AI",
-        price: 99,
-        weaknesses: [
-          "Génère du texte brut sans aucune architecture technique SEO",
-          "Ne gère ni les schémas JSON-LD, ni le maillage interne, ni l'indexation",
-        ],
-        advantages: [
-          "Génération de pages complètes avec schémas, FAQ, balises directes et routes dynamiques",
-          "Intégration directe dans votre framework web sans copier-coller",
-        ],
-        switchArg: "Remplacez la génération de texte isolée par un moteur SEO complet clé en main.",
-      },
-    };
-
-    const target = competitorData[competitor] || competitorData.semrush;
-    const lynxPrice = 149;
-    const annualSavings = (target.price - lynxPrice) * 12;
-
-    return {
-      competitorName: target.name,
-      competitorPriceMonthly: target.price,
-      lynxSeoPriceMonthly: lynxPrice,
-      annualSavingsEur: Math.max(0, annualSavings),
-      keyWeaknessesToExploit: target.weaknesses,
-      ourUnfairAdvantages: target.advantages,
-      killerSwitchingArgument: target.switchArg,
-      objectionHandlers: [
-        {
-          objection: "Nous utilisons déjà Semrush depuis des années.",
-          winningResponse: "Vous pouvez conserver vos historiques : LynxSEO importe vos mots-clés et génère immédiatement les 500 000 landing pages que Semrush ne sait pas construire.",
-        },
-        {
-          objection: "Est-ce difficile à intégrer ?",
-          winningResponse: "Moins de 10 minutes : 1 seule ligne de code dans Next.js (`seoEngine.resolve(path)`) ou Astro et vos 8 matrices sont en ligne.",
-        },
-      ],
-    };
-  }
-
-  /**
-   * 4. Multi-Touch Attribution Calculator (First Touch, Last Touch, Linear, W-Shaped).
-   */
-  static calculateAttribution(
-    touchpoints: { source: string; channel: "organic_seo" | "ai_search" | "direct" | "referral" }[],
-    dealValueEur: number,
-  ) {
-    if (touchpoints.length === 0) return {};
-
-    const n = touchpoints.length;
-
-    // Linear
-    const linearValue = dealValueEur / n;
-
-    // First touch (100% to first)
-    const firstTouch = { source: touchpoints[0].source, valueEur: dealValueEur };
-
-    // Last touch (100% to last)
-    const lastTouch = { source: touchpoints[n - 1].source, valueEur: dealValueEur };
-
-    // W-Shaped (40% first, 40% lead-creation / middle, 20% close)
-    const wShaped = touchpoints.map((t, idx) => {
-      let weight = 0.2;
-      if (idx === 0) weight = n === 1 ? 1.0 : 0.4;
-      else if (idx === n - 1) weight = 0.4;
-      else weight = 0.2 / Math.max(1, n - 2);
-
-      return {
-        source: t.source,
-        channel: t.channel,
-        attributedEur: Math.round(dealValueEur * weight * 100) / 100,
-      };
-    });
-
-    return {
-      dealValueEur,
-      touchpointsCount: n,
-      firstTouch,
-      lastTouch,
-      linearValuePerTouch: Math.round(linearValue * 100) / 100,
-      wShapedBreakdown: wShaped,
-    };
-  }
-
-  /**
-   * 5. Churn Prevention & Retention Engine.
-   */
-  static evaluateChurnRisk(signals: { daysSinceLastLogin: number; pagesGeneratedThisMonth: number; rankDropAlertsCount: number }) {
-    let riskScore = 0; // 0 to 100
-    if (signals.daysSinceLastLogin > 14) riskScore += 45;
-    else if (signals.daysSinceLastLogin > 7) riskScore += 20;
-
-    if (signals.pagesGeneratedThisMonth === 0) riskScore += 35;
-    if (signals.rankDropAlertsCount > 3) riskScore += 20;
-
-    const isHighRisk = riskScore >= 50;
-
-    return {
-      riskScore,
-      riskLevel: isHighRisk ? "CRITICAL" : riskScore >= 30 ? "MEDIUM" : "LOW",
-      recommendedAction: isHighRisk
-        ? "Déclencher l'email automatique d'assistance technique + offre de coaching SEO offert de 30 min."
-        : "Envoyer le digest hebdomadaire des mots-clés en Striking Distance pour relancer l'activation.",
-    };
-  }
-}