npm - @consilioweb/payload-seo-analyzer - Versions diffs - 1.9.0 → 1.10.0 - Mend

@consilioweb/payload-seo-analyzer 1.9.0 → 1.10.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (8) hide show

package/README.md CHANGED Viewed

@@ -631,6 +631,8 @@ All endpoints are prefixed with the configured `endpointBasePath` (default: `/se
 | `GET` | `/indexation-audit` | Cross-page indexation hygiene — surfaces every `noindex` / canonical problem in one place |
 | `GET` | `/core-web-vitals` | Real LCP/INP/CLS via PageSpeed Insights — informational, on-demand, SSRF-safe (own origin only) |
 | `GET` `POST` | `/gsc/*` | Google Search Console OAuth (opt-in `features.gscApi`): `status`, `auth`, `callback`, `data`, `disconnect` |
+| `POST` `GET` | `/rank-snapshot` `/rank-history` | Rank tracking (opt-in `features.gscApi`) — daily GSC position snapshots + movement over time |
+| `GET` `POST` | `/alerts-digest` `/alerts-run` | Monitoring digest (opt-in `features.alerts`) — score regressions, new 404s, ranking drops via webhook/email |
 | `GET` | `/history` | Score history data for trend charts |
 | `GET` | `/sitemap-audit` | Sitemap structure audit |
 | `GET` `PATCH` | `/settings` | Read or update SEO settings |
@@ -640,6 +642,7 @@ All endpoints are prefixed with the configured `endpointBasePath` (default: `/se
 | `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` `POST` | `/alt-text-audit` `/ai-alt-text` | **AI image alt-text** (Claude vision, `features.aiFeatures`) — list images missing alt, generate + apply |
 | `GET` | `/cannibalization` | Detect keyword cannibalization |
 | `POST` | `/external-links` | Check external link status (live HTTP checks with SSRF protection) |
 | `GET` | `/sitemap-config` | Sitemap configuration data |
@@ -668,6 +671,45 @@ Scope is **meta only** by design: the SEO 2026 analysis classifies mass AI-gener
 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.
+### AI image alt-text (`/ai-alt-text`)
+Generate the `alt` attribute for images that lack one (accessibility + SEO) using **Claude vision**. The Performance view lists media missing alt; for each image you **Generate**, review/edit, then **Apply** in one click. Gated by `features.aiFeatures`; uses `ANTHROPIC_API_KEY` and `SEO_AI_MODEL` (default `claude-opus-4-8`). Images are fetched server-side and must be on the site origin (or `SEO_MEDIA_ORIGIN`) — SSRF-safe.
+### Rank tracking & monitoring alerts
+- **Rank tracking** (opt-in `features.gscApi`): once Google Search Console is connected, the plugin snapshots **daily query positions** into `seo-rank-history` and shows **movement over time** in the Performance view. No extra setup beyond GSC.
+- **Monitoring alerts** (opt-in `features.alerts`): a periodic digest (default daily) reports **score regressions**, **new 404s** and **ranking drops** via **webhook and/or email**. Configure delivery with env vars:
+| Env var | Default | Purpose |
+|---|---|---|
+| `SEO_ALERT_WEBHOOK_URL` | — | POST the digest JSON to this URL (Slack/Discord/automation). |
+| `SEO_ALERT_EMAIL` | — | Comma-separated recipients (uses Payload's email adapter). |
+| `SEO_ALERT_SCORE_DROP` | `10` | Minimum score drop to report. |
+| `SEO_ALERT_POSITION_DROP` | `5` | Minimum SERP positions lost to report. |
+| `SEO_ALERT_INTERVAL_HOURS` | `24` | Digest frequency. |
+### Frontend render helpers — produce the SEO, not just grade it
+Pure, dependency-free helpers to output the actual `<head>` metadata + JSON-LD from a Payload document, e.g. in a Next.js route:
+```ts
+import { buildSeoMetadata, buildJsonLd } from '@consilioweb/payload-seo-analyzer'
+export async function generateMetadata({ params }) {
+  const doc = await payload.findByID({ collection: 'pages', id, depth: 1 })
+  return buildSeoMetadata(doc, { collection: 'pages', siteName: 'My Site', siteUrl: 'https://example.com' })
+  // → { title, description, alternates: { canonical, languages }, robots, openGraph, twitter }
+}
+// In a Server Component, render the JSON-LD:
+function PageJsonLd({ doc }) {
+  const { jsonLd } = buildJsonLd(doc, { collection: 'pages' })
+  return <script type="application/ld+json" dangerouslySetInnerHTML={{ __html: JSON.stringify(jsonLd) }} />
+}
+```
+`buildSeoMetadata` returns a structural subset of Next's `Metadata` (assignable to it). `buildJsonLd` reuses the exact builders behind the admin schema generator (Article, Product, LocalBusiness, FAQPage, BreadcrumbList, Organization, Person, Event, Recipe, Video). Also exported: `renderJsonLdScript`, `detectSchemaType`, `getSchemaImageUrl`, `SCHEMA_TYPES`.
 ### 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: