@lynxflow/seo-engine 1.8.29 → 2.0.0

package/src/ad-intelligence-cro.ts

@@ -1,140 +0,0 @@
-/**
- * ⚡ Unified Ad Intelligence & Social CRO Optimizer
- *
- * Inspired by top GitHub Ad Scraping architectures:
- * - Meta Ad Library GraphQL Collector
- * - Google Ads Transparency Center MCP
- * - TikTok Creative Center Top Ads Scraper
- *
- * Capabilities:
- * 1. Audits winning competitor ads (running > 90 days = proven profitable).
- * 2. Injects high-converting ad angles into Programmatic SEO landing pages to boost CRO.
- * 3. Generates multi-platform ad campaigns (Meta, Google RSAs, LinkedIn) from any SEO page.
- */
-
-export interface ProvenAdWinner {
-  competitorDomain: string;
-  platform: "meta_ad_library" | "google_transparency" | "tiktok_creative_center" | "linkedin_ads";
-  adHeadline: string;
-  adPrimaryText: string;
-  adHookType: "social_proof" | "pain_relief" | "roi_calculator" | "speed_simplicity" | "fear_of_missing_out";
-  daysActive: number; // > 90 days indicates a high-converting winning creative
-  provenConversionAngle: string;
-  extractedCommercialKeywords: string[];
-}
-
-export interface AdCampaignBrief {
-  platform: "meta" | "google_search" | "linkedin";
-  targetAudience: string;
-  primaryTextOrDescriptions: string[];
-  headlines: string[];
-  callToAction: string;
-  suggestedVisualAngle: string;
-  destinationSeoLandingPage: string;
-}
-
-export interface CroPageOptimization {
-  originalHeadline: string;
-  optimizedAdInspiredHeadline: string;
-  recommendedHeroHook: string;
-  recommendedCtaButtonText: string;
-  estimatedConversionUpliftPercent: number;
-}
-
-export class AdIntelligenceCroEngine {
-  /**
-   * 1. Simulates/Queries competitor ad archives across Meta, Google & TikTok.
-   */
-  static inspectCompetitorAds(competitorDomain: string, serviceName = "CRM Pipeline"): ProvenAdWinner[] {
-    const brand = competitorDomain.replace(/^https?:\/\//, "").split(".")[0];
-
-    return [
-      {
-        competitorDomain,
-        platform: "meta_ad_library",
-        adHeadline: `Gagnez 10h par semaine sur vos relances clients`,
-        adPrimaryText: `90% des entrepreneurs perdent des ventes à cause de devis non relancés. Découvrez comment ${brand} automatise tout sans code.`,
-        adHookType: "pain_relief",
-        daysActive: 142, // Actif depuis presque 5 mois = rentabilité confirmée
-        provenConversionAngle: "Gain de temps hebdomadaire chiffré + relance automatique",
-        extractedCommercialKeywords: ["logiciel relance devis", "automatisation pipeline vente", "crm sans code"],
-      },
-      {
-        competitorDomain,
-        platform: "google_transparency",
-        adHeadline: `Alternative N°1 à ${brand} | 3x Moins Cher & Sans Engagement`,
-        adPrimaryText: `Passez à la vitesse supérieure. Synchronisation temps réel, support en français 7j/7. Démarrez gratuitement en 2 minutes.`,
-        adHookType: "roi_calculator",
-        daysActive: 210, // Actif depuis 7 mois
-        provenConversionAngle: "Économies financières directes + Simplicité",
-        extractedCommercialKeywords: [`alternative a ${brand}`, `comparatif ${brand}`, "crm francais pas cher"],
-      },
-      {
-        competitorDomain,
-        platform: "tiktok_creative_center",
-        adHeadline: `Pov: Tu as arrêté de relancer tes clients à la main`,
-        adPrimaryText: `La fin des emails sans réponse. Voici la méthode qui convertit 85% des prospects sur WhatsApp.`,
-        adHookType: "speed_simplicity",
-        daysActive: 98,
-        provenConversionAngle: "Preuve visuelle avant/après + WhatsApp direct",
-        extractedCommercialKeywords: ["prospection whatsapp", "fermer des ventes vite", "automatisation business"],
-      },
-    ];
-  }
-
-  /**
-   * 2. Uses proven ad angles to upgrade landing page conversion rates (CRO).
-   */
-  static optimizeLandingPageCroWithAdInsights(originalTitle: string, adWinners: ProvenAdWinner[]): CroPageOptimization {
-    const topWinner = adWinners.find((a) => a.daysActive >= 90) || adWinners[0];
-
-    return {
-      originalHeadline: originalTitle,
-      optimizedAdInspiredHeadline: `${topWinner.adHeadline} — ${originalTitle}`,
-      recommendedHeroHook: topWinner.provenConversionAngle,
-      recommendedCtaButtonText: "Calculer mon gain de temps en 2 min ➔",
-      estimatedConversionUpliftPercent: 28.5, // Moyenne observée de +28.5% de conversion
-    };
-  }
-
-  /**
-   * 3. Generates complete ad creatives (Google Search Ads & Meta Ads) from a Programmatic SEO page.
-   */
-  static generateAdCampaignFromSeoPage(opts: {
-    seoPageUrl: string;
-    serviceName: string;
-    targetPersona: string;
-    pricePerMonthEur?: number;
-  }): AdCampaignBrief[] {
-    return [
-      {
-        platform: "google_search",
-        targetAudience: `Professionnels recherchant ${opts.serviceName}`,
-        headlines: [
-          `${opts.serviceName} pour ${opts.targetPersona}`,
-          `Testez ${opts.serviceName} Gratuitement`,
-          `Installation Express en 10 Min`,
-          `Dès ${opts.pricePerMonthEur || 49}€/mois sans engagement`,
-        ],
-        primaryTextOrDescriptions: [
-          `Automatisez votre acquisition et doublez vos conversions. Compatible avec votre site.`,
-          `Rejoignez plus de 1 200 entreprises qui utilisent notre moteur. Démo immédiate.`,
-        ],
-        callToAction: "Commencer Maintenant",
-        suggestedVisualAngle: "Capture d'écran du tableau de bord avec indicateurs de ROI en vert",
-        destinationSeoLandingPage: opts.seoPageUrl,
-      },
-      {
-        platform: "meta",
-        targetAudience: `Dirigeants et ${opts.targetPersona}`,
-        headlines: [`Arrêtez de perdre vos prospects : Découvrez ${opts.serviceName}`],
-        primaryTextOrDescriptions: [
-          `Vous passez trop de temps sur des tâches manuelles ?\n\nAvec ${opts.serviceName}, tout est automatisé en tâche de fond pour vous apporter des leads qualifiés sans effort.\n\n👉 Cliquez pour tester le simulateur de rentabilité gratuit.`,
-        ],
-        callToAction: "En savoir plus",
-        suggestedVisualAngle: "Carrousel 3 images montrant le problème / la solution / le résultat chiffré",
-        destinationSeoLandingPage: opts.seoPageUrl,
-      },
-    ];
-  }
-}

package/src/ai-bots-log-analyzer.ts

@@ -1,127 +0,0 @@
-/**
- * 📊 Server Crawl & AI Bots Log Analyzer (Inspiration: advertools/crawlytics.py & logs.py)
- *
- * Analyzes access log lines from Nginx, Apache, or Cloudflare to track real crawl activity
- * from Googlebot, GPTBot, ClaudeBot, PerplexityBot, and identify status anomalies.
- */
-
-export interface LogLine {
-  ip: string;
-  timestamp: string;
-  method: string;
-  urlPath: string;
-  statusCode: number;
-  bytesSent: number;
-  userAgent: string;
-}
-
-export type BotFamily =
-  | "googlebot-mobile"
-  | "googlebot-desktop"
-  | "gptbot"
-  | "claudebot"
-  | "perplexitybot"
-  | "bingbot"
-  | "generic-crawler"
-  | "human-visitor";
-
-export interface BotCrawlMetrics {
-  botFamily: BotFamily;
-  totalHits: number;
-  uniqueUrlsCount: number;
-  status200Count: number;
-  status3xxCount: number;
-  status4xxCount: number;
-  status5xxCount: number;
-  avgBytes: number;
-}
-
-export class AiBotsLogAnalyzer {
-  /**
-   * Classifies a User-Agent string into a recognized Search Engine or AI Crawler family.
-   */
-  static classifyUserAgent(ua: string): BotFamily {
-    const lowerUa = ua.toLowerCase();
-
-    if (lowerUa.includes("googlebot") && lowerUa.includes("mobile")) {
-      return "googlebot-mobile";
-    }
-    if (lowerUa.includes("googlebot")) {
-      return "googlebot-desktop";
-    }
-    if (lowerUa.includes("gptbot") || lowerUa.includes("chatgpt-user")) {
-      return "gptbot";
-    }
-    if (lowerUa.includes("claudebot") || lowerUa.includes("anthropic-ai")) {
-      return "claudebot";
-    }
-    if (lowerUa.includes("perplexitybot")) {
-      return "perplexitybot";
-    }
-    if (lowerUa.includes("bingbot")) {
-      return "bingbot";
-    }
-    if (lowerUa.includes("bot") || lowerUa.includes("crawl") || lowerUa.includes("spider")) {
-      return "generic-crawler";
-    }
-
-    return "human-visitor";
-  }
-
-  /**
-   * Aggregates an array of parsed log lines into comprehensive crawl metrics per bot family.
-   */
-  static aggregateCrawlStats(logs: LogLine[]): Record<BotFamily, BotCrawlMetrics> {
-    const stats: Record<string, {
-      totalHits: number;
-      uniqueUrls: Set<string>;
-      s200: number;
-      s3xx: number;
-      s4xx: number;
-      s5xx: number;
-      totalBytes: number;
-    }> = {};
-
-    for (const log of logs) {
-      const family = this.classifyUserAgent(log.userAgent);
-      if (!stats[family]) {
-        stats[family] = {
-          totalHits: 0,
-          uniqueUrls: new Set(),
-          s200: 0,
-          s3xx: 0,
-          s4xx: 0,
-          s5xx: 0,
-          totalBytes: 0,
-        };
-      }
-
-      const s = stats[family];
-      s.totalHits++;
-      s.uniqueUrls.add(log.urlPath);
-      s.totalBytes += log.bytesSent || 0;
-
-      if (log.statusCode >= 200 && log.statusCode < 300) s.s200++;
-      else if (log.statusCode >= 300 && log.statusCode < 400) s.s3xx++;
-      else if (log.statusCode >= 400 && log.statusCode < 500) s.s4xx++;
-      else if (log.statusCode >= 500) s.s5xx++;
-    }
-
-    const result: Partial<Record<BotFamily, BotCrawlMetrics>> = {};
-
-    for (const [familyKey, data] of Object.entries(stats)) {
-      result[familyKey as BotFamily] = {
-        botFamily: familyKey as BotFamily,
-        totalHits: data.totalHits,
-        uniqueUrlsCount: data.uniqueUrls.size,
-        status200Count: data.s200,
-        status3xxCount: data.s3xx,
-        status4xxCount: data.s4xx,
-        status5xxCount: data.s5xx,
-        avgBytes: data.totalHits > 0 ? Math.round(data.totalBytes / data.totalHits) : 0,
-      };
-    }
-
-    return result as Record<BotFamily, BotCrawlMetrics>;
-  }
-}

package/src/ai-copilot-client.ts

@@ -1,99 +0,0 @@
-/**
- * 🤖 LynxFlow AI Content Copilot Client
- *
- * Generates automated long-form blog articles, landing page copywriting,
- * FAQ expansions, and PAS framework marketing copy.
- */
-
-export interface GenerateArticleParams {
-  topic: string;
-  targetKeywords: string[];
-  targetAudience?: string;
-  tone?: "professional" | "persuasive" | "educational";
-  wordCount?: number;
-  locale?: string;
-  enableRag?: boolean;
-  siteId?: string;
-}
-
-export interface GeneratedArticleResult {
-  title: string;
-  metaDescription: string;
-  h1: string;
-  markdownContent: string;
-  htmlContent: string;
-  directAnswerSnippet: string;
-  faqs: { question: string; answer: string }[];
-  tokensConsumed: number;
-}
-
-import { LynxRagKnowledgeEngine } from "./rag-knowledge-engine";
-
-export class AiCopilotClient {
-  private apiKey: string;
-  private endpoint: string;
-
-  constructor(apiKey: string, endpoint = "https://lynxintel.io/api/v1/ai") {
-    this.apiKey = apiKey;
-    this.endpoint = endpoint;
-  }
-
-  /**
-   * Generates a complete SEO article with headings, FAQs, and Schema-ready JSON.
-   */
-  async generateArticle(params: GenerateArticleParams): Promise<GeneratedArticleResult> {
-    try {
-      // 1. Conditionally fetch RAG Facts only if enableRag is true
-      let ragFacts: string[] = [];
-      if (params.enableRag && params.siteId) {
-        const retrieved = LynxRagKnowledgeEngine.retrieveRelevantContext(params.siteId, params.topic, 3);
-        ragFacts = retrieved.map((r) => r.chunk.content);
-      }
-
-      if (!this.apiKey || this.apiKey.startsWith("demo_")) {
-        const title = `Guide Complet : ${params.topic} en 2026`;
-        const metaDescription = `Découvrez comment maîtriser ${params.topic} avec les meilleures pratiques, outils et stratégies pour accélérer vos résultats.`;
-        const h1 = `Tout Savoir sur ${params.topic}`;
-        const directAnswer = `${params.topic} permet aux entreprises d'optimiser leurs performances grâce à des processus automatisés et une intégration fluide.`;
-
-        const factsSection = ragFacts.length > 0
-          ? `\n\n## 🏢 Spécificités & Faits Certifiés de l'Entreprise\n\n${ragFacts.map((f) => `* ${f}`).join("\n")}`
-          : "";
-
-        return {
-          title,
-          metaDescription,
-          h1,
-          directAnswerSnippet: directAnswer,
-          markdownContent: `# ${h1}\n\n${metaDescription}\n\n## 1. Pourquoi ${params.topic} est incontournable\n\nOptimiser votre stratégie avec ${params.targetKeywords.join(", ")}.\n\n## 2. Étapes de Mise en Place\n\n- Configuration initiale rapide\n- Déploiement automatisé\n- Mesure du ROI${factsSection}`,
-          htmlContent: `<h1>${h1}</h1><p>${metaDescription}</p><h2>1. Pourquoi ${params.topic} est incontournable</h2><p>Optimiser votre stratégie avec ${params.targetKeywords.join(", ")}.</p>`,
-          faqs: [
-            { question: `Combien de temps pour mettre en place ${params.topic} ?`, answer: "La mise en place prend généralement moins de 15 minutes." },
-            { question: "Quels sont les bénéfices immédiats ?", answer: "Gain de temps, réduction des coûts et automatisation des tâches chronophages." },
-          ],
-          tokensConsumed: 450,
-        };
-      }
-
-      const res = await fetch(`${this.endpoint}/generate-article`, {
-        method: "POST",
-        headers: { "Content-Type": "application/json", Authorization: `Bearer ${this.apiKey}` },
-        body: JSON.stringify(params),
-      });
-
-      if (!res.ok) throw new Error("AI Copilot API error");
-      return (await res.json()) as GeneratedArticleResult;
-    } catch {
-      return {
-        title: params.topic,
-        metaDescription: `Guide sur ${params.topic}`,
-        h1: params.topic,
-        directAnswerSnippet: `${params.topic} est essentiel en 2026.`,
-        markdownContent: `# ${params.topic}`,
-        htmlContent: `<h1>${params.topic}</h1>`,
-        faqs: [],
-        tokensConsumed: 0,
-      };
-    }
-  }
-}

package/src/analytics-client.ts

@@ -1,315 +0,0 @@
-/**
- * 📊 LynxFlow Embedded Analytics & 360° Web Traffic Engine
- *
- * Tracks granular per-URL statistics, pageviews, unique visitors, conversions,
- * Core Web Vitals (LCP, INP, CLS), and AI Search Crawlers (ChatGPT, Perplexity, Claude, Googlebot).
- */
-
-export interface AnalyticsEventPayload {
-  path: string;
-  referrer?: string;
-  userAgent?: string;
-  country?: string;
-  durationMs?: number;
-  statusCode?: number;
-  isAiBot?: boolean;
-  botName?: string;
-  conversionType?: "cta_click" | "whatsapp_chat" | "lead_form" | "purchase";
-  coreWebVitals?: {
-    lcpMs?: number;
-    inpMs?: number;
-    cls?: number;
-  };
-}
-
-export interface UrlTrafficStats {
-  path: string;
-  totalViews: number;
-  uniqueVisitors: number;
-  humanViews: number;
-  aiBotHits: number;
-  avgTimeOnPageSec: number;
-  bounceRate: number; // 0.0 to 1.0
-  conversionsCount: number;
-  conversionRate: number; // e.g. 0.042 for 4.2%
-  lastAccessedAt: string;
-}
-
-export interface AnalyticsSummaryReport {
-  domain: string;
-  period: "24h" | "7d" | "30d" | "all";
-  totalPageViews: number;
-  uniqueVisitors: number;
-  bounceRate: number;
-  avgTimeOnPageSec: number;
-  totalConversions: number;
-  globalConversionRate: number;
-  topPages: UrlTrafficStats[];
-  aiBotVisits: { bot: string; hits: number; percentage: number }[];
-  trafficByCountry: { country: string; visitors: number; percentage: number }[];
-  trafficBySource: { source: "organic_search" | "ai_search" | "direct" | "referral" | "social"; count: number }[];
-  statusCodesSummary: { "200": number; "3xx": number; "404": number; "5xx": number };
-}
-
-export class LynxAnalyticsClient {
-  private apiKey: string;
-  private endpoint: string;
-
-  // In-memory real-time buffer for edge resolution
-  private static localUrlRegistry = new Map<string, UrlTrafficStats>();
-
-  constructor(apiKey: string, endpoint = "https://lynxintel.io/api/v1/analytics") {
-    this.apiKey = apiKey;
-    this.endpoint = endpoint;
-  }
-
-  /**
-   * Identifies if a User-Agent belongs to an AI search crawler or traditional search engine.
-   */
-  static detectAiBot(userAgent: string): { isAiBot: boolean; botName?: string } {
-    const ua = (userAgent || "").toLowerCase();
-    if (ua.includes("chatgpt-user") || ua.includes("oai-searchbot") || ua.includes("gptbot")) {
-      return { isAiBot: true, botName: "ChatGPT Search (OpenAI)" };
-    }
-    if (ua.includes("perplexitybot")) {
-      return { isAiBot: true, botName: "Perplexity AI" };
-    }
-    if (ua.includes("claudebot") || ua.includes("anthropic-ai")) {
-      return { isAiBot: true, botName: "Claude (Anthropic)" };
-    }
-    if (ua.includes("google-extended") || ua.includes("googlebot")) {
-      return { isAiBot: true, botName: "Googlebot / AI Overviews" };
-    }
-    if (ua.includes("bingbot")) {
-      return { isAiBot: true, botName: "Bingbot (Microsoft)" };
-    }
-    if (ua.includes("yandexbot")) {
-      return { isAiBot: true, botName: "YandexBot" };
-    }
-    if (ua.includes("baiduspider")) {
-      return { isAiBot: true, botName: "Baidu Spider" };
-    }
-    return { isAiBot: false };
-  }
-
-  /**
-   * Tracks a live pageview, visitor event, or conversion on a specific generated URL.
-   */
-  async trackPageView(event: AnalyticsEventPayload): Promise<boolean> {
-    try {
-      const aiInfo = event.userAgent ? LynxAnalyticsClient.detectAiBot(event.userAgent) : { isAiBot: false };
-      const isAi = event.isAiBot ?? aiInfo.isAiBot;
-      const botName = event.botName ?? aiInfo.botName;
-
-      // Update in-memory per-URL stats
-      const cleanPath = event.path.toLowerCase().replace(/\/+$/, "") || "/";
-      let stats = LynxAnalyticsClient.localUrlRegistry.get(cleanPath);
-
-      if (!stats) {
-        stats = {
-          path: cleanPath,
-          totalViews: 0,
-          uniqueVisitors: 0,
-          humanViews: 0,
-          aiBotHits: 0,
-          avgTimeOnPageSec: 0,
-          bounceRate: 0.35,
-          conversionsCount: 0,
-          conversionRate: 0,
-          lastAccessedAt: new Date().toISOString(),
-        };
-        LynxAnalyticsClient.localUrlRegistry.set(cleanPath, stats);
-      }
-
-      stats.totalViews++;
-      if (isAi) {
-        stats.aiBotHits++;
-      } else {
-        stats.humanViews++;
-        stats.uniqueVisitors++;
-      }
-
-      if (event.conversionType) {
-        stats.conversionsCount++;
-      }
-
-      stats.conversionRate = stats.humanViews > 0 ? Math.round((stats.conversionsCount / stats.humanViews) * 1000) / 1000 : 0;
-      stats.lastAccessedAt = new Date().toISOString();
-
-      if (!this.apiKey || this.apiKey.startsWith("demo_") || this.apiKey.startsWith("ba_test_") || this.apiKey.startsWith("lynx_starter_")) {
-        return true;
-      }
-
-      // Asynchronous non-blocking dispatch to central analytics ingest
-      fetch(`${this.endpoint}/track`, {
-        method: "POST",
-        headers: { "Content-Type": "application/json", Authorization: `Bearer ${this.apiKey}` },
-        body: JSON.stringify({
-          apiKey: this.apiKey,
-          timestamp: Date.now(),
-          ...event,
-          isAiBot: isAi,
-          botName,
-        }),
-      }).catch(() => {});
-
-      return true;
-    } catch {
-      return false;
-    }
-  }
-
-  /**
-   * Returns per-URL statistics for all tracked programmatic links in this session/domain.
-   */
-  getUrlStats(path?: string): UrlTrafficStats | UrlTrafficStats[] {
-    if (path) {
-      const cleanPath = path.toLowerCase().replace(/\/+$/, "") || "/";
-      return (
-        LynxAnalyticsClient.localUrlRegistry.get(cleanPath) || {
-          path: cleanPath,
-          totalViews: 0,
-          uniqueVisitors: 0,
-          humanViews: 0,
-          aiBotHits: 0,
-          avgTimeOnPageSec: 0,
-          bounceRate: 0,
-          conversionsCount: 0,
-          conversionRate: 0,
-          lastAccessedAt: new Date().toISOString(),
-        }
-      );
-    }
-    return Array.from(LynxAnalyticsClient.localUrlRegistry.values()).sort((a, b) => b.totalViews - a.totalViews);
-  }
-
-  /**
-   * Retrieves an exhaustive 360° analytics and AI search traffic report for the site.
-   */
-  async getSummary(domain = "mon-entreprise.com", period: "24h" | "7d" | "30d" | "all" = "30d"): Promise<AnalyticsSummaryReport> {
-    try {
-      const localPages = this.getUrlStats() as UrlTrafficStats[];
-
-      if (localPages.length > 0) {
-        const totalViews = localPages.reduce((acc, p) => acc + p.totalViews, 0);
-        const uniqueVisitors = localPages.reduce((acc, p) => acc + p.uniqueVisitors, 0);
-        const totalConversions = localPages.reduce((acc, p) => acc + p.conversionsCount, 0);
-        const totalAiHits = localPages.reduce((acc, p) => acc + p.aiBotHits, 0);
-
-        return {
-          domain,
-          period,
-          totalPageViews: totalViews,
-          uniqueVisitors,
-          bounceRate: 0.36,
-          avgTimeOnPageSec: 78,
-          totalConversions,
-          globalConversionRate: uniqueVisitors > 0 ? Math.round((totalConversions / uniqueVisitors) * 1000) / 10 : 3.8,
-          topPages: localPages.slice(0, 15),
-          aiBotVisits: [
-            { bot: "ChatGPT Search (OpenAI)", hits: Math.round(totalAiHits * 0.45), percentage: 45 },
-            { bot: "Googlebot / AI Overviews", hits: Math.round(totalAiHits * 0.35), percentage: 35 },
-            { bot: "Perplexity AI", hits: Math.round(totalAiHits * 0.20), percentage: 20 },
-          ],
-          trafficByCountry: [
-            { country: "FR", visitors: Math.round(uniqueVisitors * 0.65), percentage: 65 },
-            { country: "BE", visitors: Math.round(uniqueVisitors * 0.15), percentage: 15 },
-            { country: "CH", visitors: Math.round(uniqueVisitors * 0.12), percentage: 12 },
-            { country: "CA", visitors: Math.round(uniqueVisitors * 0.08), percentage: 8 },
-          ],
-          trafficBySource: [
-            { source: "organic_search", count: Math.round(totalViews * 0.58) },
-            { source: "ai_search", count: Math.round(totalViews * 0.24) },
-            { source: "direct", count: Math.round(totalViews * 0.12) },
-            { source: "referral", count: Math.round(totalViews * 0.06) },
-          ],
-          statusCodesSummary: { "200": totalViews, "3xx": 0, "404": 0, "5xx": 0 },
-        };
-      }
-
-      // Default high-fidelity baseline
-      return {
-        domain,
-        period,
-        totalPageViews: 18450,
-        uniqueVisitors: 8120,
-        bounceRate: 0.34,
-        avgTimeOnPageSec: 82,
-        totalConversions: 342,
-        globalConversionRate: 4.2,
-        topPages: [
-          {
-            path: "/solutions/crm-pipeline/fr/lyon",
-            totalViews: 3200,
-            uniqueVisitors: 1450,
-            humanViews: 1320,
-            aiBotHits: 130,
-            avgTimeOnPageSec: 94,
-            bounceRate: 0.31,
-            conversionsCount: 78,
-            conversionRate: 0.059,
-            lastAccessedAt: new Date().toISOString(),
-          },
-          {
-            path: "/comparatif/crm-pipeline-vs-hubspot",
-            totalViews: 2840,
-            uniqueVisitors: 1290,
-            humanViews: 1180,
-            aiBotHits: 110,
-            avgTimeOnPageSec: 112,
-            bounceRate: 0.28,
-            conversionsCount: 92,
-            conversionRate: 0.078,
-            lastAccessedAt: new Date().toISOString(),
-          },
-          {
-            path: "/secteurs/crm-pipeline-pour-avocats",
-            totalViews: 2150,
-            uniqueVisitors: 980,
-            humanViews: 910,
-            aiBotHits: 70,
-            avgTimeOnPageSec: 88,
-            bounceRate: 0.36,
-            conversionsCount: 54,
-            conversionRate: 0.059,
-            lastAccessedAt: new Date().toISOString(),
-          },
-        ],
-        aiBotVisits: [
-          { bot: "ChatGPT Search (OpenAI)", hits: 620, percentage: 42 },
-          { bot: "Googlebot / AI Overviews", hits: 540, percentage: 36 },
-          { bot: "Perplexity AI", hits: 320, percentage: 22 },
-        ],
-        trafficByCountry: [
-          { country: "FR", visitors: 5200, percentage: 64 },
-          { country: "BE", visitors: 1300, percentage: 16 },
-          { country: "CH", visitors: 980, percentage: 12 },
-          { country: "CA", visitors: 640, percentage: 8 },
-        ],
-        trafficBySource: [
-          { source: "organic_search", count: 10700 },
-          { source: "ai_search", count: 4420 },
-          { source: "direct", count: 2130 },
-          { source: "referral", count: 1200 },
-        ],
-        statusCodesSummary: { "200": 18120, "3xx": 210, "404": 110, "5xx": 10 },
-      };
-    } catch {
-      return {
-        domain,
-        period,
-        totalPageViews: 0,
-        uniqueVisitors: 0,
-        bounceRate: 0,
-        avgTimeOnPageSec: 0,
-        totalConversions: 0,
-        globalConversionRate: 0,
-        topPages: [],
-        aiBotVisits: [],
-        trafficByCountry: [],
-        trafficBySource: [],
-        statusCodesSummary: { "200": 0, "3xx": 0, "404": 0, "5xx": 0 },
-      };
-    }
-  }
-}