Skip to content
RAY BEHARRY

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

InputRequiredFrom
Intent sheet and target keywordYesSearch Intent Analyst
Approved message kernelsYesMessage Memory
Valid ProofIDsYesProof Vault
Voice card and banned phrasesYesBrand Voice Memory
Current page content or URLOptionalYou

How it works

  1. Read the intent sheet and the current page; list what the page already does well and what it misses for the intent.
  2. Draft a title and meta description that lead with the buyer outcome in canon language and include the primary keyword naturally.
  3. Restructure headings so they answer the questions observed in the results, using approved kernels for each section.
  4. Insert proof only from proof-vault with its ProofID; decision-stage claims without a ProofID are removed.
  5. Add internal links to and from related priority pages and suggest schema type when it fits the page.
  6. Tag the page with narrative, persona, stage and ProofIDs per the data contracts, then run `python3 scripts/sns.py proof check <brief.md>`.
  7. 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

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.