seowebchecker-seoaudit-sdk
A lightweight, high-performance, open-source Python client SDK and CLI tool for instant website SEO audits, on-page analysis, Core Web Vitals checks, and technical SEO diagnostics.
Developed and maintained by SEOWebChecker.com — the free website audit and SEO diagnostic suite.
⚡ Highlights
- Zero-Config Standalone Auditing: Audit live URLs or raw HTML strings instantly without requiring external API keys.
- 50+ SEO Checks Across 7 Categories:
- Meta & Header Tags:
<title>,<meta description>,<link rel="canonical">,<meta robots>,<meta viewport>, charset, and lang. - Content & Structure: Single
<h1>enforcement,<h2>/<h3>hierarchy, word count, reading time estimation, and keyword density. - Hyperlink Quality: Internal vs external link distribution, empty anchor detection, generic anchor warnings ("click here"), and secure
target="_blank"validation. - Image SEO & Accessibility: Missing
alttags, emptyaltattributes, format breakdowns, and next-gen image format adoption (WebP, AVIF, SVG). - Social Graph & Cards: OpenGraph tags (
og:title,og:image,og:description,og:url) and Twitter Cards. - Technical & Security: HTTPS verification, HSTS enforcement, MIME-sniffing protection (
X-Content-Type-Options), clickjacking defenses,robots.txt, andsitemap.xmldetection. - Performance Signals: Response time / TTFB, HTML payload weight, and server-side text compression (Gzip/Brotli).
- Structured Data: JSON-LD schema parsing and Microdata type detection.
- Meta & Header Tags:
- CI/CD Quality Gate: Set
--min-score 85to fail deployment builds if regressions occur. - Multiple Output Formats: Terminal ANSI colors, clean Markdown tables, JSON output, or standalone HTML dashboard report.
- Optional Cloud API Mode: Connect seamlessly with the SEOWebChecker Cloud API.
📦 Installation
Install via pip:
pip install seowebchecker-seoaudit-sdk
🚀 Quick Start
1. Python API
from seowebchecker_seoaudit import SEOAuditor
# Initialize auditor
auditor = SEOAuditor()
# Audit any website
result = auditor.audit("https://example.com")
# View overall score and letter grade (A+, A, B, C, D, F)
print(f"SEO Score: {result.score.overall}/100 (Grade: {result.score.grade})")
# Access category breakdown
for cat_name, cat in result.score.categories.items():
print(f"{cat_name.title()}: {cat.score}/100 ({cat.passed_count} passed, {cat.warning_count} warnings)")
# List critical issues
for error in result.errors:
print(f"[ERROR] {error.title}: {error.recommendation}")
# Export to formats
print(result.to_json())
markdown_report = result.to_dict()
2. Audit Raw HTML Directly (Unit Tests & Static Site Generators)
from seowebchecker_seoaudit import SEOAuditor
auditor = SEOAuditor()
html_content = """
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>Best Free SEO Audit Tool - SEOWebChecker</title>
<meta name="description" content="Audit your website SEO with 50+ real-time checks covering technical SEO, performance, mobile responsiveness, and meta tags.">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<link rel="canonical" href="https://seowebchecker.com">
</head>
<body>
<h1>Free SEO Audit & Analyzer</h1>
<p>Run comprehensive on-page audits with instant recommendations.</p>
</body>
</html>
"""
result = auditor.audit_html(html_content, url="https://seowebchecker.com")
print(f"Score: {result.score.overall}/100")
🖥️ Command-Line Interface (CLI)
The SDK installs a command-line tool seowebchecker-audit:
# Pretty terminal output
seowebchecker-audit https://example.com
# Generate a standalone responsive HTML dashboard
seowebchecker-audit https://example.com --format html --output report.html
# Export JSON for programmatic ingestion
seowebchecker-audit https://example.com --format json --output audit.json
# Export GitHub-compatible Markdown summary
seowebchecker-audit https://example.com --format markdown --output audit.md
# CI/CD Quality Gate (Exits with code 1 if score < 85)
seowebchecker-audit https://example.com --min-score 85
⚙️ CI/CD Pipeline Integration (GitHub Actions)
Add continuous SEO testing to your repository by adding .github/workflows/seo-audit.yml:
name: Continuous SEO Audit
on:
push:
branches: [main]
pull_request:
branches: [main]
jobs:
seo-check:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Set up Python
uses: actions/setup-python@v5
with:
python-version: "3.11"
- name: Install SDK
run: pip install seowebchecker-seoaudit-sdk
- name: Run SEO Audit Gate
run: |
seowebchecker-audit https://seowebchecker.com --min-score 85 --format markdown --output seo-report.md
- name: Archive SEO Report
if: always()
uses: actions/upload-artifact@v4
with:
name: seo-audit-report
path: seo-report.md
🌐 Official Web Platform
Need an in-depth web-based audit or visual reports? Visit SEOWebChecker.com:
📄 License
This project is licensed under the MIT License - see the LICENSE file for details.
1 maintainer
Release files for seowebchecker-seoaudit-sdk 1.0.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| seowebchecker_seoaudit_sdk-1.0.0.tar.gz | 33.3 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| seowebchecker_seoaudit_sdk-1.0.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 68.3 kB
Release files / seowebchecker_seoaudit_sdk-1.0.0.tar.gz
| Download URL | seowebchecker_seoaudit_sdk-1.0.0.tar.gz |
|---|---|
| Size | 33.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
11e38c40e0edce4f5faa7b5f2ab7f82fe544f0c45297310268d81d4522d452b5
|
|
BLAKE2b-256 checksum How to use checksums |
fd9904fb39528ee2885593e21e7cb39dc7547849e09d185fde60b38c65a752a2
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.7
|
Release files / seowebchecker_seoaudit_sdk-1.0.0-py3-none-any.whl
| Download URL | seowebchecker_seoaudit_sdk-1.0.0-py3-none-any.whl |
|---|---|
| Size | 35.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
28a1104326283fe22a15240ecba1a4b3425fad5090205dc0c34833d3e91ecc6d
|
|
BLAKE2b-256 checksum How to use checksums |
93c3b6857f82be4e94d7228a795f0af4abc1db16493f58d59924518dbe0f9c5c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.7
|
