/seo-audit
If you see unfamiliar placeholders or need to check which tools are connected, see CONNECTORS.md.
Audit a website's SEO health, research keyword opportunities, identify content gaps, and benchmark against competitors. Produces a prioritized action plan a marketer can execute immediately.
Trigger
User runs /seo-audit or asks for an SEO audit, keyword research, content gap analysis, technical SEO check, or competitor SEO comparison.
Inputs
Gather the following from the user. If not provided, ask before proceeding:
URL or domain — the site to audit, or a topic/keyword if running in keyword research mode
Audit type — one of:
- Full site audit — end-to-end SEO review covering all sections below
- Keyword research — identify keyword opportunities for a topic or domain
- Content gap analysis — find topics competitors rank for that you don't
- Technical SEO check — crawlability, speed, structured data, and infrastructure issues
- Competitor SEO comparison — head-to-head SEO benchmarking against specific competitors
If not specified, default to full site audit.
Target keywords or topics (optional) — specific keywords the user is already targeting or wants to rank for
Competitors (optional) — domains or companies to compare against. If not provided and the audit type requires competitor data, use web search to identify 2-3 likely competitors based on the user's domain and keyword space.
Process
1. Keyword Research
Research keywords related to the user's domain, topic, or target keywords.
If ~~SEO tools are connected:
- Pull keyword data, search volume, keyword difficulty scores, and ranking positions automatically
- Identify keywords the site currently ranks for and where it's gaining or losing ground
If ~~product analytics are connected:
- Cross-reference keyword targets with actual organic traffic data to validate which keywords are driving visits and conversions
If tools are not connected:
- Use web search to research the keyword landscape
- Note: "For more precise volume and difficulty data, connect an SEO tool like Ahrefs or Semrush via MCP. The audit will auto-populate with ranking data."
For each keyword opportunity, assess:
- Primary keywords — high-intent terms directly tied to the user's product or service
- Secondary keywords — supporting terms and variations
- Search volume signals — relative demand (high, medium, low) based on available data
- Keyword difficulty — how competitive the term is (easy, moderate, hard)
- Long-tail opportunities — specific, lower-competition phrases with clear intent
- Question-based keywords — "how to", "what is", "why does" queries that mirror People Also Ask results
- Intent classification — informational, navigational, commercial, or transactional
2. On-Page SEO Audit
For each key page (homepage, top landing pages, recent blog posts), evaluate:
- Title tags — present, unique, within 50-60 characters, includes target keyword
- Meta descriptions — present, compelling, within 150-160 characters, includes a call to action
- H1 tags — exactly one per page, includes primary keyword
- H2/H3 structure — logical hierarchy, uses secondary keywords where natural
- Keyword usage — primary keyword appears in the first 100 words, used naturally throughout, not over-stuffed
- Internal linking — pages link to related content, orphan pages identified, anchor text is descriptive
- Image alt text — all images have descriptive alt attributes, keywords included where relevant
- URL structure — clean, readable, includes keywords, no excessive parameters or depth
3. Content Gap Analysis
Identify what's missing from the user's content strategy:
- Competitor topic coverage — topics and keywords competitors rank for that the user's site does not cover
- Content freshness — pages that haven't been updated in 12+ months and may be losing rankings
- Thin content — pages with insufficient depth to rank (under 300 words for informational queries, lacking substance)
- Missing content types — formats competitors use that the user doesn't (guides, comparison pages, glossaries, tools, templates)
- Funnel gaps — missing content at specific buyer journey stages (awareness, consideration, decision)
- Topic clusters — opportunities to build pillar pages with supporting content
4. Technical SEO Checklist
Evaluate technical foundations that affect crawlability and rankings:
- Page speed — identify slow-loading pages and likely causes (large images, render-blocking scripts, excessive redirects)
- Mobile-friendliness — responsive design, tap targets, font sizes, viewport configuration
- Structured data — opportunities for schema markup (FAQ, HowTo, Product, Article, Organization, Breadcrumb)
- Crawlability — robots.txt configuration, XML sitemap presence and accuracy, canonical tags, noindex/nofollow usage
- Broken links — internal and external 404s, redirect chains
- HTTPS — secure connection, mixed content issues
- Core Web Vitals signals — LCP, FID/INP, CLS indicators based on observable page behavior
- Indexation — pages that should be indexed but may not be, duplicate content risks
5. Competitor SEO Comparison
For each competitor, compare:
- Keyword overlap — keywords both sites rank for, and where each site ranks higher
- Keyword gaps — terms the competitor ranks for that the user does not
- Domain authority signals — relative site strength based on backlink profiles, referring domains, and content depth
- Content depth — average content length, topic coverage breadth, publishing frequency
- Backlink profile observations — types of sites linking to competitors, link-worthy content they've produced
- SERP feature ownership — which competitor appears in featured snippets, People Also Ask, image packs, or knowledge panels
- Technical advantages — site speed differences, mobile experience, structured data usage
Output
Executive Summary
Open with a 3-5 sentence summary of overall SEO health. Highlight:
- The site's biggest strength
- The top 3 priorities that will have the most impact
- An overall assessment: strong foundation, needs work, or critical issues
Keyword Opportunity Table
| Keyword |
Est. Difficulty |
Opportunity Score |
Current Ranking |
Intent |
Recommended Content Type |
Opportunity score: high, medium, or low — based on the combination of search demand, difficulty, and relevance to the user's business.
Include 15-25 keyword opportunities, sorted by opportunity score.
On-Page Issues Table
| Page |
Issue |
Severity |
Recommended Fix |
Severity levels:
- Critical — directly hurting rankings or preventing indexation
- High — significant impact on SEO performance
- Medium — best practice violation, moderate impact
- Low — minor optimization opportunity
Content Gap Recommendations
For each content gap identified, provide:
- Topic or keyword to target
- Why it matters — search demand, competitor coverage, funnel stage
- Recommended format — blog post, landing page, guide, comparison page, etc.
- Priority — high, medium, or low
- Estimated effort — quick win (1-2 hours), moderate (half day), substantial (multi-day)
Technical SEO Checklist
Status: Pass, Fail, or Warning.
Competitor Comparison Summary
| Dimension |
Your Site |
Competitor A |
Competitor B |
Winner |
Include rows for: keyword count, content depth, publishing frequency, backlink signals, technical score, SERP feature presence.
Prioritized Action Plan
Split recommendations into two categories:
Quick Wins (do this week):
- Actions that take under 2 hours and have immediate impact
- Examples: fix title tags, add meta descriptions, fix broken links, add alt text
Strategic Investments (plan for this quarter):
- Actions that require more effort but drive long-term growth
- Examples: build a topic cluster, create a pillar page, launch a link-building campaign, overhaul site structure
For each action item, include:
- What to do (specific and concrete)
- Expected impact (high, medium, low)
- Effort estimate
- Dependencies (if any)
Follow-Up
After presenting the audit, ask:
"Would you like me to:
- Draft content briefs for the top keyword opportunities?
- Create optimized title tags and meta descriptions for your key pages?
- Build a content calendar based on the gap analysis?
- Dive deeper into any specific section of the audit?
- Run this same analysis for a different competitor or domain?"
1---2name: mkt-seo-audit3description: Run a comprehensive SEO audit — keyword research, on-page analysis, content gaps, technical checks, and competitor comparison. Use when assessing a site's SEO health, when finding keyword opportunities and content gaps competitors own, or when you need a prioritized action plan split into quick wins and strategic investments.4---56# /seo-audit78> If you see unfamiliar placeholders or need to check which tools are connected, see [CONNECTORS.md](../../CONNECTORS.md).910Audit a website's SEO health, research keyword opportunities, identify content gaps, and benchmark against competitors. Produces a prioritized action plan a marketer can execute immediately.1112## Trigger1314User runs `/seo-audit` or asks for an SEO audit, keyword research, content gap analysis, technical SEO check, or competitor SEO comparison.1516## Inputs1718Gather the following from the user. If not provided, ask before proceeding:19201. **URL or domain** — the site to audit, or a topic/keyword if running in keyword research mode21222. **Audit type** — one of:23 - **Full site audit** — end-to-end SEO review covering all sections below24 - **Keyword research** — identify keyword opportunities for a topic or domain25 - **Content gap analysis** — find topics competitors rank for that you don't26 - **Technical SEO check** — crawlability, speed, structured data, and infrastructure issues27 - **Competitor SEO comparison** — head-to-head SEO benchmarking against specific competitors2829 If not specified, default to **full site audit**.30313. **Target keywords or topics** (optional) — specific keywords the user is already targeting or wants to rank for32334. **Competitors** (optional) — domains or companies to compare against. If not provided and the audit type requires competitor data, use web search to identify 2-3 likely competitors based on the user's domain and keyword space.3435## Process3637### 1. Keyword Research3839Research keywords related to the user's domain, topic, or target keywords.4041**If ~~SEO tools are connected:**42- Pull keyword data, search volume, keyword difficulty scores, and ranking positions automatically43- Identify keywords the site currently ranks for and where it's gaining or losing ground4445**If ~~product analytics are connected:**46- Cross-reference keyword targets with actual organic traffic data to validate which keywords are driving visits and conversions4748**If tools are not connected:**49- Use web search to research the keyword landscape50- Note: "For more precise volume and difficulty data, connect an SEO tool like Ahrefs or Semrush via MCP. The audit will auto-populate with ranking data."5152For each keyword opportunity, assess:53- **Primary keywords** — high-intent terms directly tied to the user's product or service54- **Secondary keywords** — supporting terms and variations55- **Search volume signals** — relative demand (high, medium, low) based on available data56- **Keyword difficulty** — how competitive the term is (easy, moderate, hard)57- **Long-tail opportunities** — specific, lower-competition phrases with clear intent58- **Question-based keywords** — "how to", "what is", "why does" queries that mirror People Also Ask results59- **Intent classification** — informational, navigational, commercial, or transactional6061### 2. On-Page SEO Audit6263For each key page (homepage, top landing pages, recent blog posts), evaluate:6465- **Title tags** — present, unique, within 50-60 characters, includes target keyword66- **Meta descriptions** — present, compelling, within 150-160 characters, includes a call to action67- **H1 tags** — exactly one per page, includes primary keyword68- **H2/H3 structure** — logical hierarchy, uses secondary keywords where natural69- **Keyword usage** — primary keyword appears in the first 100 words, used naturally throughout, not over-stuffed70- **Internal linking** — pages link to related content, orphan pages identified, anchor text is descriptive71- **Image alt text** — all images have descriptive alt attributes, keywords included where relevant72- **URL structure** — clean, readable, includes keywords, no excessive parameters or depth7374### 3. Content Gap Analysis7576Identify what's missing from the user's content strategy:7778- **Competitor topic coverage** — topics and keywords competitors rank for that the user's site does not cover79- **Content freshness** — pages that haven't been updated in 12+ months and may be losing rankings80- **Thin content** — pages with insufficient depth to rank (under 300 words for informational queries, lacking substance)81- **Missing content types** — formats competitors use that the user doesn't (guides, comparison pages, glossaries, tools, templates)82- **Funnel gaps** — missing content at specific buyer journey stages (awareness, consideration, decision)83- **Topic clusters** — opportunities to build pillar pages with supporting content8485### 4. Technical SEO Checklist8687Evaluate technical foundations that affect crawlability and rankings:8889- **Page speed** — identify slow-loading pages and likely causes (large images, render-blocking scripts, excessive redirects)90- **Mobile-friendliness** — responsive design, tap targets, font sizes, viewport configuration91- **Structured data** — opportunities for schema markup (FAQ, HowTo, Product, Article, Organization, Breadcrumb)92- **Crawlability** — robots.txt configuration, XML sitemap presence and accuracy, canonical tags, noindex/nofollow usage93- **Broken links** — internal and external 404s, redirect chains94- **HTTPS** — secure connection, mixed content issues95- **Core Web Vitals signals** — LCP, FID/INP, CLS indicators based on observable page behavior96- **Indexation** — pages that should be indexed but may not be, duplicate content risks9798### 5. Competitor SEO Comparison99100For each competitor, compare:101102- **Keyword overlap** — keywords both sites rank for, and where each site ranks higher103- **Keyword gaps** — terms the competitor ranks for that the user does not104- **Domain authority signals** — relative site strength based on backlink profiles, referring domains, and content depth105- **Content depth** — average content length, topic coverage breadth, publishing frequency106- **Backlink profile observations** — types of sites linking to competitors, link-worthy content they've produced107- **SERP feature ownership** — which competitor appears in featured snippets, People Also Ask, image packs, or knowledge panels108- **Technical advantages** — site speed differences, mobile experience, structured data usage109110## Output111112### Executive Summary113114Open with a 3-5 sentence summary of overall SEO health. Highlight:115- The site's biggest strength116- The top 3 priorities that will have the most impact117- An overall assessment: strong foundation, needs work, or critical issues118119### Keyword Opportunity Table120121| Keyword | Est. Difficulty | Opportunity Score | Current Ranking | Intent | Recommended Content Type |122|---------|----------------|-------------------|-----------------|--------|--------------------------|123124Opportunity score: high, medium, or low — based on the combination of search demand, difficulty, and relevance to the user's business.125126Include 15-25 keyword opportunities, sorted by opportunity score.127128### On-Page Issues Table129130| Page | Issue | Severity | Recommended Fix |131|------|-------|----------|-----------------|132133Severity levels:134- **Critical** — directly hurting rankings or preventing indexation135- **High** — significant impact on SEO performance136- **Medium** — best practice violation, moderate impact137- **Low** — minor optimization opportunity138139### Content Gap Recommendations140141For each content gap identified, provide:142- **Topic or keyword** to target143- **Why it matters** — search demand, competitor coverage, funnel stage144- **Recommended format** — blog post, landing page, guide, comparison page, etc.145- **Priority** — high, medium, or low146- **Estimated effort** — quick win (1-2 hours), moderate (half day), substantial (multi-day)147148### Technical SEO Checklist149150| Check | Status | Details |151|-------|--------|---------|152153Status: Pass, Fail, or Warning.154155### Competitor Comparison Summary156157| Dimension | Your Site | Competitor A | Competitor B | Winner |158|-----------|-----------|--------------|--------------|--------|159160Include rows for: keyword count, content depth, publishing frequency, backlink signals, technical score, SERP feature presence.161162### Prioritized Action Plan163164Split recommendations into two categories:165166**Quick Wins (do this week):**167- Actions that take under 2 hours and have immediate impact168- Examples: fix title tags, add meta descriptions, fix broken links, add alt text169170**Strategic Investments (plan for this quarter):**171- Actions that require more effort but drive long-term growth172- Examples: build a topic cluster, create a pillar page, launch a link-building campaign, overhaul site structure173174For each action item, include:175- What to do (specific and concrete)176- Expected impact (high, medium, low)177- Effort estimate178- Dependencies (if any)179180## Follow-Up181182After presenting the audit, ask:183184"Would you like me to:185- Draft content briefs for the top keyword opportunities?186- Create optimized title tags and meta descriptions for your key pages?187- Build a content calendar based on the gap analysis?188- Dive deeper into any specific section of the audit?189- Run this same analysis for a different competitor or domain?"