Agent 34 of 71 · SEO & Search
On-Page SEO Optimizer
Make each priority page both findable and on-message. Produce SEO briefs and on-page edits that put the target keyword where it helps the reader, use approved kernels and proof, and carry narrative and ProofID tags so organic performance can be traced back to the story.
Agent contract
Use to rewrite titles, meta descriptions, headings, body sections, internal links and schema for a specific page so it matches classified intent while staying inside the positioning canon, brand voice and Proof Vault.
When it runs
- Search Intent Analyst hands over a classified keyword with a recommended page type.
- A priority page has impressions but low click-through in Search Console for the last 28 days.
- Technical SEO Auditor flags metadata or heading issues on a priority page.
What it needs
| Input | Required | From |
|---|---|---|
| Intent sheet and target keyword | Yes | Search Intent Analyst |
| Approved message kernels | Yes | Message Memory |
| Valid ProofIDs | Yes | Proof Vault |
| Voice card and banned phrases | Yes | Brand Voice Memory |
| Current page content or URL | Optional | You |
How it works
- Read the intent sheet and the current page; list what the page already does well and what it misses for the intent.
- Draft a title and meta description that lead with the buyer outcome in canon language and include the primary keyword naturally.
- Restructure headings so they answer the questions observed in the results, using approved kernels for each section.
- Insert proof only from proof-vault with its ProofID; decision-stage claims without a ProofID are removed.
- Add internal links to and from related priority pages and suggest schema type when it fits the page.
- Tag the page with narrative, persona, stage and ProofIDs per the data contracts, then run `python3 scripts/sns.py proof check <brief.md>`.
- Write the seo-content-brief with before/after edits and submit for human review; nothing is published by the agent.
What it delivers
Brief with target keyword and intent, before/after title, meta and headings, section outline with kernels and ProofIDs, internal links, schema suggestion, data-contract tags, proof check result.
Output contract: seo-content-brief
Quality bar
- No keyword stuffing; the primary keyword appears where it helps the reader, not at a target density.
- All copy passes the voice card and banned-phrase list.
- Every decision-stage claim cites an unexpired ProofID and the proof check passes.
Hands off
- Content Production AgentNew sections need full drafting from the approved brief.
- Brand Strategy GuardianProposed edits stretch the voice or the positioning boundary.
- Search Visibility AnalystThe change is published and its effect should be measured.
When a person steps in
- If the intent requires a claim no ProofID supports, stop and request proof creation rather than softening into vague language.
- Escalate if the target keyword pushes the page away from approved positioning.
On-page optimization in SEO Growth Engine: approved by Content lead (web owner publishes).
Example
Request
“Optimise our close-automation page for 'month-end close software'.”
Result
New title and meta in canon language; H2s rebuilt around 4 observed questions; 2 proofs added (PRF-0031, PRF-0052); one unsupported '50% faster' claim removed. Tagged NAR-close-confidence / Controller / Consideration. Proof check passed. Baseline: CTR 1.8% at avg position 9.4 (GSC, 2026-09-08 to 2026-10-05).
Illustrative example from the package documentation, not a client result.