- `$ARGUMENTS[0]` = Target keyword or topic (or "batch" for multiple)
- `$ARGUMENTS[1]` = Word count (default: 1,500)
- For batch mode, provide a file with one keyword per line

## Content Generation Pipeline

### Phase 1: Keyword Intelligence

For the target keyword `$ARGUMENTS[0]`:

1. **Search the keyword** to understand current SERP landscape
2. **Identify**:
   - Search intent (informational, transactional, navigational, commercial)
   - Content format that ranks (listicle, how-to, comparison, guide, review)
   - Average word count of top 5 results
   - Common subtopics and questions covered
   - Related keywords and LSI terms
3. **Generate a keyword cluster**:
   - Primary keyword
   - 3-5 secondary keywords
   - 5-10 long-tail variations
   - 3-5 related questions (People Also Ask style)

### Phase 2: Competitor Content Analysis

Analyze top 5 SERP results for the target keyword:

1. **Content gaps**: What do ALL top results miss? This is our opportunity.
2. **Common structure**: How are they organized? (H2/H3 patterns)
3. **Unique angles**: What perspective hasn't been covered?
4. **Content freshness**: Are top results outdated? Can we provide 2026 data?
5. **Backlink bait**: What makes content in this niche linkable?

### Phase 3: Content Architecture

Build the article structure BEFORE writing:

### Phase 4: Content Writing

Write the article following these SEO content rules:

**Keyword Placement** (non-negotiable):
- Primary keyword in: title, H1, first 100 words, 1-2 H2s, last 100 words, meta description
- Keyword density: 1-2% (natural, never forced)
- Secondary keywords: 1-2 uses each, spread throughout
- Long-tail variations: use naturally in body and H3s

**Readability**:
- Flesch-Kincaid grade level: 6-8 (accessible to all readers)
- Sentences: max 20 words average
- Paragraphs: max 3-4 sentences
- Use bullet points and numbered lists liberally
- Include a table or comparison if the topic allows
- Break up text with H2 every 200-300 words

**Engagement**:
- Open with a hook (statistic, question, bold claim)
- Use "you" and "your" throughout (conversational tone)
- Include specific numbers and data points
- Add actionable takeaways (not just information)
- End sections with transitions to the next

**E-E-A-T Signals** (Experience, Expertise, Authoritativeness, Trustworthiness):
- Include first-person experience markers ("In my experience...", "When I tested...")
- Reference specific tools, processes, or methodologies by name
- Cite statistics with implied sources
- Provide nuanced opinions, not just generic advice

### Phase 5: On-Page SEO Elements

Generate these alongside the article:

**Internal linking suggestions**: 3-5 recommended internal link anchor texts and target topics
**External linking suggestions**: 2-3 authoritative sources to cite
**Image suggestions**: 3-5 image descriptions with recommended alt text containing keywords
**Schema markup**: Provide appropriate schema (Article, FAQ, HowTo) in JSON-LD format

### Phase 6: Output Format

Deliver the final article in TWO formats:

1. **Clean Markdown** — for CMS systems, Ghost, Hugo, Jekyll
2. **WordPress-ready HTML** — with proper heading tags, schema markup embedded, and meta tags as HTML comments at the top

/seo-content-factory "best project management tools for freelancers" 2000
/seo-content-factory "how to start a dropshipping business"
/seo-content-factory batch keywords.txt

Title: [Primary keyword + compelling modifier]
Meta Description: [150-160 chars, includes primary keyword, has CTA]
URL Slug: [primary-keyword-short-form]

H1: [Title]
  Introduction (100-150 words)
    - Hook with statistic or question
    - Promise what the reader will learn
    - Include primary keyword naturally

  H2: [Section based on search intent]
    H3: [Subsection]
    H3: [Subsection]

  H2: [Section covering competitor gap]
    H3: [Subsection]

  H2: [Unique angle section]

  H2: [FAQ section - from People Also Ask]
    H3: [Question 1]
    H3: [Question 2]
    H3: [Question 3]

  Conclusion (100-150 words)
    - Summarize key takeaways
    - Clear CTA

title_tag: "[Primary Keyword] - [Modifier] | [Brand]" (50-60 chars)
meta_description: "[Benefit statement with primary keyword and CTA]" (150-160 chars)
url_slug: "[primary-keyword]"
primary_keyword: "[keyword]"
secondary_keywords: ["kw1", "kw2", "kw3"]
word_count: [actual count]
reading_time: "[X] min read"
content_type: "[listicle|how-to|guide|comparison|review]"
search_intent: "[informational|transactional|commercial|navigational]"

<!-- SEO Meta
Title: [title tag]
Description: [meta description]
Slug: [url-slug]
Keywords: [primary], [secondary1], [secondary2]
-->

<article>
  <h1>...</h1>
  ...
</article>

<script type="application/ld+json">
{schema markup}
</script>