@consilioweb/payload-seo-analyzer 1.11.0 → 1.13.0

package/dist/index.js

@@ -1703,6 +1703,7 @@ async function buildAuditCache(payload, collections, globals, seoConfig) {
           });
           for (const doc of result.docs) {
             if (ignoredSlugs.includes(doc.slug)) continue;
+            if (doc._status === "draft") continue;
             if (allResults.length >= MAX_DOCS2) {
               capped = true;
               break collectionsLoop;
@@ -2678,6 +2679,9 @@ function createRedirectsHandler(redirectsCollection) {
         return Response.json({ error: "Missing id or ids" }, { status: 400 });
       }
       if (method === "PATCH") {
+        if (!isAdmin3(req.user)) {
+          return Response.json({ error: "Admin access required" }, { status: 403 });
+        }
         const patchBody = await parseJsonBody(req);
         const id = typeof patchBody.id === "string" ? patchBody.id.trim() : void 0;
         const from = typeof patchBody.from === "string" ? patchBody.from.trim() : void 0;
@@ -3019,6 +3023,77 @@ function sanitizeSuggestions(s, currentFocusKeyword) {
   const rationale = s.rationale.map((r) => r.trim()).filter(Boolean).slice(0, RATIONALE_MAX_ITEMS).map((r) => r.length > RATIONALE_ITEM_MAX ? `${r.slice(0, RATIONALE_ITEM_MAX - 1)}\u2026` : r);
   return { metaTitle, metaDescription, focusKeyword, rationale };
 }
+async function optimizeDocMeta(payload, opts) {
+  const { collection, id, mergedConfig } = opts;
+  let doc;
+  try {
+    doc = await payload.findByID({ collection, id, depth: 1, overrideAccess: true });
+  } catch {
+    return { ok: false, error: `Document not found: ${collection}/${id}`, status: 404 };
+  }
+  const seoInput = buildSeoInputFromDoc(doc, collection);
+  const analysis = analyzeSeo(seoInput, mergedConfig);
+  const metaGroups = /* @__PURE__ */ new Set(["title", "meta-description", "content", "url", "headings"]);
+  const issues = analysis.checks.filter((c) => (c.status === "fail" || c.status === "warning") && metaGroups.has(c.group)).map((c) => ({ label: c.label, message: c.message })).slice(0, 12);
+  const pageTitle = doc.title || "";
+  const slug = doc.slug || "";
+  const currentFocusKeyword = doc.focusKeyword || "";
+  const currentMetaTitle = seoInput.metaTitle || "";
+  const currentMetaDescription = seoInput.metaDescription || "";
+  const content = extractDocContent(doc).text;
+  const apiKey = opts.apiKey;
+  const model = opts.model || DEFAULT_MODEL;
+  let suggestions;
+  let method;
+  const heuristicFallback = () => ({
+    metaTitle: generateMetaTitle(pageTitle, currentFocusKeyword, slug),
+    metaDescription: generateMetaDescription(content, currentFocusKeyword, slug),
+    focusKeyword: currentFocusKeyword,
+    rationale: []
+  });
+  if (apiKey) {
+    try {
+      const aiResult = await callClaudeOptimize(apiKey, model, {
+        pageTitle,
+        slug,
+        focusKeyword: currentFocusKeyword,
+        currentMetaTitle,
+        currentMetaDescription,
+        issues,
+        content
+      });
+      if (aiResult) {
+        suggestions = aiResult;
+        method = "ai";
+      } else {
+        suggestions = heuristicFallback();
+        method = "heuristic";
+      }
+    } catch (error) {
+      payload.logger.error(`[seo] ai-optimize Claude API error: ${error instanceof Error ? error.message : "unknown"}`);
+      suggestions = heuristicFallback();
+      method = "heuristic";
+    }
+  } else {
+    suggestions = heuristicFallback();
+    method = "heuristic";
+  }
+  const sanitized = sanitizeSuggestions(suggestions, currentFocusKeyword);
+  return {
+    ok: true,
+    title: pageTitle,
+    method,
+    ...method === "ai" ? { model } : {},
+    score: analysis.score,
+    current: {
+      metaTitle: currentMetaTitle,
+      metaDescription: currentMetaDescription,
+      focusKeyword: currentFocusKeyword
+    },
+    suggestions: sanitized,
+    issues
+  };
+}
 function createAiOptimizeHandler(targetCollections, seoConfig, localeMapping) {
   return async (req) => {
     try {
@@ -3034,83 +3109,27 @@ function createAiOptimizeHandler(targetCollections, seoConfig, localeMapping) {
       if (targetCollections && !targetCollections.includes(collection)) {
         return Response.json({ error: "Collection not allowed" }, { status: 403 });
       }
-      let doc;
-      try {
-        const result = await req.payload.findByID({
-          collection,
-          id,
-          depth: 1,
-          overrideAccess: true
-        });
-        doc = result;
-      } catch {
-        return Response.json({ error: `Document not found: ${collection}/${id}` }, { status: 404 });
-      }
       const { config: mergedConfig } = await loadMergedConfig(req.payload, seoConfig, {
         reqLocale: req.locale,
         localeMapping
       });
-      const seoInput = buildSeoInputFromDoc(doc, collection);
-      const analysis = analyzeSeo(seoInput, mergedConfig);
-      const metaGroups = /* @__PURE__ */ new Set(["title", "meta-description", "content", "url", "headings"]);
-      const issues = analysis.checks.filter((c) => (c.status === "fail" || c.status === "warning") && metaGroups.has(c.group)).map((c) => ({ label: c.label, message: c.message })).slice(0, 12);
-      const pageTitle = doc.title || "";
-      const slug = doc.slug || "";
-      const currentFocusKeyword = doc.focusKeyword || "";
-      const currentMetaTitle = seoInput.metaTitle || "";
-      const currentMetaDescription = seoInput.metaDescription || "";
-      const content = extractDocContent(doc).text;
-      const apiKey = process.env.ANTHROPIC_API_KEY;
-      const model = process.env.SEO_AI_MODEL || DEFAULT_MODEL;
-      let suggestions;
-      let method;
-      const heuristicFallback = () => ({
-        metaTitle: generateMetaTitle(pageTitle, currentFocusKeyword, slug),
-        metaDescription: generateMetaDescription(content, currentFocusKeyword, slug),
-        focusKeyword: currentFocusKeyword,
-        rationale: []
+      const r = await optimizeDocMeta(req.payload, {
+        collection,
+        id,
+        mergedConfig,
+        apiKey: process.env.ANTHROPIC_API_KEY,
+        model: process.env.SEO_AI_MODEL
       });
-      if (apiKey) {
-        try {
-          const aiResult = await callClaudeOptimize(apiKey, model, {
-            pageTitle,
-            slug,
-            focusKeyword: currentFocusKeyword,
-            currentMetaTitle,
-            currentMetaDescription,
-            issues,
-            content
-          });
-          if (aiResult) {
-            suggestions = aiResult;
-            method = "ai";
-          } else {
-            suggestions = heuristicFallback();
-            method = "heuristic";
-          }
-        } catch (error) {
-          req.payload.logger.error(
-            `[seo] ai-optimize Claude API error: ${error instanceof Error ? error.message : "unknown"}`
-          );
-          suggestions = heuristicFallback();
-          method = "heuristic";
-        }
-      } else {
-        suggestions = heuristicFallback();
-        method = "heuristic";
+      if (!r.ok) {
+        return Response.json({ error: r.error }, { status: r.status || 500 });
       }
-      const sanitized = sanitizeSuggestions(suggestions, currentFocusKeyword);
       return Response.json({
-        method,
-        ...method === "ai" ? { model } : {},
-        score: analysis.score,
-        current: {
-          metaTitle: currentMetaTitle,
-          metaDescription: currentMetaDescription,
-          focusKeyword: currentFocusKeyword
-        },
-        suggestions: sanitized,
-        issues
+        method: r.method,
+        ...r.method === "ai" ? { model: r.model } : {},
+        score: r.score,
+        current: r.current,
+        suggestions: r.suggestions,
+        issues: r.issues
       });
     } catch (error) {
       const message = error instanceof Error ? error.message : "Internal server error";
@@ -3565,6 +3584,177 @@ function createAiContentBriefHandler(targetCollections, seoConfig) {
   };
 }
 
+// src/endpoints/aiOptimizeBulk.ts
+var TITLE_MAX = 70;
+var DESC_MAX = 160;
+var KEYWORD_MAX2 = 60;
+function isAdmin5(user) {
+  if (!user) return false;
+  if (user.role === "admin") return true;
+  if (Array.isArray(user.roles) && user.roles.includes("admin")) return true;
+  return false;
+}
+function createAiOptimizeBulkHandler(targetCollections, seoConfig, localeMapping) {
+  return async (req) => {
+    try {
+      if (!isAdmin5(req.user)) return Response.json({ error: "Forbidden" }, { status: 403 });
+      const body = await parseJsonBody(req);
+      const rawIds = Array.isArray(body.ids) ? body.ids.map(String) : [];
+      const defaultCollection = typeof body.collection === "string" ? body.collection : void 0;
+      const apply = body.apply === true;
+      const MAX = 100;
+      const limit = Math.min(MAX, Math.max(1, parseInt(String(body.limit ?? 50), 10) || 50));
+      const corrections = Array.isArray(body.corrections) ? body.corrections : null;
+      if (apply && corrections && corrections.length > 0) {
+        let applied2 = 0;
+        let i2 = 0;
+        const rows = [];
+        for (const c of corrections.slice(0, MAX)) {
+          i2++;
+          const collection = typeof c.collection === "string" ? c.collection : defaultCollection;
+          const id = c.id != null ? String(c.id) : void 0;
+          if (!collection || !id || collection.startsWith("global:")) continue;
+          if (targetCollections && !targetCollections.includes(collection)) continue;
+          const metaTitle = typeof c.metaTitle === "string" ? truncateWords(c.metaTitle.trim(), TITLE_MAX) : "";
+          const metaDescription = typeof c.metaDescription === "string" ? truncateWords(c.metaDescription.trim(), DESC_MAX) : "";
+          const focusKeyword = typeof c.focusKeyword === "string" ? c.focusKeyword.trim().slice(0, KEYWORD_MAX2) : "";
+          const patch = {};
+          if (metaTitle || metaDescription) patch.meta = { title: metaTitle, description: metaDescription };
+          if (focusKeyword) patch.focusKeyword = focusKeyword;
+          try {
+            if (Object.keys(patch).length > 0) {
+              await req.payload.update({ collection, id, data: patch, overrideAccess: true });
+              applied2++;
+              rows.push({ collection, id, applied: true });
+            }
+          } catch (e) {
+            rows.push({ collection, id, applied: false, error: e instanceof Error ? e.message : "error" });
+          }
+          if (i2 % 5 === 0) await new Promise((resolve) => setImmediate(resolve));
+        }
+        return Response.json(
+          { processed: rows.length, applied: applied2, mode: "corrections", results: rows },
+          { headers: { "Cache-Control": "no-store" } }
+        );
+      }
+      if (rawIds.length === 0) {
+        return Response.json({ error: 'Provide a non-empty "ids" array' }, { status: 400 });
+      }
+      const targets = [];
+      for (const raw of rawIds) {
+        let collection;
+        let id;
+        if (raw.includes("::")) {
+          const [c, i2] = raw.split("::");
+          collection = c;
+          id = i2;
+        } else {
+          collection = defaultCollection;
+          id = raw;
+        }
+        if (!collection || !id) continue;
+        if (collection.startsWith("global:")) continue;
+        if (targetCollections && !targetCollections.includes(collection)) continue;
+        targets.push({ collection, id });
+      }
+      const capped = targets.length > limit;
+      const slice = targets.slice(0, limit);
+      const { config: mergedConfig } = await loadMergedConfig(req.payload, seoConfig, {
+        reqLocale: req.locale,
+        localeMapping
+      });
+      const apiKey = process.env.ANTHROPIC_API_KEY;
+      const model = process.env.SEO_AI_MODEL;
+      const results = [];
+      let applied = 0;
+      let i = 0;
+      for (const target of slice) {
+        i++;
+        try {
+          const r = await optimizeDocMeta(req.payload, {
+            collection: target.collection,
+            id: target.id,
+            mergedConfig,
+            apiKey,
+            model
+          });
+          if (!r.ok || !r.current || !r.suggestions) {
+            results.push({
+              collection: target.collection,
+              id: target.id,
+              title: "",
+              before: { metaTitle: "", metaDescription: "", focusKeyword: "" },
+              after: { metaTitle: "", metaDescription: "", focusKeyword: "" },
+              changed: false,
+              applied: false,
+              error: r.error || "optimize_failed"
+            });
+            continue;
+          }
+          const before = r.current;
+          const after = {
+            metaTitle: r.suggestions.metaTitle,
+            metaDescription: r.suggestions.metaDescription,
+            focusKeyword: r.suggestions.focusKeyword
+          };
+          const changed = after.metaTitle !== before.metaTitle || after.metaDescription !== before.metaDescription || after.focusKeyword !== before.focusKeyword;
+          let didApply = false;
+          if (apply && changed) {
+            const patch = {};
+            if (after.metaTitle || after.metaDescription) {
+              patch.meta = { title: after.metaTitle, description: after.metaDescription };
+            }
+            if (after.focusKeyword && after.focusKeyword !== before.focusKeyword) {
+              patch.focusKeyword = after.focusKeyword;
+            }
+            if (Object.keys(patch).length > 0) {
+              await req.payload.update({ collection: target.collection, id: target.id, data: patch, overrideAccess: true });
+              didApply = true;
+              applied++;
+            }
+          }
+          results.push({
+            collection: target.collection,
+            id: target.id,
+            title: r.title || "",
+            before,
+            after,
+            changed,
+            applied: didApply,
+            method: r.method
+          });
+        } catch (e) {
+          results.push({
+            collection: target.collection,
+            id: target.id,
+            title: "",
+            before: { metaTitle: "", metaDescription: "", focusKeyword: "" },
+            after: { metaTitle: "", metaDescription: "", focusKeyword: "" },
+            changed: false,
+            applied: false,
+            error: e instanceof Error ? e.message : "error"
+          });
+        }
+        if (i % 3 === 0) await new Promise((resolve) => setImmediate(resolve));
+      }
+      return Response.json(
+        {
+          processed: results.length,
+          changedCount: results.filter((r) => r.changed).length,
+          applied,
+          capped,
+          results
+        },
+        { headers: { "Cache-Control": "no-store" } }
+      );
+    } catch (error) {
+      const message = error instanceof Error ? error.message : "Internal server error";
+      req.payload.logger.error(`[seo] ai-optimize-bulk error: ${message}`);
+      return Response.json({ error: message }, { status: 500 });
+    }
+  };
+}
+
 // src/endpoints/cannibalization.ts
 function canonicalIntent(keyword) {
   return keyword.toLowerCase().normalize("NFD").replace(/\p{Diacritic}/gu, "").replace(/[^\p{L}\p{N}\s]/gu, " ").split(/\s+/).filter(Boolean).sort().join(" ");
@@ -4149,7 +4339,7 @@ function getDateThreshold(period) {
       return new Date(now.getTime() - 30 * 24 * 60 * 60 * 1e3);
   }
 }
-function isAdmin5(user) {
+function isAdmin6(user) {
   if (!user) return false;
   if (user.role === "admin") return true;
   if (Array.isArray(user.roles) && user.roles.includes("admin")) return true;
@@ -4254,7 +4444,7 @@ function createPerformanceHandler() {
         });
       }
       if (method === "POST") {
-        if (!isAdmin5(req.user)) {
+        if (!isAdmin6(req.user)) {
           return Response.json({ error: "Admin access required" }, { status: 403 });
         }
         const body = await parseJsonBody(req);
@@ -5968,7 +6158,7 @@ function createAiRewriteHandler(targetCollections) {
 }
 
 // src/endpoints/robots.ts
-function isAdmin6(user) {
+function isAdmin7(user) {
   if (!user) return false;
   if (user.role === "admin") return true;
   if (Array.isArray(user.roles) && user.roles.includes("admin")) return true;
@@ -6017,7 +6207,7 @@ function createRobotsUpdateHandler() {
       if (!req.user) {
         return Response.json({ error: "Unauthorized" }, { status: 401 });
       }
-      if (!isAdmin6(req.user)) {
+      if (!isAdmin7(req.user)) {
         return Response.json({ error: "Admin access required" }, { status: 403 });
       }
       const body = await parseJsonBody(req);
@@ -7200,6 +7390,137 @@ function createRankHistoryHandler() {
   };
 }
 
+// src/endpoints/ctrOpportunities.ts
+function expectedCtrForPosition(pos) {
+  const table = {
+    1: 0.28,
+    2: 0.15,
+    3: 0.1,
+    4: 0.07,
+    5: 0.055,
+    6: 0.045,
+    7: 0.035,
+    8: 0.03,
+    9: 0.025,
+    10: 0.022
+  };
+  if (pos <= 1) return table[1];
+  if (pos <= 10) {
+    const lo = Math.floor(pos);
+    const hi = Math.ceil(pos);
+    const a = table[lo] ?? 0.02;
+    const b = table[hi] ?? 0.02;
+    return a + (b - a) * (pos - lo);
+  }
+  if (pos <= 20) return 0.012;
+  return 5e-3;
+}
+function rankCtrOpportunities(rows, opts = {}) {
+  const minImpressions = opts.minImpressions ?? 50;
+  const maxPosition = opts.maxPosition ?? 20;
+  const out = [];
+  for (const r of rows) {
+    const url = r.keys?.[0];
+    if (!url) continue;
+    if (r.impressions < minImpressions) continue;
+    if (r.position > maxPosition) continue;
+    const expectedCtr = expectedCtrForPosition(r.position);
+    const gap = expectedCtr - r.ctr;
+    if (gap <= 0) continue;
+    const potentialClicks = Math.round(r.impressions * gap);
+    if (potentialClicks < 1) continue;
+    out.push({
+      url,
+      impressions: r.impressions,
+      clicks: r.clicks,
+      ctr: r.ctr,
+      position: Math.round(r.position * 10) / 10,
+      expectedCtr: Math.round(expectedCtr * 1e3) / 1e3,
+      potentialClicks
+    });
+  }
+  out.sort((a, b) => b.potentialClicks - a.potentialClicks);
+  return out;
+}
+async function resolveDoc(payload, url, targetCollections) {
+  let path;
+  try {
+    path = new URL(url).pathname;
+  } catch {
+    return null;
+  }
+  const segments = path.split("/").filter(Boolean);
+  const slug = segments.length === 0 ? "home" : segments[segments.length - 1];
+  for (const collection of targetCollections) {
+    try {
+      const res = await payload.find({
+        collection,
+        where: { slug: { equals: slug } },
+        limit: 1,
+        depth: 0,
+        overrideAccess: true
+      });
+      if (res.docs.length > 0) {
+        return { collection, id: String(res.docs[0].id) };
+      }
+    } catch {
+    }
+  }
+  return null;
+}
+function createCtrOpportunitiesHandler(basePath, targetCollections, seoConfig) {
+  return async (req) => {
+    try {
+      if (!isGscAdmin(req.user)) return Response.json({ error: "Forbidden" }, { status: 403 });
+      const cfg = getGscOAuthConfig(basePath, seoConfig);
+      if (!cfg) return Response.json({ error: "GSC OAuth not configured." }, { status: 400 });
+      const authDoc = await getOrCreateGscAuthDoc(req.payload);
+      if (!authDoc.refreshTokenEnc) {
+        return Response.json({ error: "Not connected to Google Search Console." }, { status: 409 });
+      }
+      let accessToken;
+      try {
+        accessToken = await getGscAccessToken(req.payload, cfg, authDoc);
+      } catch (e) {
+        const code = e instanceof Error ? e.message : "refresh_failed";
+        const status = code === "decrypt_failed" ? 409 : 502;
+        return Response.json({ error: "Could not refresh GSC access token." }, { status });
+      }
+      const url = new URL(req.url);
+      const minImpressions = Math.max(1, parseInt(url.searchParams.get("minImpressions") || "50", 10) || 50);
+      const property = authDoc.propertyUrl || cfg.siteUrl;
+      const end = new Date(Date.now() - 2 * 864e5);
+      const start = new Date(end.getTime() - 27 * 864e5);
+      const endDate = end.toISOString().slice(0, 10);
+      const startDate = start.toISOString().slice(0, 10);
+      let rows;
+      try {
+        rows = await queryGscSearchAnalytics(accessToken, property, {
+          startDate,
+          endDate,
+          dimensions: ["page"],
+          rowLimit: 250
+        });
+      } catch (e) {
+        return Response.json({ error: e instanceof Error ? e.message : "GSC query failed" }, { status: 502 });
+      }
+      const opportunities = rankCtrOpportunities(rows, { minImpressions });
+      const top = opportunities.slice(0, 50);
+      const resolved = await Promise.all(
+        top.map(async (o) => ({ ...o, doc: await resolveDoc(req.payload, o.url, targetCollections) }))
+      );
+      return Response.json(
+        { property, startDate, endDate, count: opportunities.length, opportunities: resolved },
+        { headers: { "Cache-Control": "no-store" } }
+      );
+    } catch (error) {
+      const message = error instanceof Error ? error.message : "Internal server error";
+      req.payload.logger.error(`[seo] ctr-opportunities error: ${message}`);
+      return Response.json({ error: message }, { status: 500 });
+    }
+  };
+}
+
 // src/rateLimiter.ts
 function createRateLimiter(maxRequests, windowMs) {
   const store = /* @__PURE__ */ new Map();
@@ -7247,7 +7568,7 @@ function getClientIp(req) {
 
 // src/endpoints/seoLogs.ts
 var VALID_LOG_TYPES = ["404", "redirect", "error"];
-function isAdmin7(user) {
+function isAdmin8(user) {
   if (!user) return false;
   if (user.role === "admin") return true;
   if (Array.isArray(user.roles) && user.roles.includes("admin")) return true;
@@ -7344,7 +7665,7 @@ function createSeoLogsHandler(seoLogsSecret) {
       return Response.json({ error: "Unauthorized" }, { status: 401 });
     }
     if (method === "DELETE") {
-      if (!isAdmin7(req.user)) {
+      if (!isAdmin8(req.user)) {
         return Response.json({ error: "Admin access required" }, { status: 403 });
       }
       try {
@@ -7521,6 +7842,7 @@ async function doWarmUp(payload, collections = ["pages", "posts"], globals = [])
   }
 }
 function startCacheWarmUp(payload, _basePath, globals = [], collections = ["pages", "posts"]) {
+  stopCacheWarmUp();
   setTimeout(() => {
     void doWarmUp(payload, collections, globals);
   }, STARTUP_DELAY);
@@ -7562,6 +7884,7 @@ async function doSnapshot(payload, basePath, seoConfig) {
   }
 }
 function startRankTracker(payload, basePath, seoConfig) {
+  stopRankTracker();
   setTimeout(() => {
     void doSnapshot(payload, basePath, seoConfig);
   }, STARTUP_DELAY2);
@@ -7584,7 +7907,7 @@ function stopRankTracker() {
 }
 
 // src/endpoints/alerts.ts
-function isAdmin8(user) {
+function isAdmin9(user) {
   if (!user) return false;
   if (user.role === "admin") return true;
   if (Array.isArray(user.roles) && user.roles.includes("admin")) return true;
@@ -7750,7 +8073,7 @@ async function deliverAlertDigest(payload, digest, cfg, siteUrl) {
 function createAlertsDigestHandler() {
   return async (req) => {
     try {
-      if (!isAdmin8(req.user)) return Response.json({ error: "Forbidden" }, { status: 403 });
+      if (!isAdmin9(req.user)) return Response.json({ error: "Forbidden" }, { status: 403 });
       const cfg = getAlertConfig();
       const digest = await buildAlertDigest(req.payload, cfg);
       return Response.json(
@@ -7776,7 +8099,7 @@ function createAlertsDigestHandler() {
 function createAlertsRunHandler(siteUrl) {
   return async (req) => {
     try {
-      if (!isAdmin8(req.user)) return Response.json({ error: "Forbidden" }, { status: 403 });
+      if (!isAdmin9(req.user)) return Response.json({ error: "Forbidden" }, { status: 403 });
       const cfg = getAlertConfig();
       const digest = await buildAlertDigest(req.payload, cfg);
       const delivery = await deliverAlertDigest(req.payload, digest, cfg, siteUrl);
@@ -7811,6 +8134,7 @@ async function runDigest(payload, siteUrl) {
   }
 }
 function startAlertsScheduler(payload, siteUrl) {
+  stopAlertsScheduler();
   const intervalHours = Math.max(1, parseInt(process.env.SEO_ALERT_INTERVAL_HOURS || "24", 10) || 24);
   const intervalMs = intervalHours * 60 * 60 * 1e3;
   setTimeout(() => {
@@ -8826,8 +9150,15 @@ var fr = {
     markCornerstone: "Marquer pilier",
     unmarkCornerstone: "D\xE9marquer pilier",
     bulkOptimizeMeta: "Optimiser m\xE9ta (IA)",
-    bulkOptimizing: "Optimisation\u2026",
+    bulkOptimizing: "Analyse\u2026",
     bulkConfirm: "Confirmer ?",
+    bulkPreviewTitle: "Corrections m\xE9ta propos\xE9es",
+    bulkApply: "Appliquer",
+    bulkApplying: "Application\u2026",
+    bulkCancel: "Annuler",
+    bulkExport: "Exporter CSV",
+    bulkNoChanges: "Aucune correction n\xE9cessaire sur la s\xE9lection.",
+    bulkCappedNote: "limite atteinte (affine la s\xE9lection)",
     searchPlaceholder: "Rechercher (titre, slug, keyword)...",
     allCollections: "Toutes les collections",
     allScores: "Tous les scores",
@@ -9421,8 +9752,15 @@ var en = {
     markCornerstone: "Mark as cornerstone",
     unmarkCornerstone: "Unmark cornerstone",
     bulkOptimizeMeta: "Optimize meta (AI)",
-    bulkOptimizing: "Optimizing\u2026",
+    bulkOptimizing: "Analyzing\u2026",
     bulkConfirm: "Confirm?",
+    bulkPreviewTitle: "Proposed meta corrections",
+    bulkApply: "Apply",
+    bulkApplying: "Applying\u2026",
+    bulkCancel: "Cancel",
+    bulkExport: "Export CSV",
+    bulkNoChanges: "No corrections needed on the selection.",
+    bulkCappedNote: "limit reached (narrow the selection)",
     searchPlaceholder: "Search (title, slug, keyword)...",
     allCollections: "All collections",
     allScores: "All scores",
@@ -10275,7 +10613,8 @@ var seoAnalyzerPlugin = (pluginConfig = {}) => (incomingConfig) => {
       { path: `${basePath}/ai-optimize`, method: "post", handler: createAiOptimizeHandler(targetCollections, seoConfig) },
       { path: `${basePath}/alt-text-audit`, method: "get", handler: createAltTextAuditHandler(uploadsCollection) },
       { path: `${basePath}/ai-alt-text`, method: "post", handler: withRateLimit(createAiAltTextHandler(uploadsCollection, seoConfig)) },
-      { path: `${basePath}/ai-content-brief`, method: "post", handler: withRateLimit(createAiContentBriefHandler(targetCollections, seoConfig)) }
+      { path: `${basePath}/ai-content-brief`, method: "post", handler: withRateLimit(createAiContentBriefHandler(targetCollections, seoConfig)) },
+      { path: `${basePath}/ai-optimize-bulk`, method: "post", handler: withRateLimit(createAiOptimizeBulkHandler(targetCollections, seoConfig)) }
     );
   }
   if (features.cannibalization) {
@@ -10308,7 +10647,8 @@ var seoAnalyzerPlugin = (pluginConfig = {}) => (incomingConfig) => {
       { path: `${basePath}/gsc/data`, method: "get", handler: withRateLimit(createGscDataHandler(basePath, seoConfig)) },
       { path: `${basePath}/gsc/disconnect`, method: "post", handler: createGscDisconnectHandler() },
       { path: `${basePath}/rank-snapshot`, method: "post", handler: withRateLimit(createRankSnapshotHandler(basePath, seoConfig)) },
-      { path: `${basePath}/rank-history`, method: "get", handler: createRankHistoryHandler() }
+      { path: `${basePath}/rank-history`, method: "get", handler: createRankHistoryHandler() },
+      { path: `${basePath}/ctr-opportunities`, method: "get", handler: createCtrOpportunitiesHandler(basePath, targetCollections, seoConfig) }
     );
   }
   if (features.alerts) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@consilioweb/payload-seo-analyzer",
-  "version": "1.11.0",
+  "version": "1.13.0",
   "description": "Payload CMS SEO plugin — 50+ checks, dashboard, Lexical JSON support, Flesch FR/EN readability, i18n",
   "type": "module",
   "main": "./dist/index.cjs",