SEO Audit

7 steps · start to finish.

1. 1
   Step 1

   Environment Setup

   ▶

   # Verify required inputs
   SITE_URL="${SITE_URL:-}"
   if [ -z "$SITE_URL" ]; then
     echo "ERROR: SITE_URL parameter is required"
     exit 1
   fi
   
   # Confirm site is reachable
   HTTP_STATUS=$(curl -s -o /dev/null -w "%{http_code}" --max-time 15 "$SITE_URL")
   if [ "$HTTP_STATUS" != "200" ] && [ "$HTTP_STATUS" != "301" ] && [ "$HTTP_STATUS" != "302" ]; then
     echo "WARNING: $SITE_URL returned HTTP $HTTP_STATUS — proceed with caution"
   fi
   
   # Create output directory
   mkdir -p /app/results
   
   echo "Auditing: $SITE_URL"
   echo "HTTP status: $HTTP_STATUS"
   

   Check for product marketing context first: If .agents/product-marketing-context.md exists (or .claude/product-marketing-context.md in older setups), read it before asking questions. Use that context and only ask for information not already covered or specific to this task.

   Before proceeding, gather:

   1. Site Context

      • What type of site? (SaaS, e-commerce, blog, etc.)
      • What is the primary business goal for SEO?
      • What keywords/topics are priorities?

   2. Current State

      • Any known issues or concerns?
      • Current organic traffic level?
      • Recent changes or migrations?

   3. Scope

      • Full site audit or specific pages?
      • Technical + on-page, or one focus area?
      • Access to Google Search Console / analytics?

   ---

2. 2
   Step 2

   Technical SEO Audit

   ▶

   Work through the technical checklist in priority order. For each finding, record: issue, impact (High/Medium/Low), evidence, fix, and priority (1–5).

3. 3
   Step 3

   On-Page SEO Audit

   ▶

   Analyze key page types: homepage, top landing pages, representative blog/content posts.

4. 4
   Step 4

   Content Quality Assessment

   ▶

   **Experience:** First-hand experience demonstrated; original insights, data, or case studies present.

5. 5
   Step 5

   Common Issues by Site Type

   ▶

   Apply the checklist for the identified site type:

6. 6
   Step 6

   Iterate on Errors (max 3 rounds)

   ▶

   If any audit check is inconclusive or tool limitations blocked a finding:

7. 7
   Step 7

   Generate Audit Report

   ▶

   Compile all findings into the structured output files.