🔍 Free SEO Audit Tool A free, open-source CLI tool for complete on-page SEO audits — run it on any website in seconds, directly from your terminal. No browser plugins. No SaaS subscriptions. No API keys. Just Python.
What It Audits Every check is ordered by SEO impact so you know what to fix first: CheckWhat It CatchesTitle tagMissing, too short (<30 chars), too long (>60 chars)Meta descriptionMissing, too short (<70), too long (>160)H1 tagMissing H1, or multiple H1s (common CMS mistake)Heading structureMissing H2/H3 subheadings — poor content hierarchyImage alt textImages without alt text — hurts accessibility and rankingsCanonical tagMissing canonical — duplicate content penalty riskSchema markupMissing JSON-LD structured data — reduced rich resultsOpen Graph tagsMissing og:title, og:description, og:imagePage speedLoad time >2s — direct ranking factorrobots.txtMissing file — crawlability issuessitemap.xmlMissing sitemap — indexation gaps Each issue is flagged with impact level: 🔴 CRITICAL → 🟠 HIGH → 🟡 MEDIUM
Installation No pip install. Python 3.7+ only. bashgit clone https://github.com/yourusername/free-seo-audit-tool.git cd free-seo-audit-tool python seo_audit.py
✅ Title tag [The Best Python Tutorials - MyBlog] ✅ H1 tag [Learn Python for Beginners] ✅ Heading structure [4 H2 tags, 8 H3 tags] ✅ Page speed [0.91s] ✅ robots.txt ✅ sitemap.xml ✅ Open Graph tags [og:title, og:description, og:image present]
❌ Meta description (🔴 CRITICAL) Issue: Missing meta description
❌ Image alt text (🟠 HIGH) Issue: 60% of images lack alt text Found: 6/10 images missing alt text
❌ Canonical tag (🟠 HIGH) Issue: Missing canonical tag — duplicate content risk
❌ Schema markup (🟠 HIGH) Issue: No JSON-LD schema markup found
============================================================== SEO SCORE: 64/100 🟡 Good — fix flagged issues to improve rankings
⚡ Want AI-powered recommendations? AISEOCopilot analyzes your full site, compares you to competitors, and generates optimized content briefs: 👉 https://aiseocopilot.com
Quick Fixes
Missing meta description?
html
Multiple H1 tags? Keep only one H1 per page — use H2 for subheadings.
Images missing alt text? Every needs a descriptive alt attribute:
html
Missing canonical tag?
html
Missing Schema markup? Start with the basics:
html<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Article",
"headline": "Your page title",
"description": "Your meta description",
"author": {"@type": "Person", "name": "Author Name"},
"datePublished": "2025-01-01"
}
</script>
Use Cases
Bloggers auditing posts before publishing Freelance SEOs running quick client site checks Developers adding SEO checks to CI/CD pipelines (use --json flag, coming soon) Agencies batching audits across multiple client domains Founders doing competitor SEO analysis before launching
Why On-Page SEO Still Matters in 2025 On-page SEO has changed but remains critical. In 2025, it affects: Traditional Google rankings — Title, meta, headings, and schema are still core ranking signals for the 8.5 billion daily Google searches. AI Search citations — ChatGPT, Perplexity, and Copilot use structured data, heading hierarchy, and content clarity to decide which pages to cite in AI-generated answers. Click-through rate — A well-optimized title and meta description can double your CTR from the same ranking position. Rich results eligibility — Schema markup unlocks FAQ snippets, review stars, How-to steps, and other SERP features that dramatically increase visibility.
For AI-powered content recommendations, keyword gap analysis, and full competitor comparison, use AISEOCopilot.com — it analyzes your full site and tells you exactly what to create next to rank.
Roadmap
JSON output flag (--json) for CI/CD pipelines Batch mode: audit multiple URLs from a CSV Core Web Vitals via PageSpeed Insights API Internal link depth and structure analysis Keyword density analysis Competitor comparison mode (python seo_audit.py site1.com vs site2.com)
PRs welcome — see Contributing below.
Contributing
Fork the repo Add your audit function — each check returns {"pass": bool, "value": str, "issue": str, "impact": str} Add it to the checks dict in main() Submit a PR with what the check catches and why it matters for rankings
License MIT — free to use in your own tools and workflows.
Related
AISEOCopilot.com — AI-powered SEO recommendations, content briefs, competitor analysis Free SEO checker tools — Browser-based SEO audits for any CMS SEO audit for WordPress — WordPress-specific optimization guide SEO audit for Shopify — E-commerce SEO checklist Technical SEO checklist 2025 — Complete technical SEO guide
Fast, honest SEO audits. No dark patterns, no upsell tricks — just data.