@lynxflow/seo-engine 1.7.5 → 1.7.7

package/src/google-business-profile.ts

@@ -0,0 +1,280 @@
+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 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 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();
+  }
+
+  /**
+   * Complete Diagnostic & Audit of a Google Business Profile / Local SEO setup
+   */
+  static auditProfile(config: GoogleBusinessProfileConfig): GbpAuditResult {
+    const checks: GbpAuditResult["checks"] = [];
+    let score = 0;
+
+    // 1. Nom d'établissement
+    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."
+      });
+    }
+
+    // 2. Adresse & Code Postal
+    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."
+      });
+    }
+
+    // 3. Téléphone
+    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."
+      });
+    }
+
+    // 4. Coordonnées GPS
+    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."
+      });
+    }
+
+    // 5. Horaires d'ouverture
+    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é'."
+      });
+    }
+
+    // 6. Note Google & Volume d'Avis
+    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.0 && 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."
+      });
+    }
+
+    // 7. Lien Google Maps ou Place ID
+    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: GbpAuditResult["grade"] = score >= 90 ? "A+" : score >= 75 ? "A" : score >= 60 ? "B" : score >= 40 ? "C" : "D";
+    const eligibility: GbpAuditResult["localPackEligibility"] = 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
+    };
+  }
+}

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();
+  }
+}