Technical SEO Auditor - AI-Powered On-Page Analysis

Audit 50+ SEO ranking factors with AI recommendations by John Rippy | johnrippy.link

---

What This Actor Does

The Technical SEO Auditor performs comprehensive on-page SEO analysis:

1. Meta Tag Analysis - Title, description, OG tags, Twitter cards
2. Heading Structure - H1-H6 hierarchy and keyword presence
3. Image Optimization - Alt tags, file sizes, lazy loading
4. Link Analysis - Internal/external links, broken links, nofollow
5. Structured Data - JSON-LD validation, Schema.org markup
6. Core Web Vitals - LCP, FID, CLS estimates
7. Mobile Friendliness - Viewport, touch targets, responsive design
8. Content Analysis - Word count, keyword density, readability

---

Why Use This Actor?

The Problem with Manual Audits

SEO audits typically require:

• Multiple tools (Screaming Frog, Lighthouse, Schema validators)
• Manual data compilation and analysis
• Subjective interpretation of results

AI-Powered Intelligence

This actor provides:

• Unified Score (0-100) - Single metric combining all factors
• Prioritized Issues - Sorted by SEO impact
• AI Recommendations - Context-aware suggestions
• Competitor Comparison - Benchmark against industry standards

---

Use Cases

1. Client Onboarding Audits

Run comprehensive audits for new SEO clients to identify quick wins.

2. Pre-Launch Technical Review

Ensure new sites meet all SEO requirements before going live.

3. Competitor Analysis

Compare your technical SEO against competitors.

4. Ongoing Monitoring

Schedule regular audits to catch regressions early.

---

Quick Start Examples

Example 1: Single Page Audit

{
  "url": "https://example.com",
  "includeAIRecommendations": true
}

Example 2: Multi-Page Crawl

{
  "url": "https://example.com",
  "crawlDepth": 2,
  "maxPages": 20,
  "checkStructuredData": true,
  "checkAccessibility": true
}

Example 3: Demo Mode (Free Testing)

{
  "demoMode": true
}

Example 4: With AI Enhancement (BYOK)

{
  "url": "https://example.com",
  "includeAIRecommendations": true,
  "anthropicApiKey": "sk-ant-..."
}

---

Input Parameters

Parameter	Type	Required	Default	Description
demoMode	boolean	No	false	Run with sample data (free, no crawling)
url	string	No*	-	Single URL to audit
urls	array	No*	-	Array of URLs to audit
crawlDepth	integer	No	1	How deep to crawl (1-5)
maxPages	integer	No	10	Max pages per URL (1-100)
checkMobile	boolean	No	true	Test mobile friendliness
checkStructuredData	boolean	No	true	Validate JSON-LD
checkAccessibility	boolean	No	true	Basic a11y checks
includeAIRecommendations	boolean	No	true	Generate AI recommendations
anthropicApiKey	string	No	-	BYOK for enhanced AI
webhookUrl	string	No	-	Webhook for integrations

*Either url or urls required unless using demoMode

---

Output Format

{
  "url": "https://example.com",
  "timestamp": "2024-12-25T12:00:00.000Z",
  "overallScore": 78,

  "meta": {
    "title": "Example Domain - Your Title Here",
    "titleLength": 28,
    "titleScore": 85,
    "description": "This is the meta description...",
    "descriptionLength": 142,
    "descriptionScore": 90,
    "hasCanonical": true,
    "canonicalUrl": "https://example.com/",
    "hasRobots": true,
    "robotsContent": "index, follow"
  },

  "headings": {
    "h1Count": 1,
    "h1Text": ["Main Heading"],
    "h2Count": 5,
    "headingHierarchyValid": true,
    "score": 95
  },

  "images": {
    "total": 12,
    "withAlt": 10,
    "withoutAlt": 2,
    "lazyLoaded": 8,
    "oversized": 1,
    "score": 75
  },

  "links": {
    "internal": 24,
    "external": 8,
    "nofollow": 3,
    "broken": 0,
    "score": 100
  },

  "structuredData": {
    "hasJsonLd": true,
    "types": ["Organization", "WebPage"],
    "errors": [],
    "warnings": ["Missing 'logo' property"],
    "score": 85
  },

  "performance": {
    "lcpEstimate": "2.1s",
    "clsEstimate": "0.05",
    "domSize": 1245,
    "resourceCount": 34,
    "score": 72
  },

  "mobile": {
    "hasViewport": true,
    "viewportContent": "width=device-width, initial-scale=1",
    "touchTargetsAdequate": true,
    "fontSizeAdequate": true,
    "score": 95
  },

  "content": {
    "wordCount": 1250,
    "paragraphCount": 15,
    "readabilityScore": 68,
    "hasKeywordInTitle": true,
    "hasKeywordInH1": true,
    "score": 80
  },

  "issues": [
    {
      "severity": "high",
      "category": "images",
      "issue": "2 images missing alt text",
      "recommendation": "Add descriptive alt text to images",
      "affectedElements": ["img.hero-image", "img.product-photo"]
    }
  ],

  "recommendations": [
    {
      "priority": 1,
      "category": "images",
      "issue": "Missing alt text on 2 images",
      "recommendation": "Add descriptive alt text that includes relevant keywords",
      "impact": "medium",
      "effort": "low"
    }
  ]
}

---

Scoring System

The actor calculates scores (0-100) for each category:

Category	Weight	Factors
Meta Tags	20%	Title, description, canonical, OG tags
Headings	15%	H1 presence, hierarchy, keyword usage
Images	15%	Alt text, lazy loading, file sizes
Links	15%	Internal links, broken links, nofollow
Structured Data	10%	JSON-LD presence, validation
Performance	15%	DOM size, resource count, estimates
Mobile	10%	Viewport, touch targets, fonts

---

AI Recommendations

Without Anthropic API Key

Uses rule-based recommendations based on:

• Industry best practices
• Common SEO issues
• Priority scoring by impact

With Anthropic API Key (BYOK)

Enhanced analysis using Claude to:

• Identify nuanced issues
• Provide context-aware suggestions
• Prioritize by business impact
• Generate custom action items

---

Webhook Integration

Webhook Payload

{
  "event": "technical_seo_audit_complete",
  "timestamp": "2024-12-25T12:00:00.000Z",
  "actor": "technical-seo-auditor",
  "status": "success",
  "pagesAudited": 10,
  "avgScore": 78,
  "results": [...]
}

---

Perfect For

SEO Agencies

• Client onboarding audits
• Monthly technical reviews
• Competitor benchmarking

Web Developers

• Pre-launch checklists
• CI/CD integration
• Technical debt tracking

Marketing Teams

• Campaign landing page audits
• Content optimization
• Performance monitoring

---

Pricing

• Demo Mode: Free (sample data)
• Standard Usage: Apify compute units only
• AI Recommendations: Rule-based free, Claude BYOK for enhanced

---

Related Actors

• PageSpeed Intelligence - Performance + Tech Stack analysis
• Robots.txt Checker - Crawl directive validation
• Sitemap Generator - XML sitemap creation

---

Built by John Rippy | johnrippy.link

---

Keywords

technical seo audit, on-page seo, meta tags analyzer, heading structure, image optimization, alt text checker, broken link checker, structured data validator, schema.org, json-ld, core web vitals, mobile friendly test, seo score, ai recommendations, website crawler, seo analysis tool