@lynxflow/seo-engine 1.7.6 → 1.7.7

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

@@ -15,6 +15,21 @@ export interface GoogleBusinessProfileConfig {
     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
@@ -24,4 +39,8 @@ export declare class GoogleBusinessProfileEngine {
      * 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.js

@@ -7145,6 +7145,152 @@ class GoogleBusinessProfileEngine {
       </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 {

package/dist/index.mjs

@@ -7031,6 +7031,152 @@ class GoogleBusinessProfileEngine {
       </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 {

package/package.json

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

package/src/google-business-profile.ts

@@ -16,6 +16,22 @@ export interface GoogleBusinessProfileConfig {
   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
@@ -95,4 +111,170 @@ export class GoogleBusinessProfileEngine {
       </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
+    };
+  }
 }