Live SEO Auditor — Complete Usage Guide

A real-time, in-page SEO analysis extension that works on any website — a live draft in Blogger, WordPress, Ghost, or any editor, or an already-published page anywhere. Every feature is free to use, forever, with no trial and no feature limits. A license unlocks exactly one thing: copying a result out of the panel.

Table of Contents

1. How It Works, In Brief
2. Installing the Extension
3. The Panel Header
4. Focus Keywords
5. Section 1: Webpage (Page Inspector)
6. Live Analysis (Score, Checklist, Readability, Keywords)
7. Section 2: Advanced
   • 7.1 Related & LSI Keywords
   • 7.2 Snippet A/B Test
   • 7.3 Pro Tools
   • 7.4 Website Analysis
   • 7.5 AI Writing Assistant
8. The Popup
9. Settings Page, Section by Section
10. Licensing: What's Free, What Copying Costs
11. Copy Protection — What It Does and Doesn't Do
12. Real-Time Data Providers — Full Reference
13. Known Limitations, Stated Honestly
14. Quick-Start Workflow

1. How It Works, In Brief

The extension injects a floating panel into the top-right of any webpage. It automatically detects whether you're looking at a live draft in a post editor (Blogger, WordPress, Ghost, and similar) or an already-published page, and analyzes whichever it finds — falling back through several detection layers (editable title/content fields → the page's actual <title> tag and <meta name="description"> → a semantic content area like <article> or <main> → the full page body as a last resort) so it works reasonably on virtually any page, not just recognized editors.

Everything re-analyzes automatically: 2.5 seconds after you stop typing, and every 15 seconds as a fallback in case the faster trigger doesn't fire (e.g., on a cross-origin editor iframe it can't directly observe for changes).

2. Installing the Extension

1. Unzip the delivered package to a folder on your computer.
2. Open Chrome and go to chrome://extensions.
3. Turn on Developer mode (top-right toggle).
4. Click Load unpacked and select the unzipped folder.
5. The extension icon appears in your toolbar, and the panel will auto-inject the next time you visit a webpage.

If you're updating to a newer version, click the reload icon on the extension's card in chrome://extensions. Any tab that was already open before the reload needs a page refresh — an already-injected panel from the previous version can't reconnect to the updated extension on its own (this is a standard Chrome behavior, not a bug specific to this extension).

3. The Panel Header

Control	What it does
SEO Auditor (title)	Just a label.
Copy: Locked / Copy: Unlocked (badge)	Shows your current license status. "Locked" means every feature still works fully — it only means the Copy button on results won't copy until you have a license.
⤓ (Export)	Downloads a Markdown file containing your current Live Analysis plus whatever result is currently showing in each of the Pro Tools / Website Analysis / AI Writing Assistant buttons you've clicked. Only exports what's currently displayed per button, not a full history of everything you've ever generated.
☾ (Theme toggle)	Switches the panel between dark and light themes. Your choice is remembered across sessions.
− / + (Collapse toggle)	Shrinks the panel down to just the header, hiding the body. Click again to expand.
✕ (Close)	Fully removes the panel from the current page. Reload the page to bring it back — this is a per-page-view dismissal, not a permanent site-wide opt-out, since the extension re-injects fresh on every page load.

4. Focus Keywords

• Primary keyword — the main term you're targeting. Almost every other feature (density checks, AI prompts, SERP lookups) uses this field specifically.
• Secondary keywords (2 fields shown by default) — additional terms you also want tracked for density and title/meta/heading presence.
• + Add Keyword — adds another keyword field. Unlimited, and completely free — there's no cap on how many keywords you can track.

5. Section 1: Webpage (Page Inspector)

A tabbed inspector modeled on the format popularized by tools like Detailed SEO Extension. This section stays in place and doesn't reset which tab you're viewing when a new analysis cycle runs in the background.

Tab	What it shows
Overview	Title (with character count), meta description (with character count), the page's URL, and total word count.
Headings	Every heading on the page, in document order, indented by level (H1 through H6) — not just a count.
Links	Every link (up to the first 30), each labeled Internal or External, with its visible anchor text and full URL.
Images	Every image (up to the first 30), each showing its src and its alt text — or flagged if alt text is missing.
Schema	Real structured data (JSON-LD) already present on the page, parsed and pretty-printed. This is detection, not generation — distinct from "Generate Schema Markup" in Pro Tools, which creates new schema.
Social	Real Open Graph (og:*) and Twitter Card (twitter:*) meta tags already present on the page — also detection, not generation.

6. Live Analysis (Score, Checklist, Readability, Keywords)

This is the part that refreshes automatically on every analysis cycle.

• SEO Score (0–100, color-coded) — a transparent, weighted formula combining title/meta length, heading structure, keyword usage, readability, links, and images. The exact weighting is shown in this guide's Known Limitations section and is adjustable in Settings — it's a heuristic, not a claimed objective ranking-algorithm match.
• Checklist — pass/warn/fail rows for: title length (with an estimated pixel width), meta description length (with estimated pixel width), word count vs. your target, heading structure (H1 count, skipped levels), internal/external link counts, outbound authoritative link presence, image alt-text coverage, whether your focus keyword appears in the first 100 words, and slug/permalink quality (length, stopword bloat) if a permalink field was detected. A same-keyword-reused-elsewhere warning also appears here if you're auditing more than one post with the same focus keyword (see Duplicate Content Risk Check for the stricter, opt-in version of this same idea).
• Readability — Flesch Reading Ease and Flesch-Kincaid Grade Level, computed from the real, published formulas. Syllable counting is an approximation (no dictionary lookup) — the same tradeoff mainstream tools like Yoast make; it will occasionally miscount a word by one syllable.
• Keywords — for each tracked keyword: density percentage, raw count, and whether it appears in the title, meta description, and headings.

7. Section 2: Advanced

7.1 Related & LSI Keywords

Click Find Related Keywords. If you've added a Keywords Everywhere API key in Settings, this returns real search-volume and CPC data for related terms. Without a key, it falls back to a same-draft co-occurrence heuristic — words that frequently appear near your focus keyword within this document only. The panel labels which mode you're in; the fallback is explicitly not the same thing as real aggregate search data.

7.2 Snippet A/B Test

A free-text area to draft an alternate meta description and see its character count and estimated pixel width live, for comparing against your actual meta description in the Overview tab.

7.3 Pro Tools

Button	What it does
Generate Schema Markup	Creates new BlogPosting JSON-LD schema from your title and today's date. (Distinct from the Schema tab, which detects what already exists.)
SERP Preview + People Also Ask	Real live Google search results for your focus keyword via your connected SerpApi or DataForSEO key — top organic results, People Also Ask questions, and Related Searches.
Suggest Internal Links	Scans your own blog's RSS/Atom feed or sitemap (set in Settings) and suggests past posts worth linking to, based on keyword/title overlap with your current draft.
Bulk Post Audit	Fetches every post's real published page (from the same feed/sitemap, capped at 50) and flags missing meta descriptions, heading problems, missing alt text, and thin content across your whole site.
AI Content Gap vs Competitors (needs AI key)	Compares your draft against the real competitor results from SERP Preview (run that first) and suggests content gaps or a differentiation angle.
Generate FAQ Schema (AI) (needs AI key)	Asks your connected AI to draft FAQ pairs and formats them directly as FAQPage JSON-LD schema.
Check for Broken Links	Fetches every link in your draft directly (capped at 15) and flags any returning an error status.
Duplicate Content Risk Check	The stricter version of the cannibalization warning in the Checklist — compares your draft against your blog archive with a much higher similarity threshold, specifically flagging posts that may be too similar, not just related.

7.4 Website Analysis

General:

Button	What it does
Synonyms & NLP Entities	Asks your connected AI for synonyms, named entities, and semantically related terms for your focus keyword — genuinely AI-prompted analysis, not a dedicated NLP API.
Related Problems & Solutions	Asks your connected AI what problems/questions readers researching your keyword likely have, with a suggested angle for each.
Interpret Authority Data (AI) (needs AI key)	Adds plain-language context on top of real Domain Rating/Traffic numbers you've already fetched below — run Domain Rating or Traffic Analysis first. The AI never invents the underlying number, only explains it.
Freshness Update Suggestions (AI) (needs AI key)	For a post you've analyzed before, suggests what's specifically worth updating given how much time has passed — real topic-specific suggestions, not generic "review your content" advice.
Page Speed & Core Web Vitals	Real data from Google's own PageSpeed Insights API — performance score, LCP, CLS, and INP/TBT. Works without any key at a shared, low rate limit; add your own free key in Settings if you hit it.

Ahrefs (needs your Ahrefs API key):

Button	What it does
Domain Rating	Ahrefs' domain-wide authority score. Note: this is Ahrefs' own metric, distinct from Moz's trademarked "Domain Authority."
Backlink Profile	Referring domains and total backlink counts.
Top Organic Keywords	The keywords this domain ranks for, with position and estimated traffic.
Top Pages by Traffic	Your best-performing pages by estimated organic traffic.
Anchor Text Distribution	The most common anchor text pointing to this domain, with referring-domain counts.
URL Rating (this page)	Ahrefs' page-specific authority score — different from the domain-wide Domain Rating above.

Similarweb (needs your Similarweb API key):

Button	What it does
Traffic Analysis	Real monthly visit estimates.
Traffic Sources Breakdown	Percentage split across organic, direct, referral, social, and paid traffic.
Geographic Distribution	Top countries by visitor share.
Engagement Metrics	Bounce rate, pages per visit, average visit duration.
Similar Sites	Domains Similarweb considers comparable to this one.

7.5 AI Writing Assistant

All of these need a connected AI provider key (Claude, GPT, Gemini, or Grok — see Section 12).

Button	What it does
Suggest Titles	5 alternative SEO-friendly titles based on your draft.
Write Meta Description	3 alternatives respecting your configured character limit.
Deep Critique My Draft	Thorough feedback across structure, clarity, completeness, SEO/search-intent fit, and engagement — plus a prioritized Top 3 Fixes list and a publish-readiness verdict.
Generate FAQ	4-6 FAQ question/answer pairs from your draft's content, as plain text (compare to "Generate FAQ Schema" in Pro Tools, which formats this as JSON-LD instead).
Suggest Alt-Text for Missing Images	Text-inferred starting points for images missing alt text. Honest limitation stated directly in the output: the AI never sees the actual image, only surrounding text — these are edits to make, not real image descriptions.
Suggest Content Outline	5-8 suggested H2/H3 section headings in a logical order.
Generate Social Media Snippets	A Twitter/X post and a LinkedIn post to promote the content.
Simplify Complex Sentences	Finds your draft's 5 most complex sentences (by syllables-per-word, the same signal the Flesch formula itself uses) and suggests simpler rewrites.
Optimize for Featured Snippet	Rewrites the most relevant section into a format likely to win Google's featured snippet box.
Adjust Tone	Rewrites your opening 2-3 sentences into a tone you pick from the dropdown (more casual, more professional, more persuasive, or simpler/beginner).
Translate	Type any language into the field and translate your title + meta description into it, for international SEO.

8. The Popup

Click the extension's toolbar icon for a simple status view: your current license status, a short description, and links to Settings, the Guide, and Unlock Copying. The real interface lives in the injected panel, not here.

9. Settings Page, Section by Section

Open via the panel's Export area is not here — access Settings from the popup or by right-clicking the extension icon.

• License — paste a Gumroad license key here to unlock copying results. Explains plainly that every feature already works fully without one.
• Scoring Targets — adjust your minimum word count, target reading grade level, and title/meta character limits, which feed directly into the Checklist and SEO Score.
• Blog Feed or Sitemap — paste either an RSS/Atom feed URL or a sitemap.xml URL (auto-detected). Powers Internal Link Suggestions, Bulk Post Audit, and Duplicate Content Risk Check. Sitemaps are more complete (every page, not just recent posts) but lack post titles/text, so those get filled in via a capped number of extra page fetches; RSS/Atom feeds include titles/text directly but are usually truncated to your most recent 20-25 posts.
• Bulk Post Audit (info only) — explains that this runs from the panel, not from Settings, once a feed/sitemap is connected above.
• Real-Time Data API Key / AI Provider — connect Anthropic (Claude), OpenAI (ChatGPT), Google Gemini, or xAI (Grok). Powers every AI-driven feature across all three Advanced sub-sections. Anthropic and OpenAI are documented with high confidence; Grok is the least-verified of the four — check it first if AI features don't respond.
• Website Authority & Traffic Data — connect your Ahrefs key, Similarweb key, and optionally a PageSpeed key (works without one at a lower shared rate limit).
• Your Data — a plain statement of what this extension actually does with your data: draft analysis stays local; the only network calls are an optional license check, your connected feed/sitemap, and whichever providers you've added keys for.

10. Licensing: What's Free, What Copying Costs

Every single feature in this extension works completely for free, forever — there is no trial, no keyword cap, and no feature gated behind a paywall. Schema generation, SERP previews, every Ahrefs/Similarweb lookup, every AI feature — all fully functional and free.

The one thing a license unlocks is clicking Copy on a result to actually copy it to your clipboard. The result itself is still generated and shown in full either way; a license just lets you extract the text out of the panel.

Get a license at $5/mo via the "Unlock Copying" link in the popup, panel, or Settings.

11. Copy Protection — What It Does and Doesn't Do

To keep the Copy-button paywall meaningful, right-clicking over result content is blocked (no native "Copy" option from the browser's context menu), and manual text selection is disabled over the same content (user-select: none).

Said plainly, not implied as more than it is: these deter the obvious ways to bypass the Copy button, but neither stops a technically determined user from extracting text via the browser's DevTools. No client-side JavaScript can actually prevent that — this extension doesn't claim otherwise.

12. Real-Time Data Providers — Full Reference

Provider	Powers	Cost
SerpApi / DataForSEO	SERP Preview + People Also Ask, AI Content Gap	Free tier + paid
Keywords Everywhere	Real related-keyword/search-volume data (Related & LSI Keywords)	Credit-based
Anthropic (Claude)	All AI Writing Assistant + AI-tagged Website Analysis/Pro Tools features	Free trial credit + paid
OpenAI (ChatGPT)	Same as above	Free trial credit + paid
Google Gemini	Same as above	Free tier + paid
xAI (Grok)	Same as above	Paid (least-verified integration of the four)
Ahrefs	Domain Rating, Backlink Profile, Top Organic Keywords, Top Pages, Anchor Text, URL Rating	Paid
Similarweb	Traffic Analysis, Traffic Sources, Geographic Distribution, Engagement Metrics, Similar Sites	Paid
Google PageSpeed Insights	Page Speed & Core Web Vitals	Free (key optional, raises a low shared rate limit)

Every key is stored locally in your browser only, and used only to call that specific provider directly — never routed through any other server.

13. Known Limitations, Stated Honestly

• The SEO Score is a heuristic, not a ranking-algorithm match. Its weighting (title/meta 25%, headings 20%, keywords 20%, readability 15%, links 10%, images 10%) is one defensible, documented, adjustable choice — not a claim about how Google actually ranks pages.
• Readability's syllable counting is dictionary-free, the same approximation mainstream tools like Yoast use. It can miscount a word's syllables by one.
• Some Ahrefs/Similarweb endpoints are less verified than others. Domain Rating and basic Traffic Analysis have been exercised in real use; the other 10 Ahrefs/Similarweb lookups are reasonable, documented-report-based endpoint guesses that haven't been confirmed against a live response the same way.
• Alt-text and image detection can't see actual image content — suggestions are inferred from surrounding text only.
• Grok is the least-verified AI provider of the four supported.
• Schema/Social tab detection only sees what's actually in the page's HTML at analysis time — content injected very late by other scripts might not be captured.
• "Extension context invalidated" errors can occur if the extension is reloaded/updated while a page was already open before the reload — refreshing the affected tab resolves this.

14. Quick-Start Workflow

1. Open a post you're writing (or any existing page) and let the panel auto-inject.
2. Enter your focus keyword.
3. Check the 1. Webpage tabs for a quick structural read, and the Live Analysis score/checklist for immediate feedback.
4. Add your API keys in Settings for whichever providers you have — SERP/AI features work richer with them, but the core checklist and score work with zero setup.
5. Use AI Writing Assistant for titles, meta descriptions, and a deep critique before you publish.
6. Before publishing, run Suggest Internal Links and Check for Broken Links from Pro Tools.
7. After publishing, periodically run Bulk Post Audit and Freshness Update Suggestions across your archive.