SeoWebChecker

A lightweight Elixir client SDK and technical SEO audit engine for on-page meta tag validations, heading structure inspections, image accessibility checks, and Core Web Vitals diagnostics.

Installation

Add seowebchecker to your list of dependencies in mix.exs:

def deps do
  [
    {:seowebchecker, "~> 1.0.0"}
  ]
end

Then run:

mix deps.get

Usage

1. Audit Raw HTML String

html = """
<!DOCTYPE html>
<html lang="en">
<head>
    <title>High Ranking On-Page SEO Checklist & Guide</title>
    <meta name="description" content="Master technical on-page SEO, heading structure, and Core Web Vitals optimization with our comprehensive developer checklist.">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <link rel="canonical" href="https://example.com/guide">
    <meta property="og:title" content="High Ranking On-Page SEO Checklist">
    <meta property="og:image" content="https://example.com/og.jpg">
</head>
<body>
    <h1>On-Page Technical SEO Essentials</h1>
    <p>Optimize your website performance and search rankings.</p>
    <img src="chart.png" alt="SEO Traffic Growth Chart">
</body>
</html>
"""

result = SeoWebChecker.audit_html(html, url: "https://example.com/guide")

IO.puts("Overall Score: #{result.score.overall}/100 (Grade #{result.score.grade})")
IO.puts("Passed: #{result.passed_checks}/#{result.total_checks}")
IO.puts("Warnings: #{result.warnings}, Errors: #{result.errors}")

Enum.each(result.issues, fn issue ->
  IO.puts("  [#{String.upcase(to_string(issue.severity))}] #{issue.title}: #{issue.message}")
end)

2. Audit a Live Remote Website URL

{:ok, result} = SeoWebChecker.audit_url("https://example.com")
IO.puts("Audited URL: #{result.url}")
IO.puts("Score: #{result.score.overall}/100 (#{result.score.grade})")

Features

⚡ Zero Runtime Dependencies: Uses standard Elixir & Erlang OTP modules (:inets, :httpc, :ssl).
🔍 Core SEO Audits:
- Title tag presence & optimal character count (30-60 chars)
- Meta description presence & length validation (50-160 chars)
- Mobile viewport responsiveness configuration
- Canonical link tag detection
- Single primary <h1> heading validation
- Image accessibility (alt attribute coverage)
- OpenGraph social sharing meta tags (og:title, og:image)
📊 Scoring: Calculates standard weighted 0-100 numerical scores and letter grades (A-F).

Online Tools

Official Website: https://seowebchecker.com
Live Interactive SEO Auditing: Test live web pages at https://seowebchecker.com