seo-vertical-detect
Given the PageSnapshot, classify the site so the orchestrator can route conditional modules. Read references/routing.md for the signal table.
Inputs
Read-only over persisted data — no fetching: the homepage parsed (jsonld[], anchors[], metas[], hreflang[], <html lang>, text_sample) from <run_dir>/pages/<slug>.json, <run_dir>/crawl.json (route patterns, templates), <run_dir>/site/discovery.json (llms.txt presence), and the vertical_hints[] emitted by detect-platform.mjs in <run_dir>/profile.json (e.g. WooCommerce/Shopify → ecommerce; a docs generator → docs). Hints are signals, not verdicts — cite them in signals like any other evidence.
Method
Score each vertical from observable signals (not guesses):
- ecommerce —
Product/Offer JSON-LD, cart/checkout/add-to-cart routes or buttons, price + currency elements, og:type=product.
- local-business —
LocalBusiness JSON-LD, NAP block (name/address/phone), maps embed, opening hours, store-locator.
- blog-publisher —
Article/BlogPosting JSON-LD, author bylines/author pages, RSS/Atom <link>, dated post archives.
- saas — pricing/signup/login routes,
SoftwareApplication schema, feature/integration/docs pages.
- docs — docs/reference routes, sidebar/version nav, dense code blocks, present
llms.txt.
- generic — none dominates.
A site can match several; return all that clear the threshold, ranked, plus a primary.
Locales: detect hreflang tags, <html lang>, and locale-prefixed routes (/es/, /fr/). If >1 locale, flag multilingual so M20 (hreflang) activates.
Output
{ "primary": "ecommerce", "also": ["blog-publisher"], "multilingual": true, "locales": ["en","es"],
"signals": { "ecommerce": ["Product JSON-LD on /p/...", "cart route /cart"], "...": [] } }
Base every classification on a cited signal in signals — never label a vertical without evidence.
1---2name: seo-vertical-detect3description: Classify a website as ecommerce, local-business, blog-publisher, saas, docs, or generic (multiple may apply), and report detected locales, from the persisted PageSnapshot plus the platform detector's vertical hints. Used by seo-orchestrator to decide which conditional modules to run and how to reweight the scores.4---56# seo-vertical-detect78Given the PageSnapshot, classify the site so the orchestrator can route conditional modules. Read `references/routing.md` for the signal table.910## Inputs11Read-only over persisted data — no fetching: the homepage `parsed` (`jsonld[]`, `anchors[]`, `metas[]`, `hreflang[]`, `<html lang>`, `text_sample`) from `<run_dir>/pages/<slug>.json`, `<run_dir>/crawl.json` (route patterns, templates), `<run_dir>/site/discovery.json` (llms.txt presence), and the `vertical_hints[]` emitted by `detect-platform.mjs` in `<run_dir>/profile.json` (e.g. WooCommerce/Shopify → ecommerce; a docs generator → docs). Hints are signals, not verdicts — cite them in `signals` like any other evidence.1213## Method14Score each vertical from observable signals (not guesses):15- **ecommerce** — `Product`/`Offer` JSON-LD, cart/checkout/add-to-cart routes or buttons, price + currency elements, `og:type=product`.16- **local-business** — `LocalBusiness` JSON-LD, NAP block (name/address/phone), maps embed, opening hours, store-locator.17- **blog-publisher** — `Article`/`BlogPosting` JSON-LD, author bylines/author pages, RSS/Atom `<link>`, dated post archives.18- **saas** — pricing/signup/login routes, `SoftwareApplication` schema, feature/integration/docs pages.19- **docs** — docs/reference routes, sidebar/version nav, dense code blocks, present `llms.txt`.20- **generic** — none dominates.2122A site can match several; return all that clear the threshold, ranked, plus a `primary`.2324**Locales**: detect `hreflang` tags, `<html lang>`, and locale-prefixed routes (`/es/`, `/fr/`). If >1 locale, flag multilingual so M20 (hreflang) activates.2526## Output27```json28{ "primary": "ecommerce", "also": ["blog-publisher"], "multilingual": true, "locales": ["en","es"],29 "signals": { "ecommerce": ["Product JSON-LD on /p/...", "cart route /cart"], "...": [] } }30```31Base every classification on a cited signal in `signals` — never label a vertical without evidence.
Hainrixz