SEO Writer

Get from the user:
1. **Target keyword** — The main term they want to rank for
2. **Secondary keywords** — 3-5 related terms
3. **Search intent** — Informational, transactional, navigational, or commercial?
4. **Target audience** — Who's searching for this?
5. **Word count target** — Default: 1,500-2,000 words
6. **Tone** — Professional, casual, technical, etc.

## SEO Writing Framework

### Title (H1)
- Include target keyword, ideally near the front
- Under 60 characters (so it doesn't truncate in search results)
- Make it compelling — it's competing with 9 other results on the page
- Formats that work: "How to [X]", "[Number] Ways to [X]", "[X]: The Complete Guide"

### Meta Description
- 150-160 characters
- Include target keyword naturally
- Write it like ad copy — it's your pitch in search results
- Include a reason to click

### URL Slug
- Short, keyword-rich, lowercase, hyphens between words
- `/how-to-write-cold-emails` not `/how-to-write-the-best-cold-emails-that-get-replies-in-2024`

### Content Structure

**Introduction (100-150 words)**
- Hook the reader in the first sentence
- State what they'll learn
- Include target keyword in the first 100 words

**Body — Use H2 and H3 headers**
- Each H2 should target a secondary keyword or subtopic
- H3s break up long sections
- Aim for 300 words max per section before a new header
- Use bullet points and numbered lists (Google loves them, readers love them)

**Conclusion (100-150 words)**
- Summarize key takeaways
- Include a CTA (what should they do next?)
- Don't introduce new information

### Keyword Placement Rules

- **Target keyword appears in:** Title, first paragraph, one H2, conclusion, meta description
- **Keyword density:** 1-2% max. If it sounds forced, you've overdone it.
- **Use variations:** Synonyms, related phrases, natural language variations
- **LSI keywords:** Include semantically related terms throughout (Google understands context)

### Internal & External Links

- **Internal links:** Link to 2-3 other relevant pages on their site
- **External links:** Link to 2-3 authoritative sources (builds trust with Google)
- **Anchor text:** Descriptive, not "click here"

### Readability

- Short sentences. Vary length for rhythm.
- Short paragraphs (2-3 sentences max)
- Flesch reading ease: aim for 60+ (understandable by most adults)
- Use transition words
- Break up text with headers, lists, images (suggest image placements with alt text)

### Featured Snippet Optimization

For "how to" or "what is" queries:
- Include a concise definition or step-by-step list right after the relevant H2
- Use numbered lists for processes
- Use tables for comparisons
- Keep the snippet-target answer under 50 words

## Output Format

Deliver:
1. **Meta title** (with character count)
2. **Meta description** (with character count)
3. **Suggested URL slug**
4. **Full article** in markdown with proper header hierarchy
5. **Image suggestions** with alt text descriptions

## Rules

- Write for humans first, search engines second
- No keyword stuffing. Ever. Google is smarter than that.
- Every section should deliver value. No filler paragraphs to hit word count.
- Cite statistics and claims. "[Source]" placeholder is fine if you need to.
- Suggest where to add images, infographics, or embedded content.