@consilioweb/payload-seo-analyzer 1.8.0 → 1.9.0

package/dist/index.js

@@ -1630,7 +1630,10 @@ function analyzeDoc(doc, collection, seoConfig) {
   if (seoInput.isGlobal) {
     seoInput.slug = "";
   }
-  const analysis = analyzeSeo(seoInput, seoConfig);
+  const analysis = analyzeSeo(seoInput, {
+    ...seoConfig,
+    disabledRules: [...seoConfig?.disabledRules ?? [], "geo", "eeat", "hreflang"]
+  });
   const extracted = extractDocContent(doc);
   const fullText = extracted.text;
   const allLinks = extracted.links;
@@ -1677,6 +1680,127 @@ function analyzeDoc(doc, collection, seoConfig) {
     daysSinceUpdate: doc.updatedAt ? Math.floor((Date.now() - new Date(doc.updatedAt).getTime()) / (1e3 * 60 * 60 * 24)) : null
   };
 }
+var CACHE_KEY = "audit";
+var auditBuildInFlight = false;
+async function buildAuditCache(payload, collections, globals, seoConfig) {
+  const { config: mergedConfig, ignoredSlugs } = await loadMergedConfig(payload, seoConfig);
+  const BATCH_SIZE = Math.min(100, Math.max(1, parseInt(process.env.SEO_AUDIT_BATCH_SIZE || "15", 10) || 15));
+  const MAX_DOCS2 = Math.max(1, parseInt(process.env.SEO_AUDIT_MAX_DOCS || "1500", 10) || 1500);
+  const allResults = [];
+  let capped = false;
+  collectionsLoop:
+    for (const collectionSlug of collections) {
+      try {
+        let page = 1;
+        let hasMore = true;
+        while (hasMore) {
+          const result = await payload.find({
+            collection: collectionSlug,
+            limit: BATCH_SIZE,
+            page,
+            depth: 1,
+            overrideAccess: true
+          });
+          for (const doc of result.docs) {
+            if (ignoredSlugs.includes(doc.slug)) continue;
+            if (allResults.length >= MAX_DOCS2) {
+              capped = true;
+              break collectionsLoop;
+            }
+            try {
+              allResults.push(analyzeDoc(doc, collectionSlug, mergedConfig));
+            } catch (e) {
+              payload.logger.warn(
+                `[seo] audit: skipped ${collectionSlug}/${doc.id}: ${e instanceof Error ? e.message : "error"}`
+              );
+            }
+          }
+          hasMore = result.hasNextPage;
+          page++;
+          await new Promise((resolve) => setImmediate(resolve));
+        }
+      } catch {
+      }
+    }
+  if (capped) {
+    payload.logger.warn(
+      `[seo] audit: capped at ${MAX_DOCS2} docs (SEO_AUDIT_MAX_DOCS). Lower SEO_AUDIT_BATCH_SIZE on low-memory hosts, or raise the cap.`
+    );
+  }
+  for (const globalSlug of globals) {
+    try {
+      const doc = await payload.findGlobal({
+        slug: globalSlug,
+        depth: 1,
+        overrideAccess: true
+      });
+      if (doc) {
+        if (ignoredSlugs.includes(globalSlug)) continue;
+        const result = analyzeDoc(doc, `global:${globalSlug}`, mergedConfig);
+        allResults.push({
+          ...result,
+          id: globalSlug,
+          collection: `global:${globalSlug}`,
+          slug: "",
+          title: doc.title || globalSlug
+        });
+      }
+    } catch {
+    }
+  }
+  const previousScoreMap = /* @__PURE__ */ new Map();
+  try {
+    const historyResults = await payload.find({
+      collection: "seo-score-history",
+      limit: Math.min(allResults.length * 2, 3e3),
+      sort: "-snapshotDate",
+      depth: 0,
+      overrideAccess: true
+    });
+    const seen = /* @__PURE__ */ new Set();
+    for (const h of historyResults.docs) {
+      const key = `${h.documentId}::${h.collection}`;
+      if (!seen.has(key)) {
+        seen.add(key);
+        continue;
+      }
+      if (!previousScoreMap.has(key)) {
+        previousScoreMap.set(key, h.score);
+      }
+    }
+  } catch {
+  }
+  const enrichedResults = allResults.map((r) => ({
+    ...r,
+    previousScore: previousScoreMap.get(`${r.id}::${r.collection}`) ?? null
+  }));
+  enrichedResults.sort((a, b) => a.score - b.score);
+  const totalDocs = enrichedResults.length;
+  const stats = {
+    totalPages: totalDocs,
+    avgScore: totalDocs > 0 ? Math.round(enrichedResults.reduce((s, r) => s + r.score, 0) / totalDocs) : 0,
+    good: enrichedResults.filter((r) => r.score >= 80).length,
+    needsWork: enrichedResults.filter((r) => r.score >= 50 && r.score < 80).length,
+    critical: enrichedResults.filter((r) => r.score < 50).length,
+    noKeyword: enrichedResults.filter((r) => !r.focusKeyword).length,
+    noMetaTitle: enrichedResults.filter((r) => !r.metaTitle).length,
+    noMetaDesc: enrichedResults.filter((r) => !r.metaDescription).length,
+    avgWordCount: totalDocs > 0 ? Math.round(enrichedResults.reduce((s, r) => s + r.wordCount, 0) / totalDocs) : 0,
+    avgReadability: totalDocs > 0 ? Math.round(enrichedResults.reduce((s, r) => s + r.readabilityScore, 0) / totalDocs) : 0
+  };
+  return { enrichedResults, stats, capped };
+}
+function ensureAuditBuild(payload, collections, globals, seoConfig) {
+  if (auditBuildInFlight) return;
+  auditBuildInFlight = true;
+  void buildAuditCache(payload, collections, globals, seoConfig).then((result) => {
+    seoCache.set(CACHE_KEY, result);
+  }).catch((e) => {
+    payload.logger.error(`[seo] audit build failed: ${e instanceof Error ? e.message : "unknown"}`);
+  }).finally(() => {
+    auditBuildInFlight = false;
+  });
+}
 function createAuditHandler(collections, seoConfig, globals = []) {
   return async (req) => {
     try {
@@ -1687,98 +1811,18 @@ function createAuditHandler(collections, seoConfig, globals = []) {
       const page = Math.max(1, parseInt(url.searchParams.get("page") || "1", 10));
       const limit = Math.min(500, Math.max(1, parseInt(url.searchParams.get("limit") || "300", 10)));
       const noCache = url.searchParams.get("nocache") === "1";
-      const CACHE_KEY = "audit";
-      let cached = noCache ? null : seoCache.get(CACHE_KEY);
+      if (noCache && !auditBuildInFlight) {
+        seoCache.invalidateKey(CACHE_KEY);
+      }
+      const cached = seoCache.get(CACHE_KEY);
       if (!cached) {
-        const { config: mergedConfig, ignoredSlugs } = await loadMergedConfig(req.payload, seoConfig);
-        const allResults = [];
-        for (const collectionSlug of collections) {
-          try {
-            let page2 = 1;
-            let hasMore = true;
-            while (hasMore) {
-              const result = await req.payload.find({
-                collection: collectionSlug,
-                limit: 100,
-                page: page2,
-                depth: 1,
-                overrideAccess: true
-              });
-              for (const doc of result.docs) {
-                if (ignoredSlugs.includes(doc.slug)) continue;
-                allResults.push(analyzeDoc(doc, collectionSlug, mergedConfig));
-              }
-              hasMore = result.hasNextPage;
-              page2++;
-            }
-          } catch {
-          }
-        }
-        for (const globalSlug of globals) {
-          try {
-            const doc = await req.payload.findGlobal({
-              slug: globalSlug,
-              depth: 1,
-              overrideAccess: true
-            });
-            if (doc) {
-              if (ignoredSlugs.includes(globalSlug)) continue;
-              const result = analyzeDoc(doc, `global:${globalSlug}`, mergedConfig);
-              allResults.push({
-                ...result,
-                id: globalSlug,
-                collection: `global:${globalSlug}`,
-                slug: "",
-                title: doc.title || globalSlug
-              });
-            }
-          } catch {
-          }
-        }
-        const previousScoreMap = /* @__PURE__ */ new Map();
-        try {
-          const historyResults = await req.payload.find({
-            collection: "seo-score-history",
-            limit: allResults.length * 2,
-            sort: "-snapshotDate",
-            depth: 0,
-            overrideAccess: true
-          });
-          const seen = /* @__PURE__ */ new Set();
-          for (const h of historyResults.docs) {
-            const key = `${h.documentId}::${h.collection}`;
-            if (!seen.has(key)) {
-              seen.add(key);
-              continue;
-            }
-            if (!previousScoreMap.has(key)) {
-              previousScoreMap.set(key, h.score);
-            }
-          }
-        } catch {
-        }
-        const enrichedResults2 = allResults.map((r) => ({
-          ...r,
-          previousScore: previousScoreMap.get(`${r.id}::${r.collection}`) ?? null
-        }));
-        enrichedResults2.sort((a, b) => a.score - b.score);
-        const totalDocs2 = enrichedResults2.length;
-        const stats2 = {
-          totalPages: totalDocs2,
-          avgScore: totalDocs2 > 0 ? Math.round(enrichedResults2.reduce((s, r) => s + r.score, 0) / totalDocs2) : 0,
-          good: enrichedResults2.filter((r) => r.score >= 80).length,
-          needsWork: enrichedResults2.filter((r) => r.score >= 50 && r.score < 80).length,
-          critical: enrichedResults2.filter((r) => r.score < 50).length,
-          noKeyword: enrichedResults2.filter((r) => !r.focusKeyword).length,
-          noMetaTitle: enrichedResults2.filter((r) => !r.metaTitle).length,
-          noMetaDesc: enrichedResults2.filter((r) => !r.metaDescription).length,
-          avgWordCount: totalDocs2 > 0 ? Math.round(enrichedResults2.reduce((s, r) => s + r.wordCount, 0) / totalDocs2) : 0,
-          avgReadability: totalDocs2 > 0 ? Math.round(enrichedResults2.reduce((s, r) => s + r.readabilityScore, 0) / totalDocs2) : 0
-        };
-        cached = { enrichedResults: enrichedResults2, stats: stats2 };
-        seoCache.set(CACHE_KEY, cached);
+        ensureAuditBuild(req.payload, collections, globals, seoConfig);
+        return Response.json(
+          { building: true, results: [], stats: null },
+          { status: 202, headers: { "Cache-Control": "no-store" } }
+        );
       }
-      const { enrichedResults, stats } = cached;
+      const { enrichedResults, stats, capped } = cached;
       const totalDocs = enrichedResults.length;
       const totalPages = Math.ceil(totalDocs / limit);
       const startIdx = (page - 1) * limit;
@@ -1794,7 +1838,8 @@ function createAuditHandler(collections, seoConfig, globals = []) {
           hasNextPage: page < totalPages,
           hasPrevPage: page > 1
         },
-        cached: !noCache && seoCache.get(CACHE_KEY) !== null
+        cached: true,
+        capped
       }, { headers: { "Cache-Control": "no-store" } });
     } catch (error) {
       const message = error instanceof Error ? error.message : "Internal server error";
@@ -2150,8 +2195,8 @@ function createSitemapAuditHandler(collections, redirectsCollection = "seo-redir
       }
       const url = new URL(req.url);
       const noCache = url.searchParams.get("nocache") === "1";
-      const CACHE_KEY = "sitemap-audit";
-      const cached = noCache ? null : seoCache.get(CACHE_KEY);
+      const CACHE_KEY2 = "sitemap-audit";
+      const cached = noCache ? null : seoCache.get(CACHE_KEY2);
       if (cached) {
         return Response.json({ ...cached, cached: true }, { headers: { "Cache-Control": "no-store" } });
       }
@@ -2297,7 +2342,7 @@ function createSitemapAuditHandler(collections, redirectsCollection = "seo-redir
           brokenCount: uniqueBrokenLinks.length
         }
       };
-      seoCache.set(CACHE_KEY, responseData);
+      seoCache.set(CACHE_KEY2, responseData);
       return Response.json({ ...responseData, cached: false }, { headers: { "Cache-Control": "no-store" } });
     } catch (error) {
       const message = error instanceof Error ? error.message : "Internal server error";
@@ -2880,6 +2925,201 @@ function createAiGenerateHandler() {
   };
 }
 
+// src/endpoints/aiOptimize.ts
+var DEFAULT_MODEL = "claude-opus-4-8";
+var TITLE_HARD_MAX = 70;
+var DESC_HARD_MAX = 160;
+var KEYWORD_MAX = 60;
+var RATIONALE_MAX_ITEMS = 4;
+var RATIONALE_ITEM_MAX = 200;
+async function callClaudeOptimize(apiKey, model, params) {
+  const systemPrompt = `You are an SEO expert applying June 2026 best practices. You optimize ONLY a page's meta title and meta description (and may suggest a focus keyword). You NEVER rewrite body content.
+Strict rules (these mirror the site's own SEO engine \u2014 follow them exactly):
+- Meta title: natural and compelling, hard limit ${TITLE_HARD_MAX} characters, front-load the important words, do NOT keyword-stuff or repeat the brand/keyword.
+- Meta description: 120-160 characters, one or two sentences, action-oriented, includes the focus keyword ONCE and naturally. No keyword stuffing.
+- Write in the SAME language as the page content.
+- Base everything on the ACTUAL content; never invent facts, prices, numbers, or claims not present in the content.
+- If the focus keyword is missing, you MAY suggest one short keyword (2-4 words) matching the content's main topic; otherwise keep the existing one.
+Return ONLY a JSON object (no markdown, no prose, no code fences) with EXACTLY this shape:
+{"metaTitle": string, "metaDescription": string, "focusKeyword": string, "rationale": string[]}
+"rationale": 2-4 short strings, in the page's language, explaining what you improved and why, referencing the detected issues.`;
+  const issuesText = params.issues.length ? params.issues.map((i) => `- ${i.label}: ${i.message}`).join("\n") : "- (no blocking issues \u2014 focus on making the meta tags more compelling and accurate)";
+  const userPrompt = `Page title: ${params.pageTitle || "(none)"}
+Slug: ${params.slug || "(none)"}
+Current focus keyword: ${params.focusKeyword || "(none)"}
+Current meta title: ${params.currentMetaTitle || "(empty)"}
+Current meta description: ${params.currentMetaDescription || "(empty)"}
+
+SEO issues detected by the engine (fix these):
+${issuesText}
+
+Page content (first 3000 chars):
+${params.content.substring(0, 3e3)}
+
+Return the optimized JSON now:`;
+  const response = await fetch("https://api.anthropic.com/v1/messages", {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      "x-api-key": apiKey,
+      "anthropic-version": "2023-06-01"
+    },
+    body: JSON.stringify({
+      model,
+      max_tokens: 1024,
+      system: systemPrompt,
+      messages: [{ role: "user", content: userPrompt }]
+    })
+  });
+  if (!response.ok) {
+    const errorBody = await response.text();
+    throw new Error(`Claude API error ${response.status}: ${errorBody}`);
+  }
+  const data = await response.json();
+  if (data.stop_reason === "refusal") {
+    return null;
+  }
+  const text = (data.content?.find((b) => b.type === "text")?.text || "").trim();
+  if (!text) return null;
+  return parseSuggestions(text);
+}
+function parseSuggestions(raw) {
+  let s = raw.trim();
+  if (s.startsWith("```")) {
+    s = s.replace(/^```(?:json)?\s*/i, "").replace(/\s*```$/i, "").trim();
+  }
+  if (!s.startsWith("{")) {
+    const start = s.indexOf("{");
+    const end = s.lastIndexOf("}");
+    if (start === -1 || end === -1 || end <= start) return null;
+    s = s.slice(start, end + 1);
+  }
+  try {
+    const parsed = JSON.parse(s);
+    return {
+      metaTitle: typeof parsed.metaTitle === "string" ? parsed.metaTitle : "",
+      metaDescription: typeof parsed.metaDescription === "string" ? parsed.metaDescription : "",
+      focusKeyword: typeof parsed.focusKeyword === "string" ? parsed.focusKeyword : "",
+      rationale: Array.isArray(parsed.rationale) ? parsed.rationale.filter((r) => typeof r === "string") : []
+    };
+  } catch {
+    return null;
+  }
+}
+function sanitizeSuggestions(s, currentFocusKeyword) {
+  const metaTitle = truncateWords(s.metaTitle.trim(), TITLE_HARD_MAX);
+  const metaDescription = truncateWords(s.metaDescription.trim(), DESC_HARD_MAX);
+  let focusKeyword = currentFocusKeyword;
+  if (!currentFocusKeyword.trim()) {
+    const suggested = s.focusKeyword.trim();
+    if (suggested && suggested.length <= KEYWORD_MAX) {
+      focusKeyword = suggested;
+    }
+  }
+  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 };
+}
+function createAiOptimizeHandler(targetCollections, seoConfig, localeMapping) {
+  return async (req) => {
+    try {
+      if (!req.user) {
+        return Response.json({ error: "Unauthorized" }, { status: 401 });
+      }
+      const body = await parseJsonBody(req);
+      const collection = typeof body.collection === "string" ? body.collection.trim() : void 0;
+      const id = typeof body.id === "string" || typeof body.id === "number" ? String(body.id).trim() : void 0;
+      if (!collection || !id) {
+        return Response.json({ error: "Missing required fields: collection, id" }, { status: 400 });
+      }
+      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: []
+      });
+      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";
+      }
+      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
+      });
+    } catch (error) {
+      const message = error instanceof Error ? error.message : "Internal server error";
+      req.payload.logger.error(`[seo] ai-optimize 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(" ");
@@ -2892,8 +3132,8 @@ function createCannibalizationHandler(collections, globals = []) {
       }
       const url = new URL(req.url);
       const noCache = url.searchParams.get("nocache") === "1";
-      const CACHE_KEY = "cannibalization";
-      const cached = noCache ? null : seoCache.get(CACHE_KEY);
+      const CACHE_KEY2 = "cannibalization";
+      const cached = noCache ? null : seoCache.get(CACHE_KEY2);
       if (cached) {
         return Response.json({ ...cached, cached: true });
       }
@@ -2987,7 +3227,7 @@ function createCannibalizationHandler(collections, globals = []) {
           totalAffectedPages
         }
       };
-      seoCache.set(CACHE_KEY, responseData);
+      seoCache.set(CACHE_KEY2, responseData);
       return Response.json({ ...responseData, cached: false });
     } catch (error) {
       const message = error instanceof Error ? error.message : "Internal server error";
@@ -3198,8 +3438,8 @@ function createExternalLinksHandler(collections, globals = []) {
       }
       const url = new URL(req.url);
       const noCache = url.searchParams.get("nocache") === "1";
-      const CACHE_KEY = "external-links";
-      const cached = noCache ? null : seoCache.get(CACHE_KEY);
+      const CACHE_KEY2 = "external-links";
+      const cached = noCache ? null : seoCache.get(CACHE_KEY2);
       if (cached) {
         return Response.json({ ...cached, cached: true });
       }
@@ -3279,7 +3519,7 @@ function createExternalLinksHandler(collections, globals = []) {
         return a.ok ? 1 : -1;
       });
       const responseData = { results, stats };
-      seoCache.set(CACHE_KEY, responseData);
+      seoCache.set(CACHE_KEY2, responseData);
       return Response.json({ ...responseData, cached: false });
     } catch (error) {
       const message = error instanceof Error ? error.message : "Internal server error";
@@ -4273,8 +4513,8 @@ function createKeywordResearchHandler(targetCollections, globals = []) {
       }
       const url = new URL(req.url);
       const noCache = url.searchParams.get("nocache") === "1";
-      const CACHE_KEY = "keyword-research";
-      const cached = noCache ? null : seoCache.get(CACHE_KEY);
+      const CACHE_KEY2 = "keyword-research";
+      const cached = noCache ? null : seoCache.get(CACHE_KEY2);
       if (cached) {
         return Response.json({ ...cached, cached: true });
       }
@@ -4450,7 +4690,7 @@ function createKeywordResearchHandler(targetCollections, globals = []) {
           suggestionsCount: suggestions.length
         }
       };
-      seoCache.set(CACHE_KEY, responseData);
+      seoCache.set(CACHE_KEY2, responseData);
       return Response.json({ ...responseData, cached: false });
     } catch (error) {
       const message = error instanceof Error ? error.message : "Internal server error";
@@ -4587,8 +4827,8 @@ function createLinkGraphHandler(targetCollections, globals = []) {
       }
       const url = new URL(req.url);
       const noCache = url.searchParams.get("nocache") === "1";
-      const CACHE_KEY = "link-graph";
-      const cached = noCache ? null : seoCache.get(CACHE_KEY);
+      const CACHE_KEY2 = "link-graph";
+      const cached = noCache ? null : seoCache.get(CACHE_KEY2);
       if (cached) {
         return Response.json({ ...cached, cached: true }, { headers: { "Cache-Control": "no-store" } });
       }
@@ -4675,7 +4915,7 @@ function createLinkGraphHandler(targetCollections, globals = []) {
         avgDegree
       };
       const responseData = { nodes, edges, stats };
-      seoCache.set(CACHE_KEY, responseData);
+      seoCache.set(CACHE_KEY2, responseData);
       return Response.json({ ...responseData, cached: false }, { headers: { "Cache-Control": "no-store" } });
     } catch (error) {
       const message = error instanceof Error ? error.message : "Internal server error";
@@ -5034,8 +5274,8 @@ function createRedirectChainsHandler(redirectsCollection) {
       }
       const url = new URL(req.url || "", "http://localhost");
       const noCache = url.searchParams.get("nocache") === "1";
-      const CACHE_KEY = "redirect-chains";
-      const cached = noCache ? null : seoCache.get(CACHE_KEY);
+      const CACHE_KEY2 = "redirect-chains";
+      const cached = noCache ? null : seoCache.get(CACHE_KEY2);
       if (cached) {
         return Response.json({ ...cached, cached: true });
       }
@@ -5104,7 +5344,7 @@ function createRedirectChainsHandler(redirectsCollection) {
           totalRedirects: allRedirects.length
         }
       };
-      seoCache.set(CACHE_KEY, responseData);
+      seoCache.set(CACHE_KEY2, responseData);
       return Response.json({ ...responseData, cached: false });
     } catch (error) {
       const message = error instanceof Error ? error.message : "Internal server error";
@@ -5147,8 +5387,8 @@ function createDuplicateContentHandler(collections) {
       const url = new URL(req.url || "", "http://localhost");
       const noCache = url.searchParams.get("nocache") === "1";
       const threshold = parseFloat(url.searchParams.get("threshold") || "") || SIMILARITY_THRESHOLD;
-      const CACHE_KEY = `duplicate-content-${threshold}`;
-      const cached = noCache ? null : seoCache.get(CACHE_KEY);
+      const CACHE_KEY2 = `duplicate-content-${threshold}`;
+      const cached = noCache ? null : seoCache.get(CACHE_KEY2);
       if (cached) {
         return Response.json({ ...cached, cached: true });
       }
@@ -5205,7 +5445,7 @@ function createDuplicateContentHandler(collections) {
           threshold
         }
       };
-      seoCache.set(CACHE_KEY, responseData);
+      seoCache.set(CACHE_KEY2, responseData);
       return Response.json({ ...responseData, cached: false });
     } catch (error) {
       const message = error instanceof Error ? error.message : "Internal server error";
@@ -6461,8 +6701,8 @@ async function doWarmUp(payload, collections = ["pages", "posts"], globals = [])
       try {
         await payload.find({
           collection: collectionSlug,
-          limit: 500,
-          depth: 1,
+          limit: 100,
+          depth: 0,
           overrideAccess: true
         });
         payload.logger.info(`[seo] warm-cache: pre-loaded ${collectionSlug}`);
@@ -6473,7 +6713,7 @@ async function doWarmUp(payload, collections = ["pages", "posts"], globals = [])
       try {
         await payload.findGlobal({
           slug: globalSlug,
-          depth: 1,
+          depth: 0,
           overrideAccess: true
         });
         payload.logger.info(`[seo] warm-cache: pre-loaded global ${globalSlug}`);
@@ -7493,6 +7733,8 @@ var fr = {
   },
   seoView: {
     loadingAudit: "Chargement de l'audit SEO...",
+    buildingAudit: "G\xE9n\xE9ration de l'audit SEO en cours\u2026 (calcul\xE9 en arri\xE8re-plan pour ne pas surcharger le serveur, cela peut prendre un moment sur un gros site)",
+    buildTimeout: "La g\xE9n\xE9ration de l'audit prend plus de temps que pr\xE9vu. R\xE9essayez dans quelques instants.",
     errorSaving: "Erreur lors de la sauvegarde",
     auditTitle: "Audit SEO",
     pagesAnalyzed: "pages analys\xE9es",
@@ -7935,7 +8177,19 @@ var fr = {
     generateMeta: "G\xE9n\xE9rer les meta",
     metaTitle: "Meta Title",
     metaDescription: "Meta Description",
-    emptyValue: "(vide)"
+    emptyValue: "(vide)",
+    optimizeWithAi: "Optimiser avec l'IA",
+    optimizeIntro: "L'IA analyse la page et propose des meta optimis\xE9es (titre, description, mot-cl\xE9). V\xE9rifiez puis appliquez.",
+    optimizeRunning: "Analyse en cours\u2026",
+    applyAll: "Appliquer",
+    applied: "Appliqu\xE9",
+    whyChanges: "Pourquoi ces changements",
+    labelCurrent: "Actuel",
+    labelSuggested: "Sugg\xE9r\xE9",
+    labelFocusKeyword: "Mot-cl\xE9 cible",
+    heuristicNote: "Suggestions heuristiques (cl\xE9 API Claude non configur\xE9e).",
+    applySaveHint: "Champs remplis \u2014 pensez \xE0 enregistrer le document.",
+    noMetaChange: "Aucun changement propos\xE9."
   },
   scoreHistory: {
     loading: "Chargement de l'historique...",
@@ -8071,6 +8325,8 @@ var en = {
   },
   seoView: {
     loadingAudit: "Loading SEO audit...",
+    buildingAudit: "Building the SEO audit\u2026 (computed in the background to avoid overloading the server \u2014 this can take a moment on a large site)",
+    buildTimeout: "The audit is taking longer than expected. Please try again in a moment.",
     errorSaving: "Error during save",
     auditTitle: "SEO Audit",
     pagesAnalyzed: "pages analyzed",
@@ -8513,7 +8769,19 @@ var en = {
     generateMeta: "Generate meta",
     metaTitle: "Meta Title",
     metaDescription: "Meta Description",
-    emptyValue: "(empty)"
+    emptyValue: "(empty)",
+    optimizeWithAi: "Optimize with AI",
+    optimizeIntro: "AI analyzes the page and proposes optimized meta tags (title, description, keyword). Review, then apply.",
+    optimizeRunning: "Analyzing\u2026",
+    applyAll: "Apply",
+    applied: "Applied",
+    whyChanges: "Why these changes",
+    labelCurrent: "Current",
+    labelSuggested: "Suggested",
+    labelFocusKeyword: "Focus keyword",
+    heuristicNote: "Heuristic suggestions (Claude API key not configured).",
+    applySaveHint: "Fields filled \u2014 remember to save the document.",
+    noMetaChange: "No changes proposed."
   },
   scoreHistory: {
     loading: "Loading history...",
@@ -8655,6 +8923,8 @@ var seoAnalyzerPlugin = (pluginConfig = {}) => (incomingConfig) => {
     settings: true,
     gscApi: false,
     // opt-in — requires Google Cloud OAuth setup + secrets
+    warmCache: true,
+    // disable on low-memory hosts to skip startup pre-loading
     ...pluginConfig.features
   };
   function hasExistingSeoMeta(fields) {
@@ -8907,7 +9177,8 @@ var seoAnalyzerPlugin = (pluginConfig = {}) => (incomingConfig) => {
   if (features.aiFeatures) {
     pluginEndpoints.push(
       { path: `${basePath}/ai-generate`, method: "post", handler: createAiGenerateHandler() },
-      { path: `${basePath}/ai-rewrite`, method: "post", handler: createAiRewriteHandler(targetCollections) }
+      { path: `${basePath}/ai-rewrite`, method: "post", handler: createAiRewriteHandler(targetCollections) },
+      { path: `${basePath}/ai-optimize`, method: "post", handler: createAiOptimizeHandler(targetCollections, seoConfig) }
     );
   }
   if (features.cannibalization) {
@@ -9081,7 +9352,9 @@ var seoAnalyzerPlugin = (pluginConfig = {}) => (incomingConfig) => {
   const existingOnInit = config.onInit;
   config.onInit = async (payload) => {
     if (existingOnInit) await existingOnInit(payload);
-    startCacheWarmUp(payload, basePath, targetGlobals, targetCollections);
+    if (features.warmCache) {
+      startCacheWarmUp(payload, basePath, targetGlobals, targetCollections);
+    }
   };
   return config;
 };