SEO Technical

Technical SEO

Focused technical audit. Checks on-page HTML signals plus robots.txt / sitemap health for a domain.

Procedure

1. Fetch and parse the page, then run the technical audit:

   from seo_kit.crawler.page_fetcher import fetch_page, parse_html
   from seo_kit.technical.audit import run_technical_audit
   from seo_kit.technical.hreflang import run_hreflang_check
   
   _, html, _, _ = fetch_page("<url>")
   page = parse_html(html, "<url>")
   result = run_technical_audit(page)
   for f in result.findings:
       print(f.severity.value, "|", f.title, "|", f.recommendation)
   

2. Check site-level crawlability (robots.txt + XML sitemap):

   python -m seo_kit.crawler.sitemap "<url>"
   

   or from Python:

   from seo_kit.crawler.sitemap import run_sitemap_check
   print(run_sitemap_check("<url>").to_dict())
   

3. Report the findings in severity order and offer to apply fixes.

What it checks

• Title tag (missing / too short / too long)
• Meta description (missing / too long)
• Canonical tag, H1 count and content
• noindex in meta robots
• Viewport tag (mobile usability)
• Image alt-text coverage
• Internal vs external link counts
• Thin content (<200 words)
• lang attribute, favicon, hreflang links
• robots.txt reachability and sitemap declaration
• XML sitemap parsing and entry count

Notes

• run_sitemap_check needs network access and a reachable robots.txt.
• Inspired by AgriciDaniel/claude-seo and seranking/seo-skills (both MIT).