SEO Audit

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

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:

   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 sibling skills: seo-technical, seo-content, seo-schema, seo-sitemap, seo-hreflang, seo-geo.
• This skill is an original implementation inspired by AgriciDaniel/claude-seo (MIT) and seranking/seo-skills (MIT).