fusengine/seo

SEO/GEO Orchestrator

Invocation: /seo $1 $2 where $1 is the command and $2 is the URL or local path.

Comprehensive SEO + GEO 2026 analysis across all industries (SaaS, local services, e-commerce, publishers, agencies). Orchestrates 20 sub-skills and 8 parallel sub-agents. Local-first, zero third-party APIs.

Quick Reference

| Command | What it does | Sub-skill | |---------|--------------|-----------| | /seo audit <url> | Full audit with parallel subagent delegation | seo-audit | | /seo page <url\|path> | Deep single-page analysis | seo-page | | /seo technical <url> | Technical SEO (robots, CWV, crawlability) | seo-technical | | /seo schema <url\|path> | Detect/validate/generate JSON-LD | seo-schema | | /seo content <url> | E-E-A-T + anti-cannibalization | seo-content | | /seo images <url> | Image SEO: alt text, formats, lazy loading | seo-images | | /seo sitemap <url\|generate> | Analyze or generate XML sitemaps | seo-sitemap | | /seo hreflang <url> | i18n/multilingual audit and generation | seo-hreflang | | /seo internal-linking <url> | Pillar/cluster, anchor optimization | seo-internal-linking | | /seo cluster <keyword> | SERP-based semantic clustering | seo-cluster | | /seo brief <topic> | Generate detailed content brief | seo-content-brief | | /seo plan <type> | Strategic planning (saas/local/ecommerce/publisher) | seo-plan | | /seo sxo <url> | Search Experience Optimization | seo-sxo | | /seo snippets <url> | Position 0 + AI Overviews input | seo-featured-snippets | | /seo local <url> | Local SEO (GBP, NAP, citations, map pack) | seo-local | | /seo geo <url> | AI Overviews/ChatGPT/Perplexity/Claude readiness | seo-geo | | /seo entity <url> | Entity/semantic SEO, knowledge graph, salience | seo-entity | | /seo ecommerce <url> | Product schema, faceted nav, marketplace | seo-ecommerce | | /seo video <url> | VideoObject, YouTube, transcripts | seo-video | | /seo redirects <url> | 301/302, migration, chains | seo-redirects | | /seo drift <url> | SEO diff vs previous git HEAD | (uses diff-seo.ts) |

Orchestration Logic — /seo audit

When user invokes /seo audit <url>:

1. Detect business type from homepage (SaaS, local, ecommerce, publisher, agency)
2. Spawn sub-agents in parallel (single message, multiple Agent calls):
   • seo-technical (robots, sitemap, CWV, hreflang)
   • seo-schema (JSON-LD detect/validate)
   • seo-content (E-E-A-T, anti-cannibalization)
   • seo-geo (AI Overviews readiness)
   • seo-entity (knowledge graph, salience, sameAs/knowsAbout)
   • seo-images (alt, formats, optim)
   • seo-sitemap (sitemap.xml + robots.txt)
3. If local business detected → also spawn seo-local
4. If content strategy signals (blog, pillar pages) → also spawn seo-cluster
5. Collect results, generate unified report with SEO Health Score (0-100)
6. Create prioritized action plan (Critical → High → Medium → Low)

Workflow (7 phases — for content-creation flows)

PHASE 1: ANALYZE   → Extract content, detect intent
PHASE 2: RESEARCH  → SERP analysis, 2026 trends, AI platforms
PHASE 3: KEYWORDS  → Extract with anti-cannibalization
PHASE 4: STRUCTURE → Meta, OG, Twitter Cards, Hn, schema, alt
PHASE 5: CONTENT   → Write SEO+GEO optimized content
PHASE 6: VALIDATE  → SEO + GEO compliance checklists
PHASE 7: DRIFT     → Compare to git HEAD (diff-seo.ts)

Reference Library (legacy 10 categories)

references/
├── 01-seo-foundations/   → research workflow, SEO vs GEO
├── 02-onpage-seo/        → meta tags, OG, Twitter, headers, alt
├── 03-schema-org/        → 9 schema types (templates ready)
├── 04-geo-2026/          → AI platforms, citations, zero-click
├── 05-technical-seo/     → CWV, mobile-first, crawlability
├── 06-content-strategy/  → E-E-A-T, anti-cannibalization, keywords
├── 07-sea-google-ads/    → Quality Score, landing pages (optional)
├── 08-measurement/       → GEO tracking, Share of Model
├── 09-checklists/        → pre-publication, technical audit
└── 10-local-seo/         → GBP, NAP, citations, Local Pack

Scripts Available (scripts/)

| Script | Purpose | |--------|---------| | parse-meta.ts | Extract title/description/OG/canonical via cheerio | | validate-schema.ts | Validate JSON-LD offline against schema.org dumps | | check-cwv.ts | Lighthouse CLI local wrapper | | parse-sitemap.ts | Validate sitemap.xml structure | | parse-robots.ts | Validate robots.txt directives | | parse-hreflang.ts | Validate hreflang tags | | diff-seo.ts | SEO drift via git diff | | geo-score.ts | LLM-readiness scoring (0-100) | | analyze-keywords.ts | Content intelligence: density, n-grams, 0-100 stuffing score, local distribution (local-first) |

Differentiation

• Local-first: zero Google APIs, zero DataForSEO/Moz, zero Python
• Framework-native: delegates implementation to fuse-astro, fuse-nextjs, fuse-laravel
• GEO-first: AI Overviews/ChatGPT/Perplexity as primary target, not afterthought
• TS/Bun stack: all scripts in TypeScript, executed by Bun

Industry Detection

Detect from homepage signals:

• SaaS: /pricing, /features, /integrations, "free trial", "sign up"
• Local: address, phone, opening hours, GBP link, NAP
• E-commerce: /products, /cart, /checkout, product schema
• Publisher: /articles, NewsArticle schema, byline, dateline
• Agency: /services, /case-studies, /clients, testimonials

Quality Gates

• 30+ location pages → warning
• 50+ location pages → hard stop, require manual audit
• 100+ programmatic pages → warning
• 500+ programmatic pages → hard stop
• Thin content detection per page type
• Doorway page prevention

First Invocation — Activate Hook

When user invokes /seo for the first time on a project:

1. Check if .fuse-seo marker exists at project root (or any parent up to repo root)
2. If absent, ask the user before any other work:

   "Activate the fuse-seo hook on this project? It will validate meta/schema/OG on every Write/Edit of HTML-like files (.html, .astro, .tsx, .vue, .blade.php) via the @fusengine/harness seo scope."

3. If user confirms → create empty file .fuse-seo at project root via touch .fuse-seo (or Write tool with empty content)
4. If user declines → proceed without creating the marker (hook stays dormant on this project)
5. Do not ask again in the same session — the marker presence is the persistent answer

This is opt-in by design: never auto-create without explicit user consent.

After Any Analysis

1. Generate markdown report in .fuse-seo/reports/<date>-<command>.md
2. Offer drift baseline capture: /seo drift <url> for future comparisons
3. Suggest framework-specific implementation via delegation:
   • Astro project → fuse-astro:astro-seo
   • Next.js → fuse-nextjs:nextjs-stack
   • Laravel → fuse-laravel:laravel-blade