@lynxflow/seo-engine 1.7.4 → 1.7.6

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

@@ -0,0 +1,27 @@
+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 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;
+}

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,128 @@ 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();
+  }
+}
+// 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,128 @@ 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();
+  }
+}
+// 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 +7143,7 @@ export {
   createLynxSeoEngine,
   cleanSeoSlug,
   YoastParityEngine,
+  VideoYouTubeAnalyzer,
   UrlyticsEngine,
   UI_ICONS,
   TokenQuotaManager,
@@ -7062,6 +7185,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.4",
+  "version": "1.7.6",
   "description": "High-Performance Multilingual Programmatic SEO & AI Search Engine SDK",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/google-business-profile.ts

@@ -0,0 +1,98 @@
+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[]; // e.g. ["Mo-Fr 09:00-18:00", "Sa 10:00-16:00"]
+  ratingValue?: number;
+  reviewCount?: number;
+  googleMapsUrl?: string;
+}
+
+export class GoogleBusinessProfileEngine {
+  /**
+   * Generates Schema.org LocalBusiness JSON-LD structure matching Google specifications
+   */
+  static generateLocalBusinessSchema(config: GoogleBusinessProfileConfig) {
+    const schema: Record<string, any> = {
+      "@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;
+  }
+
+  /**
+   * Generates interactive HTML Badge with Google Review stars and direct Maps link
+   */
+  static generateGbpBadgeHtml(config: GoogleBusinessProfileConfig): string {
+    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();
+  }
+}

package/src/index.ts

@@ -63,6 +63,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";

package/src/video-youtube-analyzer.ts

@@ -0,0 +1,81 @@
+export interface YouTubeVideoMetadata {
+  videoId: string;
+  title: string;
+  description: string;
+  uploadDate?: string;
+  duration?: string; // ISO 8601 e.g. "PT5M30S"
+  thumbnailUrl?: string;
+  embedUrl?: string;
+  hasChapters?: boolean;
+  chapters?: Array<{ time: number; title: string }>;
+}
+
+export class VideoYouTubeAnalyzer {
+  /**
+   * Extracts YouTube Video ID from any standard URL or iframe string
+   */
+  static extractVideoId(urlOrIframe: string): string | null {
+    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;
+  }
+
+  /**
+   * Generates Schema.org VideoObject JSON-LD for rich snippets on Google Video Carousel
+   */
+  static generateVideoObjectSchema(meta: YouTubeVideoMetadata) {
+    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: Record<string, any> = {
+      "@context": "https://schema.org",
+      "@type": "VideoObject",
+      "name": meta.title,
+      "description": meta.description,
+      "thumbnailUrl": [thumbnail],
+      "uploadDate": meta.uploadDate || new Date().toISOString().split("T")[0],
+      "embedUrl": 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;
+  }
+
+  /**
+   * Generates responsive, lazy-loaded, SEO-optimized HTML embed with Schema markup
+   */
+  static generateSeoVideoEmbedHtml(meta: YouTubeVideoMetadata): string {
+    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();
+  }
+}