@lynxflow/seo-engine 1.7.5 → 1.7.7

package/dist/google-business-profile.d.ts

@@ -0,0 +1,46 @@
+export interface GoogleBusinessProfileConfig {
+    placeId?: string;
+    businessName: string;
+    category: string;
+    streetAddress: string;
+    addressLocality: string;
+    postalCode: string;
+    addressCountry: string;
+    telephone: string;
+    priceRange?: string;
+    latitude?: number;
+    longitude?: number;
+    openingHours?: string[];
+    ratingValue?: number;
+    reviewCount?: number;
+    googleMapsUrl?: string;
+}
+export interface GbpAuditResult {
+    score: number;
+    grade: "A+" | "A" | "B" | "C" | "D";
+    passedChecks: number;
+    totalChecks: number;
+    checks: Array<{
+        name: string;
+        status: "pass" | "warn" | "fail";
+        points: number;
+        description: string;
+        recommendation?: string;
+    }>;
+    summary: string;
+    localPackEligibility: "Excellente" | "Moyenne" | "Faible";
+}
+export declare class GoogleBusinessProfileEngine {
+    /**
+     * Generates Schema.org LocalBusiness JSON-LD structure matching Google specifications
+     */
+    static generateLocalBusinessSchema(config: GoogleBusinessProfileConfig): Record<string, any>;
+    /**
+     * Generates interactive HTML Badge with Google Review stars and direct Maps link
+     */
+    static generateGbpBadgeHtml(config: GoogleBusinessProfileConfig): string;
+    /**
+     * Complete Diagnostic & Audit of a Google Business Profile / Local SEO setup
+     */
+    static auditProfile(config: GoogleBusinessProfileConfig): GbpAuditResult;
+}

package/dist/index.d.ts

@@ -62,6 +62,8 @@ export * from "./yoast-parity";
 export * from "./social-growth-suite";
 export * from "./team-rbac";
 export * from "./real-reviews-sync";
+export * from "./google-business-profile";
+export * from "./video-youtube-analyzer";
 import { LynxSeoEngine, type EngineConfig } from "./engine";
 import { ApiKeyGuardian } from "./auth-key";
 import { TokenQuotaManager } from "./token-quota-manager";

package/dist/index.js

@@ -50,6 +50,7 @@ __export(exports_src, {
   createLynxSeoEngine: () => createLynxSeoEngine,
   cleanSeoSlug: () => cleanSeoSlug,
   YoastParityEngine: () => YoastParityEngine,
+  VideoYouTubeAnalyzer: () => VideoYouTubeAnalyzer,
   UrlyticsEngine: () => UrlyticsEngine,
   UI_ICONS: () => UI_ICONS,
   TokenQuotaManager: () => TokenQuotaManager,
@@ -91,6 +92,7 @@ __export(exports_src, {
   IndexNowClient: () => IndexNowClient,
   I18nDetector: () => I18nDetector,
   HyperswitchGateway: () => HyperswitchGateway,
+  GoogleBusinessProfileEngine: () => GoogleBusinessProfileEngine,
   GeoMeshLinkingEngine: () => GeoMeshLinkingEngine,
   FreePublicToolsEngine: () => FreePublicToolsEngine,
   ExtendedSchemaGraphBuilder: () => ExtendedSchemaGraphBuilder,
@@ -7076,6 +7078,274 @@ class RealReviewsSyncEngine {
     `;
   }
 }
+// src/google-business-profile.ts
+class GoogleBusinessProfileEngine {
+  static generateLocalBusinessSchema(config) {
+    const schema = {
+      "@context": "https://schema.org",
+      "@type": config.category || "LocalBusiness",
+      name: config.businessName,
+      address: {
+        "@type": "PostalAddress",
+        streetAddress: config.streetAddress,
+        addressLocality: config.addressLocality,
+        postalCode: config.postalCode,
+        addressCountry: config.addressCountry || "FR"
+      },
+      telephone: config.telephone,
+      priceRange: config.priceRange || "€€"
+    };
+    if (config.latitude && config.longitude) {
+      schema.geo = {
+        "@type": "GeoCoordinates",
+        latitude: config.latitude,
+        longitude: config.longitude
+      };
+    }
+    if (config.openingHours && config.openingHours.length > 0) {
+      schema.openingHours = config.openingHours;
+    }
+    if (config.ratingValue && config.reviewCount) {
+      schema.aggregateRating = {
+        "@type": "AggregateRating",
+        ratingValue: config.ratingValue.toString(),
+        reviewCount: config.reviewCount.toString(),
+        bestRating: "5",
+        worstRating: "1"
+      };
+    }
+    if (config.googleMapsUrl || config.placeId) {
+      schema.hasMap = config.googleMapsUrl || `https://www.google.com/maps/place/?q=place_id:${config.placeId}`;
+    }
+    return schema;
+  }
+  static generateGbpBadgeHtml(config) {
+    const stars = "★".repeat(Math.round(config.ratingValue || 5)) + "☆".repeat(5 - Math.round(config.ratingValue || 5));
+    const mapsUrl = config.googleMapsUrl || (config.placeId ? `https://www.google.com/maps/place/?q=place_id:${config.placeId}` : "#");
+    return `
+      <div style="background:#ffffff;border:1px solid #e2e8f0;border-radius:12px;padding:16px 20px;max-width:420px;box-shadow:0 2px 4px rgba(0,0,0,0.04);font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,sans-serif;">
+        <div style="display:flex;align-items:center;justify-content:space-between;margin-bottom:8px;">
+          <div style="display:flex;align-items:center;gap:8px;">
+            <svg width="20" height="20" viewBox="0 0 24 24" fill="#4285F4"><path d="M12 2C8.13 2 5 5.13 5 9c0 5.25 7 13 7 13s7-7.75 7-13c0-3.87-3.13-7-7-7zm0 9.5c-1.38 0-2.5-1.12-2.5-2.5s1.12-2.5 2.5-2.5 2.5 1.12 2.5 2.5-1.12 2.5-2.5 2.5z"/></svg>
+            <strong style="font-size:15px;color:#0f172a;">${config.businessName}</strong>
+          </div>
+          <span style="font-size:11px;font-weight:700;color:#166534;background:#dcfce7;padding:2px 8px;border-radius:999px;">Vérifié Google</span>
+        </div>
+        <div style="font-size:13px;color:#475569;margin-bottom:8px;">
+          ${config.streetAddress}, ${config.postalCode} ${config.addressLocality}
+        </div>
+        <div style="display:flex;align-items:center;justify-content:space-between;border-top:1px solid #f1f5f9;padding-top:10px;">
+          <div style="display:flex;align-items:center;gap:6px;">
+            <span style="color:#f59e0b;letter-spacing:1px;font-size:14px;">${stars}</span>
+            <strong style="font-size:13px;color:#0f172a;">${config.ratingValue || "4.9"}/5</strong>
+            <span style="font-size:12px;color:#64748b;">(${config.reviewCount || "128"} avis)</span>
+          </div>
+          <a href="${mapsUrl}" target="_blank" rel="noopener noreferrer" style="font-size:12px;color:#2563eb;font-weight:600;text-decoration:none;">Voir sur Google Maps &rarr;</a>
+        </div>
+      </div>
+    `.trim();
+  }
+  static auditProfile(config) {
+    const checks = [];
+    let score = 0;
+    if (config.businessName && config.businessName.length >= 3) {
+      checks.push({
+        name: "Nom de l'établissement (NAP)",
+        status: "pass",
+        points: 15,
+        description: `Nom correctement configuré : "${config.businessName}".`
+      });
+      score += 15;
+    } else {
+      checks.push({
+        name: "Nom de l'établissement (NAP)",
+        status: "fail",
+        points: 15,
+        description: "Nom d'établissement manquant ou trop court.",
+        recommendation: "Renseignez le nom exact de votre entreprise tel qu'affiché sur Google Maps."
+      });
+    }
+    if (config.streetAddress && config.postalCode && config.addressLocality) {
+      checks.push({
+        name: "Adresse physique complète",
+        status: "pass",
+        points: 20,
+        description: `Adresse géolocalisée : ${config.streetAddress}, ${config.postalCode} ${config.addressLocality}.`
+      });
+      score += 20;
+    } else {
+      checks.push({
+        name: "Adresse physique complète",
+        status: "fail",
+        points: 20,
+        description: "Adresse ou code postal incomplet.",
+        recommendation: "Renseignez la rue, le code postal et la ville pour le ciblage Google Maps Local Pack."
+      });
+    }
+    if (config.telephone && config.telephone.length >= 8) {
+      checks.push({
+        name: "Téléphone direct vérifié",
+        status: "pass",
+        points: 10,
+        description: `Numéro de contact : ${config.telephone}.`
+      });
+      score += 10;
+    } else {
+      checks.push({
+        name: "Téléphone direct vérifié",
+        status: "warn",
+        points: 10,
+        description: "Numéro de téléphone absent.",
+        recommendation: "Ajoutez un numéro de téléphone fixe ou mobile local pour permettre les appels directs depuis les SERP."
+      });
+    }
+    if (config.latitude && config.longitude && !isNaN(config.latitude) && !isNaN(config.longitude)) {
+      checks.push({
+        name: "Coordonnées GPS (Lat / Long)",
+        status: "pass",
+        points: 15,
+        description: `Positionnement précis : ${config.latitude}, ${config.longitude}.`
+      });
+      score += 15;
+    } else {
+      checks.push({
+        name: "Coordonnées GPS (Lat / Long)",
+        status: "fail",
+        points: 15,
+        description: "Coordonnées GPS manquantes dans le schéma.",
+        recommendation: "Ajoutez les coordonnées de latitude/longitude exactes pour optimiser l'affichage dans le Google 3-Pack."
+      });
+    }
+    if (config.openingHours && config.openingHours.length > 0) {
+      checks.push({
+        name: "Horaires d'ouverture",
+        status: "pass",
+        points: 10,
+        description: `${config.openingHours.length} créneau(x) d'ouverture configuré(s).`
+      });
+      score += 10;
+    } else {
+      checks.push({
+        name: "Horaires d'ouverture",
+        status: "warn",
+        points: 10,
+        description: "Horaires d'ouverture non spécifiés.",
+        recommendation: "Indiquez vos horaires (ex: Mo-Fr 09:00-18:00) pour rassurer les clients et éviter le statut 'Fermé'."
+      });
+    }
+    const rating = config.ratingValue || 0;
+    const reviews = config.reviewCount || 0;
+    if (rating >= 4.5 && reviews >= 20) {
+      checks.push({
+        name: "Réputation & Preuve Sociale",
+        status: "pass",
+        points: 20,
+        description: `Excellente réputation : ${rating}/5 étoiles sur ${reviews} avis.`
+      });
+      score += 20;
+    } else if (rating >= 4 && reviews > 0) {
+      checks.push({
+        name: "Réputation & Preuve Sociale",
+        status: "warn",
+        points: 10,
+        description: `Note de ${rating}/5 avec ${reviews} avis.`,
+        recommendation: "Augmentez le volume d'avis certifiés au-delà de 20 avis pour maximiser le taux de conversion."
+      });
+      score += 10;
+    } else {
+      checks.push({
+        name: "Réputation & Preuve Sociale",
+        status: "fail",
+        points: 20,
+        description: "Avis clients absents ou note inférieure à 4.0.",
+        recommendation: "Activez la collecte d'avis clients réels pour afficher les étoiles dorées dans Google."
+      });
+    }
+    if (config.placeId || config.googleMapsUrl) {
+      checks.push({
+        name: "Lien Google Place ID officiel",
+        status: "pass",
+        points: 10,
+        description: "Lien direct vers la fiche Maps configuré."
+      });
+      score += 10;
+    } else {
+      checks.push({
+        name: "Lien Google Place ID officiel",
+        status: "warn",
+        points: 10,
+        description: "Place ID Google non renseigné.",
+        recommendation: "Associez votre Place ID Google pour faciliter l'indexation par Google Maps."
+      });
+    }
+    const passedChecks = checks.filter((c) => c.status === "pass").length;
+    const grade = score >= 90 ? "A+" : score >= 75 ? "A" : score >= 60 ? "B" : score >= 40 ? "C" : "D";
+    const eligibility = score >= 80 ? "Excellente" : score >= 50 ? "Moyenne" : "Faible";
+    return {
+      score,
+      grade,
+      passedChecks,
+      totalChecks: checks.length,
+      checks,
+      summary: `Score Local SEO de ${score}/100 (Grade ${grade}) — Éligibilité Google Local 3-Pack : ${eligibility}.`,
+      localPackEligibility: eligibility
+    };
+  }
+}
+// src/video-youtube-analyzer.ts
+class VideoYouTubeAnalyzer {
+  static extractVideoId(urlOrIframe) {
+    const regExp = /(?:youtube(?:-nocookie)?\.com\/(?:[^\/\n\s]+\/\S+\/|(?:v|e(?:mbed)?)\/|\S*?[?&]v=)|youtu\.be\/)([a-zA-Z0-9_-]{11})/;
+    const match = urlOrIframe.match(regExp);
+    return match ? match[1] : null;
+  }
+  static generateVideoObjectSchema(meta) {
+    const videoId = meta.videoId;
+    const thumbnail = meta.thumbnailUrl || `https://img.youtube.com/vi/${videoId}/maxresdefault.jpg`;
+    const embedUrl = meta.embedUrl || `https://www.youtube.com/embed/${videoId}`;
+    const schema = {
+      "@context": "https://schema.org",
+      "@type": "VideoObject",
+      name: meta.title,
+      description: meta.description,
+      thumbnailUrl: [thumbnail],
+      uploadDate: meta.uploadDate || new Date().toISOString().split("T")[0],
+      embedUrl,
+      contentUrl: `https://www.youtube.com/watch?v=${videoId}`
+    };
+    if (meta.duration) {
+      schema.duration = meta.duration;
+    }
+    if (meta.chapters && meta.chapters.length > 0) {
+      schema.hasPart = meta.chapters.map((c) => ({
+        "@type": "Clip",
+        name: c.title,
+        startOffset: c.time,
+        url: `https://www.youtube.com/watch?v=${videoId}&t=${c.time}s`
+      }));
+    }
+    return schema;
+  }
+  static generateSeoVideoEmbedHtml(meta) {
+    const videoId = meta.videoId;
+    const jsonLd = JSON.stringify(this.generateVideoObjectSchema(meta));
+    return `
+      <div class="lynxseo-video-wrapper" style="position:relative;padding-bottom:56.25%;height:0;overflow:hidden;border-radius:12px;box-shadow:0 4px 12px rgba(0,0,0,0.08);margin:24px 0;">
+        <iframe 
+          src="https://www.youtube.com/embed/${videoId}" 
+          title="${meta.title.replace(/"/g, "&quot;")}"
+          style="position:absolute;top:0;left:0;width:100%;height:100%;border:0;" 
+          allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" 
+          allowfullscreen 
+          loading="lazy">
+        </iframe>
+      </div>
+      <script type="application/ld+json">
+        ${jsonLd}
+      </script>
+    `.trim();
+  }
+}
 // src/index.ts
 function createLynxSeoEngine(config) {
   return new LynxSeoEngine(config);

package/dist/index.mjs

@@ -6964,6 +6964,274 @@ class RealReviewsSyncEngine {
     `;
   }
 }
+// src/google-business-profile.ts
+class GoogleBusinessProfileEngine {
+  static generateLocalBusinessSchema(config) {
+    const schema = {
+      "@context": "https://schema.org",
+      "@type": config.category || "LocalBusiness",
+      name: config.businessName,
+      address: {
+        "@type": "PostalAddress",
+        streetAddress: config.streetAddress,
+        addressLocality: config.addressLocality,
+        postalCode: config.postalCode,
+        addressCountry: config.addressCountry || "FR"
+      },
+      telephone: config.telephone,
+      priceRange: config.priceRange || "€€"
+    };
+    if (config.latitude && config.longitude) {
+      schema.geo = {
+        "@type": "GeoCoordinates",
+        latitude: config.latitude,
+        longitude: config.longitude
+      };
+    }
+    if (config.openingHours && config.openingHours.length > 0) {
+      schema.openingHours = config.openingHours;
+    }
+    if (config.ratingValue && config.reviewCount) {
+      schema.aggregateRating = {
+        "@type": "AggregateRating",
+        ratingValue: config.ratingValue.toString(),
+        reviewCount: config.reviewCount.toString(),
+        bestRating: "5",
+        worstRating: "1"
+      };
+    }
+    if (config.googleMapsUrl || config.placeId) {
+      schema.hasMap = config.googleMapsUrl || `https://www.google.com/maps/place/?q=place_id:${config.placeId}`;
+    }
+    return schema;
+  }
+  static generateGbpBadgeHtml(config) {
+    const stars = "★".repeat(Math.round(config.ratingValue || 5)) + "☆".repeat(5 - Math.round(config.ratingValue || 5));
+    const mapsUrl = config.googleMapsUrl || (config.placeId ? `https://www.google.com/maps/place/?q=place_id:${config.placeId}` : "#");
+    return `
+      <div style="background:#ffffff;border:1px solid #e2e8f0;border-radius:12px;padding:16px 20px;max-width:420px;box-shadow:0 2px 4px rgba(0,0,0,0.04);font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,sans-serif;">
+        <div style="display:flex;align-items:center;justify-content:space-between;margin-bottom:8px;">
+          <div style="display:flex;align-items:center;gap:8px;">
+            <svg width="20" height="20" viewBox="0 0 24 24" fill="#4285F4"><path d="M12 2C8.13 2 5 5.13 5 9c0 5.25 7 13 7 13s7-7.75 7-13c0-3.87-3.13-7-7-7zm0 9.5c-1.38 0-2.5-1.12-2.5-2.5s1.12-2.5 2.5-2.5 2.5 1.12 2.5 2.5-1.12 2.5-2.5 2.5z"/></svg>
+            <strong style="font-size:15px;color:#0f172a;">${config.businessName}</strong>
+          </div>
+          <span style="font-size:11px;font-weight:700;color:#166534;background:#dcfce7;padding:2px 8px;border-radius:999px;">Vérifié Google</span>
+        </div>
+        <div style="font-size:13px;color:#475569;margin-bottom:8px;">
+          ${config.streetAddress}, ${config.postalCode} ${config.addressLocality}
+        </div>
+        <div style="display:flex;align-items:center;justify-content:space-between;border-top:1px solid #f1f5f9;padding-top:10px;">
+          <div style="display:flex;align-items:center;gap:6px;">
+            <span style="color:#f59e0b;letter-spacing:1px;font-size:14px;">${stars}</span>
+            <strong style="font-size:13px;color:#0f172a;">${config.ratingValue || "4.9"}/5</strong>
+            <span style="font-size:12px;color:#64748b;">(${config.reviewCount || "128"} avis)</span>
+          </div>
+          <a href="${mapsUrl}" target="_blank" rel="noopener noreferrer" style="font-size:12px;color:#2563eb;font-weight:600;text-decoration:none;">Voir sur Google Maps &rarr;</a>
+        </div>
+      </div>
+    `.trim();
+  }
+  static auditProfile(config) {
+    const checks = [];
+    let score = 0;
+    if (config.businessName && config.businessName.length >= 3) {
+      checks.push({
+        name: "Nom de l'établissement (NAP)",
+        status: "pass",
+        points: 15,
+        description: `Nom correctement configuré : "${config.businessName}".`
+      });
+      score += 15;
+    } else {
+      checks.push({
+        name: "Nom de l'établissement (NAP)",
+        status: "fail",
+        points: 15,
+        description: "Nom d'établissement manquant ou trop court.",
+        recommendation: "Renseignez le nom exact de votre entreprise tel qu'affiché sur Google Maps."
+      });
+    }
+    if (config.streetAddress && config.postalCode && config.addressLocality) {
+      checks.push({
+        name: "Adresse physique complète",
+        status: "pass",
+        points: 20,
+        description: `Adresse géolocalisée : ${config.streetAddress}, ${config.postalCode} ${config.addressLocality}.`
+      });
+      score += 20;
+    } else {
+      checks.push({
+        name: "Adresse physique complète",
+        status: "fail",
+        points: 20,
+        description: "Adresse ou code postal incomplet.",
+        recommendation: "Renseignez la rue, le code postal et la ville pour le ciblage Google Maps Local Pack."
+      });
+    }
+    if (config.telephone && config.telephone.length >= 8) {
+      checks.push({
+        name: "Téléphone direct vérifié",
+        status: "pass",
+        points: 10,
+        description: `Numéro de contact : ${config.telephone}.`
+      });
+      score += 10;
+    } else {
+      checks.push({
+        name: "Téléphone direct vérifié",
+        status: "warn",
+        points: 10,
+        description: "Numéro de téléphone absent.",
+        recommendation: "Ajoutez un numéro de téléphone fixe ou mobile local pour permettre les appels directs depuis les SERP."
+      });
+    }
+    if (config.latitude && config.longitude && !isNaN(config.latitude) && !isNaN(config.longitude)) {
+      checks.push({
+        name: "Coordonnées GPS (Lat / Long)",
+        status: "pass",
+        points: 15,
+        description: `Positionnement précis : ${config.latitude}, ${config.longitude}.`
+      });
+      score += 15;
+    } else {
+      checks.push({
+        name: "Coordonnées GPS (Lat / Long)",
+        status: "fail",
+        points: 15,
+        description: "Coordonnées GPS manquantes dans le schéma.",
+        recommendation: "Ajoutez les coordonnées de latitude/longitude exactes pour optimiser l'affichage dans le Google 3-Pack."
+      });
+    }
+    if (config.openingHours && config.openingHours.length > 0) {
+      checks.push({
+        name: "Horaires d'ouverture",
+        status: "pass",
+        points: 10,
+        description: `${config.openingHours.length} créneau(x) d'ouverture configuré(s).`
+      });
+      score += 10;
+    } else {
+      checks.push({
+        name: "Horaires d'ouverture",
+        status: "warn",
+        points: 10,
+        description: "Horaires d'ouverture non spécifiés.",
+        recommendation: "Indiquez vos horaires (ex: Mo-Fr 09:00-18:00) pour rassurer les clients et éviter le statut 'Fermé'."
+      });
+    }
+    const rating = config.ratingValue || 0;
+    const reviews = config.reviewCount || 0;
+    if (rating >= 4.5 && reviews >= 20) {
+      checks.push({
+        name: "Réputation & Preuve Sociale",
+        status: "pass",
+        points: 20,
+        description: `Excellente réputation : ${rating}/5 étoiles sur ${reviews} avis.`
+      });
+      score += 20;
+    } else if (rating >= 4 && reviews > 0) {
+      checks.push({
+        name: "Réputation & Preuve Sociale",
+        status: "warn",
+        points: 10,
+        description: `Note de ${rating}/5 avec ${reviews} avis.`,
+        recommendation: "Augmentez le volume d'avis certifiés au-delà de 20 avis pour maximiser le taux de conversion."
+      });
+      score += 10;
+    } else {
+      checks.push({
+        name: "Réputation & Preuve Sociale",
+        status: "fail",
+        points: 20,
+        description: "Avis clients absents ou note inférieure à 4.0.",
+        recommendation: "Activez la collecte d'avis clients réels pour afficher les étoiles dorées dans Google."
+      });
+    }
+    if (config.placeId || config.googleMapsUrl) {
+      checks.push({
+        name: "Lien Google Place ID officiel",
+        status: "pass",
+        points: 10,
+        description: "Lien direct vers la fiche Maps configuré."
+      });
+      score += 10;
+    } else {
+      checks.push({
+        name: "Lien Google Place ID officiel",
+        status: "warn",
+        points: 10,
+        description: "Place ID Google non renseigné.",
+        recommendation: "Associez votre Place ID Google pour faciliter l'indexation par Google Maps."
+      });
+    }
+    const passedChecks = checks.filter((c) => c.status === "pass").length;
+    const grade = score >= 90 ? "A+" : score >= 75 ? "A" : score >= 60 ? "B" : score >= 40 ? "C" : "D";
+    const eligibility = score >= 80 ? "Excellente" : score >= 50 ? "Moyenne" : "Faible";
+    return {
+      score,
+      grade,
+      passedChecks,
+      totalChecks: checks.length,
+      checks,
+      summary: `Score Local SEO de ${score}/100 (Grade ${grade}) — Éligibilité Google Local 3-Pack : ${eligibility}.`,
+      localPackEligibility: eligibility
+    };
+  }
+}
+// src/video-youtube-analyzer.ts
+class VideoYouTubeAnalyzer {
+  static extractVideoId(urlOrIframe) {
+    const regExp = /(?:youtube(?:-nocookie)?\.com\/(?:[^\/\n\s]+\/\S+\/|(?:v|e(?:mbed)?)\/|\S*?[?&]v=)|youtu\.be\/)([a-zA-Z0-9_-]{11})/;
+    const match = urlOrIframe.match(regExp);
+    return match ? match[1] : null;
+  }
+  static generateVideoObjectSchema(meta) {
+    const videoId = meta.videoId;
+    const thumbnail = meta.thumbnailUrl || `https://img.youtube.com/vi/${videoId}/maxresdefault.jpg`;
+    const embedUrl = meta.embedUrl || `https://www.youtube.com/embed/${videoId}`;
+    const schema = {
+      "@context": "https://schema.org",
+      "@type": "VideoObject",
+      name: meta.title,
+      description: meta.description,
+      thumbnailUrl: [thumbnail],
+      uploadDate: meta.uploadDate || new Date().toISOString().split("T")[0],
+      embedUrl,
+      contentUrl: `https://www.youtube.com/watch?v=${videoId}`
+    };
+    if (meta.duration) {
+      schema.duration = meta.duration;
+    }
+    if (meta.chapters && meta.chapters.length > 0) {
+      schema.hasPart = meta.chapters.map((c) => ({
+        "@type": "Clip",
+        name: c.title,
+        startOffset: c.time,
+        url: `https://www.youtube.com/watch?v=${videoId}&t=${c.time}s`
+      }));
+    }
+    return schema;
+  }
+  static generateSeoVideoEmbedHtml(meta) {
+    const videoId = meta.videoId;
+    const jsonLd = JSON.stringify(this.generateVideoObjectSchema(meta));
+    return `
+      <div class="lynxseo-video-wrapper" style="position:relative;padding-bottom:56.25%;height:0;overflow:hidden;border-radius:12px;box-shadow:0 4px 12px rgba(0,0,0,0.08);margin:24px 0;">
+        <iframe 
+          src="https://www.youtube.com/embed/${videoId}" 
+          title="${meta.title.replace(/"/g, "&quot;")}"
+          style="position:absolute;top:0;left:0;width:100%;height:100%;border:0;" 
+          allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" 
+          allowfullscreen 
+          loading="lazy">
+        </iframe>
+      </div>
+      <script type="application/ld+json">
+        ${jsonLd}
+      </script>
+    `.trim();
+  }
+}
 // src/index.ts
 function createLynxSeoEngine(config) {
   return new LynxSeoEngine(config);
@@ -7021,6 +7289,7 @@ export {
   createLynxSeoEngine,
   cleanSeoSlug,
   YoastParityEngine,
+  VideoYouTubeAnalyzer,
   UrlyticsEngine,
   UI_ICONS,
   TokenQuotaManager,
@@ -7062,6 +7331,7 @@ export {
   IndexNowClient,
   I18nDetector,
   HyperswitchGateway,
+  GoogleBusinessProfileEngine,
   GeoMeshLinkingEngine,
   FreePublicToolsEngine,
   ExtendedSchemaGraphBuilder,

package/dist/video-youtube-analyzer.d.ts

@@ -0,0 +1,28 @@
+export interface YouTubeVideoMetadata {
+    videoId: string;
+    title: string;
+    description: string;
+    uploadDate?: string;
+    duration?: string;
+    thumbnailUrl?: string;
+    embedUrl?: string;
+    hasChapters?: boolean;
+    chapters?: Array<{
+        time: number;
+        title: string;
+    }>;
+}
+export declare class VideoYouTubeAnalyzer {
+    /**
+     * Extracts YouTube Video ID from any standard URL or iframe string
+     */
+    static extractVideoId(urlOrIframe: string): string | null;
+    /**
+     * Generates Schema.org VideoObject JSON-LD for rich snippets on Google Video Carousel
+     */
+    static generateVideoObjectSchema(meta: YouTubeVideoMetadata): Record<string, any>;
+    /**
+     * Generates responsive, lazy-loaded, SEO-optimized HTML embed with Schema markup
+     */
+    static generateSeoVideoEmbedHtml(meta: YouTubeVideoMetadata): string;
+}

package/package.json

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