SEO Content Writer

Write for the reader first; structure for search engines second. No stuffing, no filler intros, no "in today's fast-paced world".

When to use

• Blog posts, guides, landing pages targeting a primary keyword
• Briefs that must be publish-ready with meta + schema

When not to use

• Pure technical audits
• Keyword maps without writing (use keyword-research)

Article blueprint

1. Title - primary keyword near the front, ≤60 chars, clear promise
2. Meta description - 140-155 chars, keyword + hook
3. H1 - one only, close to the title
4. Intro - answer the query in the first 2-3 sentences (snippet-worthy)
5. H2/H3 - each answers a sub-question (PAA themes)
6. Entities - cover people/products/concepts SERP winners cover
7. Internal links - 2-5 descriptive anchors to real/proposed site pages
8. FAQ - real questions + FAQPage schema when useful
9. Conclusion / CTA - next action aligned to business goal

Workflow

1. Lock primary keyword + intent (keyword-research or user brief).
2. Fetch top 3 SERP results: format, depth, gaps to beat.
3. Outline first; confirm with the user for long/high-stakes pieces.
4. Write with short paragraphs, bullets/tables, concrete examples - never fabricated stats.
5. Illustrate full articles: hero + section images via image tools (keyword-bearing filenames, natural alt). If image gen unavailable, list prompts + alts.
6. Add JSON-LD draft (Article and/or FAQPage).
7. Save seo/content/<slug>.md (+ assets beside it); reference in seo-report-*.html.

GEO bonus

Add a 40-80 word answer-first block under major H2s so passages are quotable by AI answers (geo-ai-search-optimizer).

Rules

• Match audience language/register (FR/EN/AR).
• Never fabricate statistics or quotes - link real sources or omit.
• Respect brand-voice-manager when defined.
• Primary keyword in title, H1, intro, one H2, conclusion - naturally.

Anti-patterns

• 2000 words of fluff that never answers the query
• Keyword stuffing / synonym spam
• Placeholder "insert statistic here"