seo-vertical-detect

SkillWeb & browsing

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.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the seo-vertical-detect skill

What this skill tells your AI

The instructions your AI receives, as published by hainrixz/claude-seo-ai in skills/seo-vertical-detect/SKILL.md and read by ahel’s review.

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):

  • ecommerceProduct/Offer JSON-LD, cart/checkout/add-to-cart routes or buttons, price + currency elements, og:type=product.
  • local-businessLocalBusiness JSON-LD, NAP block (name/address/phone), maps embed, opening hours, store-locator.
  • blog-publisherArticle/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.

Signals

GitHub stars
59
Forks
5
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
seo-vertical-detect
Source
github.com/hainrixz/claude-seo-ai