README

On-demand SEO health audit + score for Magento 2. Scans your products, categories and CMS pages for SEO problems, gives the store a 0-100 health score, and lists every issue in an admin grid — each one tagged with the suite module that fixes it. Part of the Etechflow SEO Suite.

What it checks

Area	Checks
Meta	products/categories/CMS missing meta title or description, duplicate meta titles or descriptions, meta titles/descriptions too short/long
Content	thin or missing product descriptions, products with no base image, and (rendered) pages whose main image has no alt text or with a missing/duplicate H1
Links	logged 404s and redirect chains (via Etechflow_RedirectManager — soft dependency)
Canonical	rendered-HTML check on a sample of product pages: missing canonical, duplicate canonical tags, or a canonical that points to a URL which redirects (301/302) or 404s — the kind of render-time fault data-only checks can't see
Indexability	rendered-HTML checks for pages quietly lost from Google: live (200) pages returning noindex (robots meta or `X-Robots-Tag`), live catalogue URLs blocked by robots.txt, and dead/redirecting URLs listed in the XML sitemap (plus a sitemap not referenced in robots.txt)
Social	rendered-HTML check: product pages missing Open Graph / Twitter Card tags (how links look when shared), or an `og:url` on a different domain than the store (catches dev/staging-domain leakage after a domain swap)
Schema	rendered-HTML check: product pages with no Product JSON-LD structured data (Google's preferred format for rich results — price, availability, ratings). Handles `@graph` and arrays

Each check is a small class implementing Api\CheckInterface, registered into the scanner pool in etc/di.xml — so you can add your own checks without touching core.

How it works

Scanner runs every registered check (most are fast, SQL-backed; the canonical and indexability checks fetch a sample of rendered pages over HTTP via the shared Service\HtmlFetcher), replaces the issue table with fresh findings, and stores a summary (score + counts) via FlagManager.
Rendered-HTML checks read live pages, so for origins behind Varnish / basic-auth / an edge gate they can fetch an internal endpoint instead of the public URL. Configure once under Stores → Config → Etechflow → SEO Audit → Page Fetch (sample size, optional fetch base URL + basic auth; the store domain is sent as the Host header). Each rendered group (Canonical, Indexability) has its own enable toggle.
ScoreCalculator turns issue counts into a transparent 0-100 score: penalty = critical×3 + warning×1 + notice×0.3, normalised against the number of products + categories + CMS pages.
Admin dashboard (Content → SEO Audit) shows the score, a severity/area breakdown, a Run SEO Scan Now button, and the full issue grid. Each row links to the entity and names the Fix with module.
CLI: bin/magento etechflow:seoaudit:scan.

The suite hook

The audit is the finder; the rest of the Etechflow SEO Suite is the fixer. Findings point at the tool that resolves them:

Missing / duplicate / poor meta → Etechflow_MetaTemplates or Etechflow_AiSeo
404s & redirect chains → Etechflow_RedirectManager
Canonical pointing at a redirect / duplicate / missing → Etechflow_CanonicalHreflang
Pages hidden from Google (noindex / robots.txt) → review robots directives; sitemap hygiene → core sitemap config
(Structured-data gaps → Etechflow_RichSnippets)

Install

composer require etechflow/module-seo-audit
bin/magento module:enable Etechflow_SeoAudit
bin/magento setup:upgrade
bin/magento setup:di:compile     # production

Configure

Stores → Configuration → Etechflow → SEO Audit — tune the meta-title/description length thresholds and the thin-description cutoff. Then Content → SEO Audit → Run SEO Scan Now.

etechflow / module-seo-audit

Maintainers

Package info

Statistics

Security