This guide walks you through every screen in the SEOgent dashboard — from starting your first scan to drilling into per-page results.
Starting a Scan
Click New Scan from your scan list to open the scan creation modal.
You have two input modes:
- Scan Domain — Enter a root domain (e.g.
acme-store.com) and SEOgent discovers pages automatically via sitemap and crawling. You can optionally set a maximum page limit (100, 500, or 1,000). - Scan Specific URLs — Paste up to 1,000 URLs (one per line) to scan exactly the pages you care about.
If you've scanned before, your recent domains appear as quick-select chips below the input.
Scan Options
Every scan includes SEO Analysis (meta tags, headings, content quality) by default. You can also enable:
- Performance Scan — Measures Core Web Vitals (LCP, FCP, CLS, TTFB) on representative pages using headless Chrome.
- Link & Image Check — Detects dead links and broken images across your site. This costs an additional 2 credits per page scanned.
A credit balance warning appears if your balance is low, with a link to purchase more.
Your Scan List
After starting a scan, you're taken back to the scan list. Each scan appears as a card showing its current state at a glance.
Each card displays:
- Domain name and crawl mode (full crawl, sitemap, single page)
- Status badge — Queued (yellow), Running (blue), Complete (green), or Failed (red)
- Overall score (for completed scans) with a color-coded ring — Excellent (green, 90–100), Good (yellow, 70–89), Needs Work (orange, 50–69), or Poor (red, 0–49)
- Quick stats — time since completion, issue count, and LCP value
- Progress bar — for running scans, shows percentage and pages crawled
Click any card to view its full results, or click a running scan to watch progress in real time.
Monitoring Progress
While a scan is running, the progress view shows exactly what SEOgent is doing.
The progress page includes:
- Completion percentage with a large progress bar
- Phase indicator — three phases shown as connected dots:
- Discovering — Finding URLs from sitemaps and crawling
- Crawling — Fetching each page and extracting data
- Analyzing — Running SEO checks and performance scans
- Live metrics — URLs discovered, pages crawled, pages analyzed, and estimated time remaining
- Activity log — Real-time feed showing each URL as it's crawled and analyzed, with response codes and individual scores
Understanding Your Results
Once a scan completes, the results page gives you a comprehensive overview of your site's SEO health.
Overall Score & Score Cards
The large score ring shows your site's overall SEO score out of 100. Next to it, four cards break down how your pages scored:
| Card | Range | Meaning |
|---|---|---|
| Excellent | 90–100 | Page passes nearly all checks |
| Good | 70–89 | Minor issues to address |
| Needs Work | 50–69 | Several issues impacting SEO |
| Poor | 0–49 | Critical problems need attention |
Each card shows how many of your pages fall into that bucket, with a proportional bar underneath.
Core Web Vitals
Below the score cards, four performance metrics are displayed with color-coded bars:
- LCP (Largest Contentful Paint) — How fast the main content loads. Good: under 2.5s, Poor: over 4.0s.
- FCP (First Contentful Paint) — Time to first visible content. Good: under 1.8s, Poor: over 3.0s.
- CLS (Cumulative Layout Shift) — Visual stability. Good: under 0.1, Poor: over 0.25.
- TTFB (Time to First Byte) — Server response time. Good: under 800ms, Poor: over 1800ms.
Each bar shows where your median value falls on the good-to-poor spectrum.
Site Configuration
Three configuration checks appear below the vitals:
- robots.txt — Whether it exists and allows crawling
- Sitemap — Whether a sitemap.xml was found and how many URLs it contains
- AI Bot Access — Whether your robots.txt blocks AI crawlers like GPTBot or ClaudeBot (shown as a warning since blocking these may reduce your visibility in AI-powered search)
Top Issues & Filtering
The issues panel on the left ranks every problem found across your site, sorted by frequency.
Each issue row shows:
- A severity dot — red (critical), yellow (warning), or blue (informational)
- The issue name (e.g. "Missing meta description")
- A count badge showing how many pages are affected
Click any issue to filter the page results list on the right. An active filter chip appears in the filter bar showing what you've selected. Click the x on the chip to clear the filter.
The page results list shows each affected URL with its score and issue tags. You can also search by URL using the search input.
Page Detail View
Click any page in the results list to open the detail view with a full breakdown of that page's SEO health.
At the top, score chips show the overall score plus category-specific scores (Content, Meta Tags, Social, Schema). Below that, a performance strip shows the page's individual Core Web Vitals.
Check Categories
Results are grouped into categories, each with its own score:
- Meta Tags — Title tag, meta description, canonical URL, title length
- Content — H1 presence, heading hierarchy, word count, image alt text
- Social & Open Graph — OG title, description, image dimensions, Twitter card
- Structured Data & Answer Optimization — Product/Article schema, breadcrumbs, FAQ schema
Each individual check shows:
- A green checkmark for passing checks (with the detected value)
- A yellow exclamation for warnings (with a recommendation)
- A red X for failures (with what to fix)
This per-page view is what you'll use to diagnose and fix individual pages, whether manually or by feeding the results to an AI agent via the CLI.