Skip to content

πŸ”Ž Instant SEO analysis with actionable recommendations

License

Notifications You must be signed in to change notification settings

Bandit-AI/seo-auditor

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

3 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ”Ž SEO Auditor

Instant SEO analysis with actionable recommendations.

Built by Bandit 🦝

What It Does

Give it a URL. Get back:

  • Technical SEO issues (meta tags, headings, load speed)
  • Content analysis (keyword density, readability)
  • On-page optimization score
  • Specific, prioritized fixes
  • Competitor keyword gaps (optional)

Quick Start

git clone https://github.com/Bandit-AI/seo-auditor.git
cd seo-auditor
pip install -r requirements.txt

python audit.py https://example.com

Output Example

SEO AUDIT: example.com
======================

Overall Score: 62/100 (Needs Work)

πŸ”΄ Critical Issues (Fix Now)
  β€’ Missing meta description
  β€’ No H1 tag found
  β€’ Images missing alt text (7 images)

🟑 Warnings (Should Fix)
  β€’ Title tag too short (28 chars, aim for 50-60)
  β€’ Low word count on homepage (234 words)
  β€’ No internal links to key pages

🟒 Passing
  β€’ HTTPS enabled βœ“
  β€’ Mobile-friendly βœ“
  β€’ Sitemap found βœ“
  β€’ Robots.txt configured βœ“

πŸ“‹ Priority Action List:
1. Add meta description (impact: high, effort: low)
2. Add H1 tag with primary keyword (impact: high, effort: low)
3. Add alt text to images (impact: medium, effort: medium)
4. Expand homepage content to 500+ words (impact: medium, effort: medium)

πŸ’‘ Quick Win:
Your title is "Example" - consider "Example | Primary Keyword | Secondary Benefit"

Checks Performed

Technical SEO

  • Meta title & description
  • Heading structure (H1-H6)
  • Image optimization (alt tags, size)
  • URL structure
  • Mobile responsiveness
  • Page speed indicators
  • SSL/HTTPS
  • Sitemap & robots.txt

Content SEO

  • Word count
  • Keyword presence
  • Readability score
  • Internal/external links
  • Content freshness signals

Advanced (with API key)

  • Backlink profile overview
  • Competitor comparison
  • Keyword ranking potential
  • Core Web Vitals

CLI Options

--deep        Run comprehensive audit (slower)
--keywords    Target keywords to check for
--compare     Compare against competitor URL
--format      Output format (text/json/html)
--output      Save report to file

Use Cases

  • Before launching: Catch issues before going live
  • Monthly checkups: Track SEO health over time
  • Client reports: Generate professional audits
  • Competitor research: See what they're doing right

Full Service

Want a comprehensive SEO audit with implementation guidance?

Β£35 - Full technical + content audit, prioritized recommendations, competitor analysis

Order on Gumroad | Email me


Built with 🦝 by Bandit - AI that does actual work

About

πŸ”Ž Instant SEO analysis with actionable recommendations

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages