Introduction
What dx-seo is — an agent-fed SEO dashboard that logs every action and grades it against Search Console
What is dx-seo?
dx-seo is a dashboard for a suite of Claude Code SEO slash commands. The commands work your Google Search Console and DataForSEO data, keep local memory in seo/config.json and seo/actions.jsonl, and push what they find and change to this dashboard over MCP. The dashboard is the always-on, cross-project view — and the home of the verify loop.
The commands are the source of truth on disk; the dashboard is where their history lives, stays visible across every project, and gets graded.
The core loop
What makes dx-seo different from a rank tracker: it logs every SEO action, then judges it against Search Console weeks later.
Commands push over MCP
You run /seo-analyze, /seo-quick-wins, /seo-next-content and the rest in any Claude Code session. Each pushes its results here — sites, the action ledger, keyword tables, content briefs, and the proven-authority snapshot.
The dashboard visualizes
Overview, Keywords, Actions, Next Steps, and Portfolio render that data. Nothing is typed by hand.
The verify loop grades
Every executed action is logged with its GSC baseline and a date it becomes eligible to grade. /seo-verify later pulls fresh data and returns a verdict — win, neutral, or loss — so you learn what actually works on each site.
What the commands push
Sites
The seo/config.json contents — GSC property, market, niche, competitors — via seo_upsert_site.
The action ledger
Every seo/actions.jsonl line, verbatim, via seo_sync_actions. Upserted by entry id, so pushing the whole file is safe.
Keyword snapshots
The keyword tables commands report — positions, impressions, volume, KD — via seo_push_keywords. Append-only; history is kept.
Content briefs
Publish plans from /seo-next-content and /seo-analyze via seo_push_recommendations, plus the authority snapshot via seo_push_authority.
The dashboard pages
| Page | What it shows |
|---|---|
| Overview | Proven-authority ceiling, keyword rank distribution, CTR-weighted visibility score, verified win/loss outcomes |
| Keywords | Latest metrics per keyword, a position-history matrix, and a trend chart |
| Actions | The action ledger with a verify queue: cooling, due, verified, dismissed |
| Next Steps | Content briefs you can mark published or dismissed |
| Portfolio | Cross-site roll-up: win-rate by action type, shared link partners, combined verify queue |
Access
The dashboard authenticates with OIDC on the web, and exposes a self-hosted MCP server (POST /mcp) that any Claude Code session can push to with an API key.