Seo Audit

SEO Audit + AI Visibility

Search optimization audit with AI visibility signals. Finds issues AND fixes them.

Process

Phase 1: Scan

Run the SEO scanner on the project:

node ${CLAUDE_PLUGIN_ROOT}/tools/seo-scanner.mjs 

Parse the JSON output for findings and scores (seo, geo, aeo).

> Large sites: when a site has many pages and each needs page-specific fixes, escalate to a dynamic Workflow (describe the audit and include the word "workflow") so the scan-then-fix-then-verify pipeline runs across pages in parallel instead of one at a time.

Phase 2: Report

Present findings grouped by category with severity:

• SEO: meta tags, OG tags, headings, alt text, canonical, robots.txt, sitemap
• GEO: structured data, llms.txt, content structure for AI
• AEO: FAQPage schema, speakable markup, snippet optimization

Phase 3: Fix

For each finding, apply the appropriate fix:

SEO fixes (use Edit tool on HTML files):

• Missing title → add ` in `
• Missing meta description → add ``
• Missing OG tags → generate from page content
• Missing H1 → add appropriate heading
• Missing alt text → add descriptive alt attributes
• Missing canonical → add ``
• Missing sitemap → run: node ${CLAUDE_PLUGIN_ROOT}/tools/sitemap-generator.mjs
• Missing robots.txt → run: node ${CLAUDE_PLUGIN_ROOT}/tools/robots-generator.mjs
• Missing favicon → warn user to add one

GEO fixes:

• Missing llms.txt → run: node ${CLAUDE_PLUGIN_ROOT}/tools/llms-txt-generator.mjs
• Missing structured data → run: node ${CLAUDE_PLUGIN_ROOT}/tools/structured-data-generator.mjs --type=
• Improve content structure: add clear headings, FAQ sections, definitive statements

AEO fixes:

• Missing JSON-LD → generate appropriate schema type
• Missing FAQ schema → create FAQPage structured data from page content
• Snippet optimization → restructure key answers to 40-60 words

Phase 4: Search Engine Registration (GSC + Bing)

Google Search Console (requires ULTRASHIPGSCCREDENTIALS):

# Submit sitemap
node ${CLAUDE_PLUGIN_ROOT}/tools/gsc-client.mjs submit-sitemap  

# Check if pages are indexed
node ${CLAUDE_PLUGIN_ROOT}/tools/gsc-client.mjs inspect-url  

# See what keywords you rank for
node ${CLAUDE_PLUGIN_ROOT}/tools/gsc-client.mjs query  28

# List all submitted sitemaps
node ${CLAUDE_PLUGIN_ROOT}/tools/gsc-client.mjs list-sitemaps 

Bing Webmaster Tools (requires ULTRASHIPBINGKEY):

# Submit sitemap (also powers DuckDuckGo + ChatGPT Search)
node ${CLAUDE_PLUGIN_ROOT}/tools/bing-webmaster.mjs submit-sitemap  

# Submit specific URLs for fast indexing
node ${CLAUDE_PLUGIN_ROOT}/tools/bing-webmaster.mjs submit-url  

# Batch submit multiple URLs
node ${CLAUDE_PLUGIN_ROOT}/tools/bing-webmaster.mjs submit-url-batch    ...

# Check URL traffic
node ${CLAUDE_PLUGIN_ROOT}/tools/bing-webmaster.mjs url-info  

If credentials are not set, show setup instructions from the tool's error output. Do NOT skip this phase — submitting sitemaps to both GSC and Bing is critical for indexing speed.

Why Bing matters for AI search: Bing's index powers ChatGPT Search, DuckDuckGo, and Yahoo. Submitting your sitemap to Bing directly improves AI search visibility.

Phase 4b: Content Quality Analysis

Run content scoring on all pages:

node ${CLAUDE_PLUGIN_ROOT}/tools/content-scorer.mjs 

For pages with a known target keyword:

node ${CLAUDE_PLUGIN_ROOT}/tools/content-scorer.mjs  --keyword=

Report readability scores (Flesch-Kincaid), keyword density, thin content, and GEO heading optimization.

Phase 4c: Social Preview Validation

Validate Open Graph tags and image accessibility:

node ${CLAUDE_PLUGIN_ROOT}/tools/og-validator.mjs 

Fix missing OG tags, broken OG images, and oversized preview images.

Phase 4d: Redirect Audit

If a production URL is available, check for redirect chains:

node ${CLAUDE_PLUGIN_ROOT}/tools/redirect-checker.mjs --sitemap=

Fix redirect chains (consolidate to single hop), convert 302s to 301s, and resolve mixed HTTP/HTTPS.

Phase 5: Verify

Re-run the scanner to confirm fixes and report before/after scores.

Save scores for historical comparison:

node ${CLAUDE_PLUGIN_ROOT}/tools/audit-history.mjs save  seo 
node ${CLAUDE_PLUGIN_ROOT}/tools/audit-history.mjs save  geo 
node ${CLAUDE_PLUGIN_ROOT}/tools/audit-history.mjs save  aeo 

Phase 6: AI Search Content Strategy

After technical fixes, advise on content-level optimizations that the scanner cannot automate:

GEO Content Patterns (for AI citation):

• Rewrite key H2 headers as questions: "What is [topic]", "How does [feature] work", "Why use [product]"
• Add 1-2 sentence TL;DR summaries under important H2 sections — AI engines extract these as standalone answers
• Use plain-language definitions before introducing nuance: "[Product] is [clear definition]"
• Write in citation-ready format: concise, factual, quotable — avoid vague marketing copy
• Create comparison tables, statistics pages, and glossaries — these are the most-cited page formats by AI

E-E-A-T Signals (for AI trust):

• Add Author/Person schema with credentials, role, and expertise
• Include first-hand experience statements: "We tested", "In our experience", "Based on [N] customers"
• Add original visuals, screenshots, and data — AI cannot synthesize these, so they prove authenticity
• Ensure author bios establish subject-matter relevance on every content page

AI Bot Access:

• Verify robots.txt explicitly allows GPTBot (ChatGPT), PerplexityBot, and Claude-Web
• Block Google-Extended and CCBot only if you want to prevent AI training (not citation)

Citation-Worthy Page Formats:

• Ultimate guides consolidating a topic into one authoritative resource
• "[Topic] Statistics (2026)" pages centralizing referenceable data
• "Best [Category] Tools Compared" with explicit comparison tables
• FAQ pages with direct, quotable answers (not marketing fluff)

Key test: "If your content can't answer a question clearly in 30 seconds, AI engines won't select it for generated answers."

Phase 7: Content Audit Framework

For SEO specialists working on client sites, provide a content audit after the technical scan:

Content Health Assessment:

• Flag pages with 100 links from spam sites.

1. Broken link building — find broken links on competitor sites, offer your content as replacement.
2. HARO/Qwoted/Featured — respond to journalist queries to earn media mentions with backlinks.
3. Competitor backlink analysis — use Ahrefs/Semrush free trials to find where competitors get links, then target the same sources.
4. Strategic partnerships — co-create content with complementary businesses, cross-link naturally.

What NOT to do:

• Never buy links (Google penalizes this)
• Never use PBNs (private blog networks)
• Never spam forum/comment links
• Never use automated link building tools

Domain Authority Monitoring (guidance for user):

• Check DA/DR monthly via free Ahrefs Webmaster Tools or Moz free tier
• Track referring domains, not just total backlinks (10 links from 10 domains > 100 links from 1 domain)
• Monitor for toxic backlinks quarterly and disavow via GSC if needed

Key Principle

Fix, don't just audit. Every finding should have a concrete fix applied. Every content page should have a strategy to be cited by AI. Every client engagement should include technical fixes + content audit + backlink strategy.

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: Houseofmvps
• Source: Houseofmvps/ultraship
• License: MIT
• Homepage: https://www.npmjs.com/package/ultraship

Install and usage instructions live in the source repository linked above.