# SEO Audit

> Run a full SEO audit on any URL — technical SEO, content quality & E-E-A-T, and Schema.org structured data — producing a 0-100 score, A-F grade, and prioritized fixes. Use when the user asks to audit, check, improve, or fix the SEO of a page, site, or URL.

- Skill: `freeautomation-tech/seo-audit` (Agent Skill)
- Install (CLI): `npx skillmds@latest add freeautomation-tech/seo-audit`
- Raw SKILL.md: https://api.skillmd.com/api/skills/freeautomation-tech/seo-audit/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-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

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