Micro SEO Operator

Live backend disconnectedConfigure MICRO_SEO_BACKEND_URL

Set MICRO_SEO_BACKEND_URL to enable live session, billing, provider, site, and job state branches.

Critical8Revenue-backed opportunities

High24Ranking 5-20 or low CTR

Watchlist91Needs more data

Avg Confidence78%Based on source overlap

Auth sessionAuthenticated workspace

Backend-core session context is required before site, opportunity, approval, or report data is shown.

Verify /api/seo/v1/onboarding

Site connectionSetup required

AudioVideoNation has CMS data online, but GitHub execution mode still needs a connected repository grant.

Connect GitHub or continue plugin-only

Paid entitlementRevenue gate active

Recommendation generation, report exports, and backlink previews require micro_seo:paid entitlement.

Keep upgrade CTA visible for free users

Production UI states

Readiness states to preserve when live APIs are connected

Design contract

These shared states document the user-facing contract for loading, empty, error, auth, provider, plan, sandbox, verification, and rollback paths before static scaffold screens are wired to live data.

Data lifecycle states

Every route should show users whether data is loading, absent, unavailable, or blocked by access.

loadingLoading

Skeleton cards and tables while provider, workspace, or report data is syncing.

All dashboard and module routes

emptyEmpty

First-run workspace guidance when no sites, providers, opportunities, approvals, backlinks, or reports exist.

Sites, integrations, opportunities, approvals, BacklinkBase, AI visibility, reports

errorError + retry

Recoverable provider/API failures with retry copy and support-safe diagnostics.

All provider-backed routes

unauthorizedUnauthorized

Backend-core session, workspace membership, and role denial states before showing SEO data.

All workspace-scoped routes

Commercial and provider states

Provider health, plan gates, sandbox boundaries, and entitlement limits must be visible before users can act.

disconnected_providerDisconnected provider

Google, WordPress, GitHub, Vercel, DataForSEO, and BacklinkBase disconnect/expired/rate-limited states.

Integrations plus dependent module routes

plan_limitPlan limit

Starter/Pro/Agency gates for sites, reports, provider syncs, users, credits, and automation rules.

Sites, reports, BacklinkBase, approvals, integrations

sandboxSandbox

BacklinkBase and destructive writes must identify sandbox versus production execution before approval.

BacklinkBase, approval queue, technical execution

Execution safety states

Approval, verification, and rollback states should stay visible through the full SEO change lifecycle.

verification_failedVerification failed

Applied changes that did not verify on preview/live HTML need retry and rollback affordances.

Approval queue, technical SEO, schema, WooCommerce SEO, reports

rollback_availableRollback available

WordPress snapshots, GitHub PR reversions, and backlink audit trails must stay tied to an approved action.

Approval queue, WordPress plugin actions, reports

Opportunities queue

Current work

PriorityEntitySignalExecutorImpact

CriticalEpson 5050UB product pageHigh paid revenue, low organic CTRWordPress PluginMeta rewrite + FAQ schema

HighAstro product templateFAQ JSON exists but schema is not renderedGitHub PRTemplate/schema rendering PR

HighProjector categoryRanks 8-15 for commercial intent queriesHybrid OperatorCategory copy + internal links

Scoring

Traffic x revenue x confidence

Opportunity score weights traffic potential, revenue potential, confidence, and execution difficulty.

Routing

Fixes go to the right executor

CMS fields go through the plugin. Template and canonical issues become GitHub PR jobs.