@consilioweb/payload-seo-analyzer 1.8.0 → 1.9.0

package/README.md

@@ -637,7 +637,9 @@ All endpoints are prefixed with the configured `endpointBasePath` (default: `/se
 | `POST` | `/suggest-links` | Internal link suggestions for a page |
 | `POST` | `/create-redirect` | Create a single redirect entry |
 | `GET` `POST` `PATCH` `DELETE` | `/redirects` | Full CRUD for redirect management |
-| `POST` | `/ai-generate` | AI-powered meta title/description generation |
+| `POST` | `/ai-generate` | Heuristic meta title/description generation (no API key needed) |
+| `POST` | `/ai-rewrite` | Rewrite a single meta field (Claude if `ANTHROPIC_API_KEY` set, else heuristic) |
+| `POST` | `/ai-optimize` | **AI SEO Optimize** — scan a page, propose optimized meta (Claude Opus 4.8 by default), server-validated; applied in one click from the sidebar |
 | `GET` | `/cannibalization` | Detect keyword cannibalization |
 | `POST` | `/external-links` | Check external link status (live HTTP checks with SSRF protection) |
 | `GET` | `/sitemap-config` | Sitemap configuration data |
@@ -647,6 +649,36 @@ All endpoints are prefixed with the configured `endpointBasePath` (default: `/se
 | `GET` | `/link-graph` | Internal link graph data |
 | `GET` `POST` `DELETE` | `/seo-logs` | 404 log management (POST supports secret-header auth) |
 
+### AI SEO Optimize (`/ai-optimize`)
+
+One-click **"scan → propose → apply"** assistant in the editor sidebar (button **“Optimiser avec l'IA”**):
+
+1. Runs the real SEO engine on the current page and collects the failing/warning meta checks.
+2. Sends the content + detected issues to Claude, which proposes an optimized **meta title**, **meta description** and (only when missing) a **focus keyword**, applying the same SEO 2026 rules the engine enforces.
+3. The editor reviews the *current → suggested* diff + rationale and **applies in one click** — the fields are filled, then saved as usual.
+
+Scope is **meta only** by design: the SEO 2026 analysis classifies mass AI-generated body content as a spam/penalty risk, so the feature never rewrites page content.
+
+**Setup (opt-in, billed to your own Anthropic key):**
+
+| Env var | Default | Purpose |
+|---|---|---|
+| `ANTHROPIC_API_KEY` | — | Your Anthropic API key, read **only** server-side (never from the client). **Without it, the feature falls back to the built-in heuristic generators.** |
+| `SEO_AI_MODEL` | `claude-opus-4-8` | Override the Claude model (e.g. `claude-haiku-4-5` for a cheaper/faster option). |
+
+The endpoint is gated behind `features.aiFeatures` (default `true`). Suggestions are **validated/clamped server-side** (title ≤ 70, description ≤ 160, focus keyword only filled when empty) so what gets applied is always rule-compliant, regardless of the model's output.
+
+### Low-memory hosting (e.g. Infomaniak)
+
+The site-wide audit (`/admin/seo` dashboard) is the heaviest operation. On constrained shared Node hosting it is built **single-flight, in the background**: the first uncached load returns `202` and the dashboard shows a “generating…” state while it computes, then polls until ready — it never blocks or OOM-kills the process. Tune it via env vars if needed:
+
+| Env var | Default | Purpose |
+|---|---|---|
+| `SEO_AUDIT_BATCH_SIZE` | `15` | Documents processed per batch. Lower it on very small hosts. |
+| `SEO_AUDIT_MAX_DOCS` | `1500` | Hard cap on documents audited. |
+
+For the lowest-memory tiers you can also set `features: { warmCache: false }` to skip the startup/hourly pre-load entirely.
+
 <img src="https://raw.githubusercontent.com/andreasbm/readme/master/assets/lines/rainbow.png" alt="line">
 
 ## SEO Rules Reference

package/dist/client.cjs

@@ -1058,6 +1058,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",
@@ -1500,7 +1502,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...",
@@ -1636,6 +1650,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",
@@ -2078,7 +2094,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...",
@@ -6484,9 +6512,11 @@ var C2 = {
   white: "#fff",
   green: "#22c55e",
   red: "#ef4444",
+  bg: "#fafafa",
   textPrimary: "var(--theme-text, #1a1a1a)",
   textSecondary: "var(--theme-elevation-600, #6b7280)",
   border: "var(--theme-border-color, #000)",
+  inputBg: "var(--theme-input-bg, #fff)",
   surfaceBg: "var(--theme-elevation-0, #fff)",
   surface50: "var(--theme-elevation-50, #f9fafb)"
 };
@@ -6986,10 +7016,48 @@ function useInternalLinkSuggestions(documentId, collection, textContent) {
   }, [textContent, documentId, collection]);
   return { suggestions, loading };
 }
+function AiDiffRow({
+  label,
+  current,
+  suggested,
+  labelCurrent,
+  labelSuggested,
+  emptyValue,
+  C: colors
+}) {
+  return /* @__PURE__ */ jsxRuntime.jsxs("div", { style: { marginBottom: 10 }, children: [
+    /* @__PURE__ */ jsxRuntime.jsx("div", { style: { fontSize: 10, fontWeight: 700, color: colors.textSecondary, textTransform: "uppercase", marginBottom: 4 }, children: label }),
+    /* @__PURE__ */ jsxRuntime.jsxs("div", { style: { fontSize: 11, color: colors.textSecondary, marginBottom: 3 }, children: [
+      /* @__PURE__ */ jsxRuntime.jsxs("span", { style: { fontWeight: 700 }, children: [
+        labelCurrent,
+        ": "
+      ] }),
+      /* @__PURE__ */ jsxRuntime.jsx("span", { style: { textDecoration: current ? "line-through" : "none", opacity: 0.7 }, children: current || emptyValue })
+    ] }),
+    /* @__PURE__ */ jsxRuntime.jsxs(
+      "div",
+      {
+        style: {
+          padding: "6px 10px",
+          borderRadius: 6,
+          border: `1px solid var(--theme-elevation-200, #e5e7eb)`,
+          backgroundColor: colors.surface50,
+          fontSize: 12,
+          color: colors.textPrimary,
+          lineHeight: 1.5
+        },
+        children: [
+          /* @__PURE__ */ jsxRuntime.jsx("span", { style: { fontSize: 10, fontWeight: 700, color: colors.green, textTransform: "uppercase", marginRight: 6 }, children: labelSuggested }),
+          suggested || emptyValue
+        ]
+      }
+    )
+  ] });
+}
 var SeoAnalyzer = () => {
   const locale = useSeoLocale();
   const t = getDashboardT(locale);
-  const [formFields] = ui.useAllFormFields();
+  const [formFields, dispatchFields] = ui.useAllFormFields();
   const initialScoreRef = React4.useRef(null);
   const [suggestionsOpen, setSuggestionsOpen] = React4.useState(true);
   const [cannibalizationExpanded, setCannibalizationExpanded] = React4.useState(false);
@@ -6998,6 +7066,10 @@ var SeoAnalyzer = () => {
   const [aiGenerating, setAiGenerating] = React4.useState(false);
   const [aiResult, setAiResult] = React4.useState(null);
   const [aiCopied, setAiCopied] = React4.useState(null);
+  const [aiOptimizing, setAiOptimizing] = React4.useState(false);
+  const [aiOptimizeResult, setAiOptimizeResult] = React4.useState(null);
+  const [aiOptimizeApplied, setAiOptimizeApplied] = React4.useState(false);
+  const [aiOptimizeError, setAiOptimizeError] = React4.useState(false);
   const getFieldValue = React4.useCallback(
     (path) => {
       if (!formFields) return void 0;
@@ -7725,6 +7797,145 @@ var SeoAnalyzer = () => {
         }
       )
     ] }),
+    /* @__PURE__ */ jsxRuntime.jsxs("div", { style: { marginBottom: 12 }, children: [
+      /* @__PURE__ */ jsxRuntime.jsx(
+        "button",
+        {
+          type: "button",
+          disabled: aiOptimizing || !documentId,
+          title: !documentId ? t.seoAnalyzer.applySaveHint : void 0,
+          onClick: async () => {
+            setAiOptimizing(true);
+            setAiOptimizeResult(null);
+            setAiOptimizeApplied(false);
+            setAiOptimizeError(false);
+            try {
+              const res = await fetch("/api/seo-plugin/ai-optimize", {
+                method: "POST",
+                credentials: "include",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify({ collection: currentCollection, id: documentId })
+              });
+              if (res.ok) {
+                setAiOptimizeResult(await res.json());
+              } else {
+                setAiOptimizeError(true);
+              }
+            } catch {
+              setAiOptimizeError(true);
+            }
+            setAiOptimizing(false);
+          },
+          style: {
+            display: "flex",
+            alignItems: "center",
+            gap: 6,
+            width: "100%",
+            padding: "10px 14px",
+            borderRadius: 8,
+            border: `2px solid ${C2.border}`,
+            backgroundColor: "#7c3aed",
+            color: "#fff",
+            fontWeight: 800,
+            fontSize: 12,
+            cursor: aiOptimizing || !documentId ? "not-allowed" : "pointer",
+            opacity: aiOptimizing || !documentId ? 0.6 : 1,
+            textTransform: "uppercase",
+            letterSpacing: "0.04em",
+            justifyContent: "center",
+            boxShadow: "2px 2px 0 0 var(--theme-border-color, rgba(0,0,0,1))"
+          },
+          children: aiOptimizing ? t.seoAnalyzer.optimizeRunning : `\u2728 ${t.seoAnalyzer.optimizeWithAi}`
+        }
+      ),
+      aiOptimizeError && /* @__PURE__ */ jsxRuntime.jsx("div", { style: { marginTop: 8, padding: "8px 12px", borderRadius: 6, fontSize: 11, color: C2.white, backgroundColor: C2.red }, children: t.common.loadingError }),
+      aiOptimizeResult && /* @__PURE__ */ jsxRuntime.jsxs(
+        "div",
+        {
+          style: {
+            marginTop: 8,
+            padding: "12px 14px",
+            borderRadius: 8,
+            border: `2px solid ${C2.border}`,
+            backgroundColor: C2.surfaceBg
+          },
+          children: [
+            aiOptimizeResult.method === "heuristic" && /* @__PURE__ */ jsxRuntime.jsx("div", { style: { fontSize: 10, color: C2.textSecondary, marginBottom: 8, fontStyle: "italic" }, children: t.seoAnalyzer.heuristicNote }),
+            /* @__PURE__ */ jsxRuntime.jsx(
+              AiDiffRow,
+              {
+                label: t.seoAnalyzer.metaTitle,
+                current: aiOptimizeResult.current.metaTitle,
+                suggested: aiOptimizeResult.suggestions.metaTitle,
+                labelCurrent: t.seoAnalyzer.labelCurrent,
+                labelSuggested: t.seoAnalyzer.labelSuggested,
+                emptyValue: t.seoAnalyzer.emptyValue,
+                C: C2
+              }
+            ),
+            /* @__PURE__ */ jsxRuntime.jsx(
+              AiDiffRow,
+              {
+                label: t.seoAnalyzer.metaDescription,
+                current: aiOptimizeResult.current.metaDescription,
+                suggested: aiOptimizeResult.suggestions.metaDescription,
+                labelCurrent: t.seoAnalyzer.labelCurrent,
+                labelSuggested: t.seoAnalyzer.labelSuggested,
+                emptyValue: t.seoAnalyzer.emptyValue,
+                C: C2
+              }
+            ),
+            aiOptimizeResult.suggestions.focusKeyword && aiOptimizeResult.suggestions.focusKeyword !== aiOptimizeResult.current.focusKeyword && /* @__PURE__ */ jsxRuntime.jsx(
+              AiDiffRow,
+              {
+                label: t.seoAnalyzer.labelFocusKeyword,
+                current: aiOptimizeResult.current.focusKeyword,
+                suggested: aiOptimizeResult.suggestions.focusKeyword,
+                labelCurrent: t.seoAnalyzer.labelCurrent,
+                labelSuggested: t.seoAnalyzer.labelSuggested,
+                emptyValue: t.seoAnalyzer.emptyValue,
+                C: C2
+              }
+            ),
+            aiOptimizeResult.suggestions.rationale.length > 0 && /* @__PURE__ */ jsxRuntime.jsxs("div", { style: { marginTop: 4, marginBottom: 10 }, children: [
+              /* @__PURE__ */ jsxRuntime.jsx("div", { style: { fontSize: 10, fontWeight: 700, color: C2.textSecondary, textTransform: "uppercase", marginBottom: 4 }, children: t.seoAnalyzer.whyChanges }),
+              /* @__PURE__ */ jsxRuntime.jsx("ul", { style: { margin: 0, paddingLeft: 16, fontSize: 11, color: C2.textPrimary, lineHeight: 1.5 }, children: aiOptimizeResult.suggestions.rationale.map((r, i) => /* @__PURE__ */ jsxRuntime.jsx("li", { children: r }, i)) })
+            ] }),
+            /* @__PURE__ */ jsxRuntime.jsx(
+              "button",
+              {
+                type: "button",
+                disabled: aiOptimizeApplied,
+                onClick: () => {
+                  const sug = aiOptimizeResult.suggestions;
+                  if (sug.metaTitle) dispatchFields({ type: "UPDATE", path: "meta.title", value: sug.metaTitle });
+                  if (sug.metaDescription) dispatchFields({ type: "UPDATE", path: "meta.description", value: sug.metaDescription });
+                  if (sug.focusKeyword && sug.focusKeyword !== aiOptimizeResult.current.focusKeyword) {
+                    dispatchFields({ type: "UPDATE", path: "focusKeyword", value: sug.focusKeyword });
+                  }
+                  setAiOptimizeApplied(true);
+                },
+                style: {
+                  width: "100%",
+                  padding: "9px 14px",
+                  borderRadius: 6,
+                  border: `2px solid ${C2.border}`,
+                  backgroundColor: aiOptimizeApplied ? C2.green : C2.cyan,
+                  color: aiOptimizeApplied ? C2.white : C2.black,
+                  fontWeight: 800,
+                  fontSize: 11,
+                  textTransform: "uppercase",
+                  letterSpacing: "0.04em",
+                  cursor: aiOptimizeApplied ? "default" : "pointer"
+                },
+                children: aiOptimizeApplied ? `\u2713 ${t.seoAnalyzer.applied}` : t.seoAnalyzer.applyAll
+              }
+            ),
+            aiOptimizeApplied && /* @__PURE__ */ jsxRuntime.jsx("div", { style: { marginTop: 6, fontSize: 10, color: C2.textSecondary, textAlign: "center" }, children: t.seoAnalyzer.applySaveHint })
+          ]
+        }
+      )
+    ] }),
     suggestions.length > 0 && /* @__PURE__ */ jsxRuntime.jsxs(
       "div",
       {
@@ -9064,6 +9275,7 @@ function SeoView() {
   const [items, setItems] = React4.useState([]);
   const [stats, setStats] = React4.useState(null);
   const [loading, setLoading] = React4.useState(true);
+  const [building, setBuilding] = React4.useState(false);
   const [error, setError] = React4.useState(null);
   const [filter, setFilter] = React4.useState("all");
   const [scoreFilter, setScoreFilter] = React4.useState("all");
@@ -9080,9 +9292,22 @@ function SeoView() {
   const fetchAudit = React4.useCallback(async (forceRefresh = false) => {
     setLoading(true);
     setError(null);
+    setBuilding(false);
     try {
-      const url = forceRefresh ? "/api/seo-plugin/audit?nocache=1" : "/api/seo-plugin/audit";
-      const res = await fetch(url, { credentials: "include", cache: "no-store" });
+      const base = "/api/seo-plugin/audit";
+      let res = await fetch(forceRefresh ? `${base}?nocache=1` : base, {
+        credentials: "include",
+        cache: "no-store"
+      });
+      let attempts = 0;
+      const MAX_POLLS = 90;
+      while (res.status === 202 && attempts < MAX_POLLS) {
+        setBuilding(true);
+        await new Promise((r) => setTimeout(r, 3e3));
+        res = await fetch(base, { credentials: "include", cache: "no-store" });
+        attempts++;
+      }
+      if (res.status === 202) throw new Error(t.seoView.buildTimeout);
       if (!res.ok) throw new Error(`HTTP ${res.status}`);
       const data = await res.json();
       setItems(data.results || []);
@@ -9090,6 +9315,7 @@ function SeoView() {
     } catch (e) {
       setError(e instanceof Error ? e.message : t.common.loadingError);
     }
+    setBuilding(false);
     setLoading(false);
   }, [t]);
   React4.useEffect(() => {
@@ -9531,7 +9757,7 @@ function SeoView() {
           fontSize: 14,
           fontFamily: "var(--font-body, system-ui)"
         },
-        children: t.seoView.loadingAudit
+        children: building ? t.seoView.buildingAudit : t.seoView.loadingAudit
       }
     );
   }