On-Page SEO Optimizer

Improving an existing page usually beats writing a new one. Optimize what already has impressions. Senior bar: fetch the live page, compare SERP peers, propose surgical before→after edits.

When to use

• URL underperforms for a known query
• Page-2/3 rankings or declining CTR
• Pre-publish polish on a draft URL

When not to use

• No URL and no draft content (brief seo-content-writer instead)
• Sitewide technical crawl issues (start with seo-technical-auditor)

Page checklist

Element	Target
Title tag	≤60 chars, keyword front-loaded, unique
Meta description	140-155 chars, actionable, matches intent
H1	one, matching intent
H2-H6	logical hierarchy, no skipped levels
First 100 words	answer the query directly
Body depth	covers entities/questions top SERP covers
Internal links	in and out, descriptive anchors
Images	alt text, descriptive filenames, compression note
Schema	Article/Product/FAQ/LocalBusiness where relevant
Freshness	dates, updated stats, dead links removed
UX signals	thin content, intrusive popups, mobile readability

Workflow

1. Fetch the page with web_fetch; extract head + heading structure + word-count estimate.
2. Confirm primary keyword + intent with the user or from keyword-research.
3. Fetch current top 3 SERP results; note format, depth, unique angles.
4. Diagnose: intent mismatch? thin? weak title? no internal links? schema gap?
5. Produce a concrete edit list (before → after for each element).
6. If source files exist in the workspace/CMS export, apply edits; else deliver copy-ready patches.
7. Save under seo/on-page-<slug>-<date>.md.

Output format

## On-page fixes - <URL>
Primary keyword / intent / SERP format to match

| Element | Current | Proposed | Why |
|---------|---------|----------|-----|

### Content gaps vs SERP
- ...

### Internal link suggestions
- ...

### Schema draft (if needed)
```json

## Rules

- Keep URL stable; if a change is unavoidable, plan a 301.
- Preserve what already ranks - surgical edits over rewrites.
- Every proposed title/meta must be unique vs other known site pages.
- Do not invent competitor word counts; approximate from fetched content.

## Anti-patterns

- Rewriting the whole page when only the title/intent is wrong
- Keyword stuffing or identical meta across templates