seo-auditlisted

# SEO Audit Audit any URL for technical SEO, content quality & E-E-A-T, and structured data. Produces a **0-100 score**, an **A-F grade**, and **prioritized recommendations** (error → warning → info) you can hand straight to the user. ## Prerequisites ```bash pip install -r requirements.txt ``` (Or, if the repo is installed as a package: `pip install -e .`) ## Procedure 1. **Run the audit** for the target URL: ```bash python -m seo_kit.cli "<url>" --format json ``` Use `--format markdown` for a human-readable report, or `--output report.md` to save to a file. 2. **Read the output.** `overall_score` is the grade; `categories` holds `technical`, `content`, and `schema` scores; `recommendations` is the prioritized fix list. 3. **Summarize for the user**, ranked highest-severity first: - What the page does well (any `pass` findings / high sub-scores). - What is broken (errors) and what needs attention (warnings). - The concrete fix for each item. 4. **Offer to apply fixes.** Many fixes are in-page edits: - Missing/weak title or meta description → write a new one. - Missing H1 → propose one. - Images without alt → generate alt text from context. - No structured data → use the `seo-schema` skill. 5. **Re-run the audit** after changes to confirm the score improved. ## Notes - If the URL fails to load, the tool returns an error — report it and ask for a corrected URL. - For deeper checks (sitemap, hreflang, GEO) use the siblin