Slay Your SEO Demons

SEO Dungeon turns audits into 16-bit boss battles.Codex runs locally. Claude Code and Gemini CLI are optional.

25 SEO skills

18-agent roster. Up to 15 parallel subagents. Real code fixes. MIT licensed.

Latest release
v2.2
Runtime model
Local CLI only
License
MIT
Default path
Codex

What is SEO Dungeon?

SEO Dungeon is an open-source AI SEO audit app for teams that want technical findings to become reviewable code changes, not another forgotten spreadsheet. It turns a site audit into a 16-bit boss battle, but the workflow underneath is practical: Codex is the default local runtime, Claude Code and Gemini CLI are optional, and every action runs through your own machine. The v2.2 suite includes 25 SEO skills for technical audits, content quality, schema, sitemaps, images, GEO, local SEO, backlinks, Google APIs, and DataForSEO-assisted research when credentials are configured. A local WebSocket bridge streams prompts, tool calls, file reads, and edits into the Guild Ledger so you can see exactly what happened. SEO Dungeon is MIT licensed, free to install, and built for developers who want audits, fixes, and proof in one repeatable workflow.

Current facts reviewed June 22, 2026 by Avalon Reset. Latest public release: v2.2.

Install SEO DungeonUse /seo commands

Clone the repo, run the installer, then start the dungeon at localhost.

Built with

Phaser.jsCodex CLIClaude CodeGemini CLIWeb Audio APIWebSocket

Embrace the descent

Pick your warrior, slay your first demon, and see what a real SEO boss fight looks like.

SEO Dungeon demo video thumbnail showing the dungeon interface

Enter the dungeon

Every screen is a step deeper into your site's SEO underworld

Begin Your Quest

The Gate

SEO Dungeon gate scene - continue quest or start new SEO audit in pixel art interface

Continue a previous quest with cached audit results, or begin a new descent. Your progress is saved to localStorage so you can pick up where you left off without re-running the full audit.

Run The Audit

The Descent

SEO Dungeon summoning hallway scene showing the audit running while the hero descends

A fresh quest drops into a side-scrolling hallway while the local CLI audit runs. The Guild Ledger keeps the command channel visible while progress and agent activity advance in the scene.

Explore the Depths

The Dungeon Hall

SEO Dungeon hall showing SEO issues as demons sorted by severity with particle effects

Every SEO issue becomes a demon in the hall. Critical issues are deadly bosses towering over the screen. Info-level issues are goblins. Browse them all sorted by severity, with flickering torches and ambient particle effects setting the mood.

Slay Your Demons

Turn-Based Combat

Turn-based combat in SEO Dungeon with Guild Ledger showing real-time local AI activity

Four actions at your disposal: Attack prompts the selected local CLI agent to analyze the issue and edit your project files directly. Vanquish is your call that the demon is handled, marking it defeated in your quest log. Defend is a defensive flavor action. Flee skips to the next demon. The Guild Ledger shows everything the agent is doing in real time.

How the dungeon works

From character select to SEO victory in six steps

1

Choose Your Warrior

Warrior, Samurai, or Knight. Each maps to a depth and speed profile for your selected local runtime.

2

Enter a Domain

Point the dungeon at any website and its source code. The SEO engine prepares to scan.

3

Descend

The SEO engine runs a full audit with up to 15 parallel subagents, discovering issues as dungeon demons.

4

Explore the Dungeon

Browse discovered SEO issues sorted by severity in the Dungeon Hall. Critical issues are deadly bosses.

5

Battle Demons

Attack prompts the local agent to fix the issue. Vanquish marks it defeated. Defend or Flee when you need to pause. The Guild Ledger shows everything live.

6

Collect Loot

Earn XP and rewards for every demon slain. Your codebase gets cleaner with every victory.

How the Bridge Works

The game doesn't call hosted model APIs directly. Instead, the Phaser.js game sends commands over WebSocket to a local bridge server. The bridge spawns Codex by default, or Claude Code/Gemini CLI when selected. It then loads SEO skills from your local config and runs the audit or fix. Results stream back through WebSocket in real time, and the Guild Ledger displays every tool call, file read, and decision.

Browser (Phaser.js) ←→ WebSocket ←→ Bridge Server ←→ Local CLI → SEO Skills (25) + Agents (18)

What will you vanquish?

25 v2.2 SEO engine skills covering every dimension of SEO

Full Audit

Up to 15 parallel subagents scan your entire site in one pass

Technical SEO

Crawlability, indexability, Core Web Vitals, security, and JS rendering

Schema Markup

Detect, validate, and generate Schema.org structured data in JSON-LD

E-E-A-T

Content quality audit for expertise, experience, authority, and trust signals

GEO

Optimize for Google AI Overviews, ChatGPT web search, and Perplexity

Local SEO

Google Business Profile, NAP consistency, citations, reviews, and map pack

Image SEO

Alt text, formats, responsive sizing, lazy loading, and CLS prevention

Hreflang

International SEO audit with language and region code validation

Backlinks

Tiered link profile analysis with toxic link detection and competitor gaps

Semantic Clusters

SERP overlap clustering for hub-and-spoke content architecture

SXO

Page-type mismatch detection via SERP backwards analysis

SEO Drift

Git for SEO. Capture baselines and detect regressions over time

E-commerce

Product schema, Google Shopping intel, and Amazon marketplace comparison

Google APIs

GSC, PageSpeed, CrUX 25-week history, GA4, and Indexing API integration

Maps Intelligence

Geo-grid rank tracking, GBP audit, reviews, and competitor radius mapping

AI Image Gen

OG images, social previews, and blog headers via Nano Banana 2

Core SEO Commands

The v2.2 engine includes 25 SEO engine skills. Run these commands directly, or let the dungeon orchestrate them automatically.

/seo audit

Full site audit with up to 15 parallel subagents. Crawls up to 500 pages, detects business type, and generates a prioritized action plan.

/seo technical

Crawlability, indexability, security headers, Core Web Vitals, robots.txt, and JavaScript rendering analysis.

/seo content

E-E-A-T framework analysis: expertise, experience, authority, trust signals, readability, and thin content detection.

/seo schema

Schema.org structured data detection, validation against Google requirements, and JSON-LD generation.

/seo page

Deep single-page analysis covering on-page elements, meta tags, headings, images, and internal links.

/seo sitemap

XML sitemap analysis or generation with industry-specific templates and quality gates.

/seo images

Image optimization audit: alt text, file sizes, formats, responsive images, lazy loading, and CLS prevention.

/seo geo

AI search optimization for Google AI Overviews, ChatGPT web search, and Perplexity citations.

/seo local

Google Business Profile, NAP consistency, citation health, review signals, and local schema markup.

/seo maps

Geo-grid rank tracking, GBP audit, review intelligence, and competitor radius mapping.

/seo plan

Strategic SEO planning with industry-specific templates, competitive analysis, and implementation roadmaps.

/seo programmatic

Programmatic SEO for pages generated at scale: template engines, URL patterns, and index bloat prevention.

/seo competitor-pages

Generate SEO-optimized comparison pages: X vs Y layouts, alternatives pages, and feature matrices.

/seo hreflang

International SEO audit: hreflang validation, language/region codes, and multi-language implementation.

/seo backlinks

Backlink profile analysis with 3-tier cascade: Common Crawl (free), Moz/Bing (free signup), DataForSEO (premium).

/seo google

Real Google data via Search Console, PageSpeed Insights, CrUX field data, and GA4 organic traffic.

/seo cluster

Semantic topic clustering via SERP overlap. Builds hub-and-spoke architecture and catches cannibalization.

/seo sxo

Search Experience Optimization. 7-step pipeline that reads SERPs backwards to catch page-type mismatches.

/seo drift

Git for SEO. SQLite-backed baseline capture with 17 comparison rules for regression detection.

/seo ecommerce

E-commerce SEO: product schema, Google Shopping intel, Amazon marketplace comparison, and keyword gaps.

/seo image-gen

AI-generated images for SEO assets: OG previews, blog headers, and social cards via Nano Banana 2.

/seo dataforseo

Extension: live keyword volume, SERP rankings, backlink data, and AI visibility tracking via DataForSEO.

/seo firecrawl

Extension: full-site crawling and URL discovery via the Firecrawl MCP server.

Public SEO Engines

Built from inspectable source

SEO Dungeon is the game interface and the current public package. The Claude SEO suite remains the public Claude-runtime reference for people who want to inspect related terminal-agent SEO workflows without the dungeon UI.

SEO Dungeon

avalonreset/seo-dungeon

The current public package: Codex-default dungeon app, structured local CLI bridge, v2.2 SEO engine, portable agents, Codex profiles, and docs.

Claude SEO

AgriciDaniel/claude-seo

Daniel Agrici's public v2.2 Claude Code SEO suite with technical SEO, E-E-A-T, schema, GEO/AEO, backlinks, local SEO, maps, and reporting workflows.

25

SEO engine skills

18

portable agent prompts

25+

procedural sound effects

Choose your warrior

Each character class selects a depth and speed profile for local AI-powered SEO analysis

SEO Dungeon character select screen showing Warrior, Samurai, and Knight classes
Recommended

Warrior

Deepprofile

Deepest analysis. Highest-cost profile.

  • Best for long-context audits
  • Strongest at multi-step SEO fixes
  • Maps to the deepest runtime setting
  • Pick for critical sites or one-shot audits
Read the docs

Samurai

Balancedprofile

Balanced depth and speed. Recommended default.

  • Strong reasoning at lower cost
  • Most reliable structured-output mode
  • Codex default for day-to-day work
  • Pick for day-to-day audits and fixes
Read the docs

Knight

Fastprofile

Fastest responses. Lowest-cost profile.

  • Fastest response latency
  • Lowest usage cost of the three
  • Good for bulk triage and simple fixes
  • Pick when you want to run many audits quickly
Read the docs

Frequently asked questions

Everything you need to know about this AI SEO tool

What do I need to run SEO Dungeon?

SEO Dungeon needs Node.js 22 or higher for the dungeon app, Python 3.10 or higher, Git, and at least one local AI CLI runtime. Codex is the packaged default. Claude Code and Gemini CLI remain optional runtime choices for teams that already use them. The installer copies the SEO skill suite and agent profiles into the matching local configuration, then the browser game launches audits through the local WebSocket bridge. Playwright is optional and only needed for screenshot-based visual analysis.

Does SEO Dungeon actually fix my code, or is this just a visualizer?

SEO Dungeon can apply real code fixes through the local CLI runtime you choose. When you press Attack, the bridge forwards your prompt plus the selected issue metadata to Codex, Claude Code, or Gemini CLI running on your machine. The Guild Ledger streams tool calls, file reads, and edits in real time, so the work is visible. Vanquish is your decision that the issue is handled. Git commits stay manual, so every change remains reviewable before it ships.

How does the WebSocket bridge work?

The Phaser.js game does not call hosted model APIs directly. It opens a WebSocket connection to a small Node.js bridge server running locally. When you take an action in battle, the bridge receives the command, spawns the selected local CLI process, injects a structured focus header for the active SEO issue, and streams output back into the Guild Ledger. The browser never sees your API keys.

Can I use the SEO skills without playing the dungeon game?

Yes. The dungeon is an optional gamified interface on top of the same SEO skill suite. You can invoke the skills directly from a compatible terminal agent with commands such as /seo audit, /seo technical, /seo schema, /seo geo, /seo local, and /seo backlinks. CLI mode is the better fit for CI, scheduled audits, and headless automation. The game exists for exploratory audits where walking through the findings visually is useful.

What is the difference between the character classes?

Character classes choose the depth and speed profile for the selected local runtime. Warrior is for deep, high-stakes audits, Samurai is the balanced default, and Knight is for fast triage. On Claude Code these map to Opus, Sonnet, and Haiku. Codex and Gemini workflows use comparable local profile settings where available. The class affects audits, issue triage, and battle actions.

How much does it cost to use SEO Dungeon?

SEO Dungeon is free and MIT licensed. The project does not charge for the app. Runtime costs come from whichever local AI CLI you choose and are billed under your own Codex, Claude, Gemini, or API account. The dungeon does not resell model access, proxy your credentials, or make commits for you. Heavy audits cost more than light triage, so choose the class profile that fits the job.

Quick Start
# Clone the repo
git clone https://github.com/avalonreset/seo-dungeon.git
cd seo-dungeon

# Install the SEO skill suite (Windows)
.\install.ps1

# Install the SEO skill suite (macOS/Linux)
bash install.sh

# Start the dungeon
cd dungeon
npm install
npm run dev

# App: http://localhost:3002
# Bridge: ws://127.0.0.1:3003
Read the full docs

Install SEO Dungeon locally

Clone the repo, run the installer, and use the same SEO skill suite through the dungeon or direct /seo commands.

Get install stepsUse without the game