pyseoa

pyseoa

PyPI

🚀 Python SEO Analyzer — CLI, Library & Web 📦

pyseoa is a modern, thread‑ready Python toolkit for deep‑dive SEO audits.
Use it as a library, CLI tool, or integrate with FastAPI for web apps.

🔍 Features (v0.2.3)

  • ✅ Single & Batch Analysis
    • Run SEO checks on one or multiple URLs via crawl or direct URL
    • Smart internal link crawling and multithreading for performance
  • ⚙️ Feature Flags Easily enable or disable checks via bitflags:
    • Title, Meta description, H1, Image alts
    • Canonical, OpenGraph, Twitter meta
    • Robots.txt, Sitemap, Favicon
    • Accessibility hints, Structured Data (JSON‑LD), Mobile-friendliness
    • Keyword density (with custom allow/deny lists)
    • Hreflang, Meta‑robots, Web Vitals, AMP compliance
  • 📄 Exporters
    • JSON, CSV, Markdown
    • Fancy HTML report with styles
    • PDF (via FPDF)
    • Terminal summary
  • 🔄 Threaded Workflow
    • Multi-threaded crawling, analysis, and exporting
    • Optional progress bars via tqdm
  • 🐍 CLI Tool & API Support
    • Run via pyseo‑analyze CLI: 
      seo-analyze https://example.com --crawl --export html
    • Fully importable — works great with FastAPI, Flask, Streamlit, Dash, etc.

⚡ Install

pip install pyseoa
# or, specify version:
pip install pyseoa==0.2.3

🧾 Basic Library Example

from pyseoa import SmartBatchSEOAnalyzer

urls = ["https://example.com", "https://another.com"]
analyzer = SmartBatchSEOAnalyzer(urls, follow_links=True)
analyzer.run_batch_analysis()

# Save outputs
analyzer.exporters.json.export(analyzer.results)
analyzer.exporters.csv.export(analyzer.results)
analyzer.exporters.html.export(analyzer.results, output="report.html")

🏃‍♂️ CLI Usage

Analyze a single site:

seo-analyze https://example.com

Batch or crawled analysis:

seo-analyze --crawl --export html urls.txt

Run seo-analyze --help for full options list.

🧩 Integration with Web Apps

E.g. With FastAPI or Flask in your web project:

from fastapi import FastAPI, Form
from pyseoa import SmartBatchSEOAnalyzer

app = FastAPI()

@app.post("/analyze")
def analyze(url: str = Form(...), crawl: bool = Form(False)):
    analyzer = SmartBatchSEOAnalyzer([url], follow_links=crawl)
    analyzer.run_batch_analysis()
    return analyzer.results

🔧 Command-Line Installer

Install via Git:

git clone https://github.com/sempre76/pyseoa.git
cd pyseoa
pip install -e .

📦 What’s New in v0.2.x

  • Dynamic internal link crawling
  • Feature flags overhaul
  • New exporters: Markdown, PDF, Terminal
  • Multi-threaded pipelines with progress bars
  • Web integration: SmartBatchAnalyzer & FastAPI-ready

👥 Contributing

PRs welcome! Please check:

  • Code: pip install ., run basic analyzers
  • Tests: run under example projects or use CLI
  • Docs: update examples & feature flags in README

📜 License & Author

  • MIT License – see the LICENSE file
  • Maintained by masem – contact: contact@masem.at

🔗 Links