A Python CLI toolkit with three purpose-built tools for technical SEO analysis and responsive optimization. Used on every project before deployment to catch issues early and ensure quality standards.
The SEO & Mobile Toolkit is a collection of three Python CLI tools that automate the tedious parts of web quality assurance. Rather than manually checking every page for SEO compliance and responsive issues, these tools scan entire sites and generate actionable reports.
Each tool serves a different purpose in the development workflow: seo-scan.py for quick technical checks on individual URLs, seo-audit.py for comprehensive multi-page site audits, and mobile-optimize.py for identifying and fixing responsive design issues across breakpoints.
Quick technical SEO scanner for individual URLs. Checks title tags, meta descriptions, headings, image alt text, Open Graph tags, canonical URLs, and more. Returns a pass/fail checklist with specific recommendations.
python seo-scan.py https://example.com Comprehensive site-wide SEO audit tool. Scans all HTML files in a local directory against a 15-point checklist including JSON-LD structured data, hreflang tags, sitemap validation, and cross-page consistency checks.
python seo-audit.py /path/to/site https://example.com Responsive optimization tool that scans HTML files and injects mobile-friendly improvements. Adds responsive meta tags, touch-friendly navigation, and mobile breakpoint styles where missing.
python mobile-optimize.py /path/to/site The three tools form a pipeline that covers the full development-to-deployment cycle. During active development, seo-scan.py runs against individual URLs to validate changes in real time — checking that a new page has proper title length, valid Open Graph tags, and correct canonical URLs before any other pages are affected. It's the quick-check tool that runs in under a second and gives immediate feedback on a single page.
Before a site goes live or after a batch of changes, seo-audit.py takes over with a full directory scan. It walks every HTML file in a project, running the same 15-point checklist across all pages simultaneously. This catches cross-page issues that single-URL scans miss: duplicate titles across different pages, inconsistent hreflang implementations between language versions, missing JSON-LD on pages that should have it, and sitemap URLs that don't match actual file paths. The output is a ranked report that separates critical failures from warnings, so the most damaging issues get fixed first.
Mobile-optimize.py handles the responsive side of quality assurance. It scans HTML files for common mobile-unfriendly patterns — missing viewport meta tags, fixed-width containers, touch targets that are too small, and navigation that doesn't collapse properly below 900px. Where possible, it injects fixes directly into the HTML. For static sites built without a CSS framework, this tool can add responsive breakpoint styles and mobile navigation patterns in a single pass, saving significant manual work on projects with dozens of pages.