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
The all-sites Overview plus the per-site Site, Keywords, Actions, and Next Steps pages 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 | Cross-site roll-up (the landing page): win-rate by action type, shared link partners, combined verify queue |
| Site | 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 |
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.