SEO Site Audit
Transform website-level SEO into an engineering-executable task backlog.
Outputs
- Executive Summary — Top findings with P0/P1/P2 priorities
- Assumptions & Inputs — What URLs/templates were analyzed
- Findings by Theme — Organized P0→P1→P2 with example URLs
- Engineering Backlog — Actionable task table (see templates/site-backlog-template.md)
- Implementation Notes — Where fixes should land (layout, route, middleware, CMS, build)
- Validation & Rollout Plan — Pre-launch checks and 7-day monitoring
When to Use
- "Audit my website for SEO"
- "Technical SEO review"
- "Site-wide audit / improve indexing"
- Mentions: robots.txt, sitemap, canonical, redirects, 404s, soft 404s
- Mentions: meta tags, Open Graph, Twitter cards, JSON-LD structured data
- Mentions: internal linking, information architecture, hub-pillar, orphan pages
- Mentions: Core Web Vitals, performance, mobile, accessibility
Not Applicable (Use seo-article-optimizer Instead)
- Single article or landing page content optimization (keywords, readability, meta/slug)
Required Inputs
- Site type: SaaS / Content site / E-commerce / Documentation / Other
- Tech stack: Next.js / Nuxt / WordPress / Webflow / Static / Other
- Target language & region: zh-CN/en/multilingual; hreflang needed?
- URL samples (at least one of):
- sitemap.xml
- Route list / exported URL list
- Key site pages (>= 10 URLs)
- Business goal: Lead gen (signup/demo/trial) / E-commerce / Brand awareness; plus 1-3 most important conversion page URLs
If user cannot provide URL list or sitemap: Only deliver "principle-based recommendations + required information checklist". Do NOT pretend to complete an audit.
Priority Levels
- P0 (Critical): Blocks indexing or causes major SEO damage
- P1 (High): Significant impact on rankings or user experience
- P2 (Medium): Optimization opportunities for improvement
Common P0 Issues (Development Environment Leaks)
These often survive from dev/staging to production:
| Issue | Where to Check |
| -------------------------------- | ---------------------- |
| noindex, nofollow meta tag | <head> section |
| robots.txt blocking all crawlers | /robots.txt |
| Staging URLs in sitemap | sitemap.xml |
| Debug/preview modes enabled | CMS settings, env vars |
Quality Gates
- No vague advice (e.g., "improve meta") — must give specific fix + validation method
- No assumptions about sitemap/robots/schema existence without verification
- Must produce actionable backlog with priority ranking
Workflow
For detailed audit methodology, see workflow.md.
Summary:
- Build Page Type Model (bucket by template/page type)
- P0: Indexability & Canonicalization
- P1: Site-level Meta & Share Assets (Meta/OG/Twitter)
- P1: Structured Data (JSON-LD / schema.org)
- P1: Information Architecture & Internal Linking
- P2: Performance, Mobile, Accessibility
Troubleshooting
| Issue | Solution | | -------------------------- | ------------------------------------------------ | | Cannot access site | Ask user to provide HTML source or exported data | | No sitemap available | Request URL list or route export | | Missing required inputs | List specific missing items before proceeding | | Site behind authentication | Ask for public pages or static exports |
Supporting Files
For detailed information, read these files when needed:
- Detailed workflow steps: workflow.md
- Implementation snippets & reference: reference.md
- Output templates: See templates/