# SEO Technical

> Run technical SEO checks on a page or site — title, meta description, canonical, H1, robots noindex, viewport, image alt text, internal/external links, thin content, and robots.txt + sitemap health. Use when the user asks about technical or on-page SEO issues, crawling, indexation, or sitemaps.

- Skill: `freeautomation-tech/seo-technical` (Agent Skill)
- Install (CLI): `npx skillmds@latest add freeautomation-tech/seo-technical`
- Raw SKILL.md: https://api.skillmd.com/api/skills/freeautomation-tech/seo-technical/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Marketing & Growth
- Author: FreeAutomation-Tech (https://skillmd.com/u/freeautomation-tech)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/freeautomation-tech/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:

   ```python
   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):

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

   or from Python:

   ```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](https://github.com/AgriciDaniel/claude-seo)
  and [seranking/seo-skills](https://github.com/seranking/seo-skills) (both MIT).