SEO Optimization Suite

Paid pluginsize Lplanned, not built

Indicative price, not an offer: EUR 300-400/year or EUR 500 one-off

Generated from docs/plan/paid/seo-optimization-suite/PLAN.md in the AstroBaaS repository. Nothing described below is implemented — it is the written plan for it.

SEO Optimization Suite is a comprehensive paid feature providing SEO audit reports, search-rank tracking, keyword recommendations, and bulk meta-tag optimization. Merchants get monthly reports showing which products rank well, which need optimization, and specific recommendations (add keyword, improve meta description). This is a paid plugin requiring deep SEO expertise (support commitment) and ongoing algorithm adaptation.

The problem

Getting indexed and ranked requires SEO expertise most merchants don’t have. Competitors with better SEO dominate search results. Merchants lose 30%+ of potential customers to organic search because products aren’t discoverable. Learning SEO is complex and time-consuming.

What it does

• SEO audit: scan products for missing meta tags, meta descriptions, schema markup, mobile-friendliness issues
• Audit scoring: 100-point scale (60+ acceptable, 80+ good, 95+ excellent) per product
• Keyword analyzer: suggest primary and secondary keywords for each product based on search volume and competition
• Search-rank tracking: monthly snapshot via third-party API (e.g., Ahrefs, SEMrush), top 50 keywords and ranking positions
• Bulk recommendations: ‘Add keyword “hiking boots waterproof” to product 42 meta title (rank: 47, opportunity: top 10)’
• Backlink analysis: show referring domains and anchor text (identify low-quality backlinks to disavow)
• Competitor benchmarking: compare SEO metrics to top 5 competitors (requires merchant to enter competitor URLs)
• Monthly report: PDF with SEO score trends, top opportunities, winning and losing keywords, recommendations
• AI-powered suggestion: system recommends specific meta title/description changes, merchant reviews and approves

What it deliberately does NOT do

Each boundary carries its reason. A boundary without a reason gets crossed by the next person who reads this.

• Content rewriting (restructure paragraphs for keyword density) — scope is meta tag optimization only
• Paid search (Google Ads, Bing Ads) — scope is organic SEO only; paid ads are separate
• Link building service (buy backlinks or create link-building campaigns) — scope is analysis only; link building is risky and out of scope

Data model

Plugin-owned collections: SEOAudit (id, timestamp, products[], auditScores[], recommendations[]), SearchRankSnapshot (id, month, keywords[], positions[], trends[]). No core schema migration.

API

• GET /api/seo/audit/full — comprehensive audit across all products
• GET /api/seo/keywords/suggestions — keyword recommendations for product
• GET /api/seo/search-rank/snapshot — monthly search-rank data from tracker
• GET /api/seo/report/monthly — generate PDF monthly report
• POST /api/seo/competitors/add — add competitor URL for benchmarking

Every route added here must also appear in src/pages/openapi.json.ts — a test fails the build if it does not.

Admin

SEO Dashboard: audit score (e.g., 72/100), breakdown by category (meta tags 80%, mobile 65%, schema 90%). Monthly report shows score trend (chart), top winning keywords (gaining rank), losing keywords (dropping rank), top opportunities (keywords to target). Keyword recommendations list with suggested changes (meta title template: ‘{keyword} | {brand}’). Competitor benchmarking shows comparison chart. Backlink table shows top referring domains and anchor text.

The seam — why this is paid

Paid plugin owns: audit algorithm, SEO scoring, keyword analysis, search-rank tracking (via third-party API), competitor benchmarking, monthly report generation, support SLA. Core owns: product metadata storage, meta tag rendering.

Requires deep SEO knowledge, content optimization guidance, and ongoing algorithm adaptation. Support commitment for strategy consulting.

Dependencies

• seo-optimizer (basic meta-tag tools; this is advanced layer)
• core-audit-log (recommendations tracked)

Acceptance checks

Each of these must be able to fail. Before claiming this is done, break the code deliberately and watch each one go red.

• Audit scans 500 products; SEO score 72/100 with breakdown (meta 75%, schema 60%, mobile 85%)
• Monthly search-rank report shows top 50 keywords and ranking positions (avg rank 34, top 10: 8 keywords)
• Keyword analyzer suggests ‘waterproof hiking boots’ for product ‘KEEN Targhee III’; search volume 12,000/mo, competition medium, opportunity score 78/100
• Competitor URL added; benchmark shows ‘Competitor X ranks for 120 keywords you’re missing’
• Backlink table shows ‘example.com (10 links)’ with anchor text ‘best hiking boots’, quality score medium
• Monthly PDF report generated with trends, winning/losing keywords, top 10 recommendations

Risks

Search-rank tracking API rate limit breaks monthly report; fallback to cached data required. Keyword volume data outdated (third-party API lag); recommendations stale. Competitor benchmarking requires competitor entering their own URLs (cannot scrape); feature adoption low. Audit scoring formula opaque to merchant; trust erodes if scoring seems arbitrary. AI-powered suggestions wrong (suggests ‘iPhone’ keyword for non-Apple product); requires human review gate.

Commercial context

The anchor is what the nearest equivalent charges on Shopify or Magento today. It is context for a pricing decision, not the decision.

---

Generated from the commerce plan. See docs/COMMERCE-PLAN.md for the full catalogue and ../../AI-GUIDE.md for how to work on this repository.