SEO-Article-Gen - SEO-Optimized Content Generator

Generate ranking content with affiliate monetization built-in.

Overview

SEO-Article-Gen creates SEO-optimized articles that actually rank. It combines keyword research, AI writing, structured data generation, and automatic affiliate link insertion - all in one tool.

Features

✅ Keyword Research

• Find low-competition, high-volume keywords
• Analyze search intent (informational, transactional, navigational)
• Get keyword difficulty scores
• Find related questions (People Also Ask)
• Generate long-tail keyword variations

✅ AI-Powered Writing

• Generate full articles from keywords
• Natural language optimization
• Proper heading structure (H1, H2, H3)
• Readable, engaging content
• Word count optimization (1,500-2,500 words)

✅ SEO Optimization

• Optimized title tags & meta descriptions
• Proper URL slug generation
• Image alt text suggestions
• Internal link suggestions
• External link opportunities
• Schema markup (Article, FAQ, HowTo)

✅ Affiliate Integration

• Automatic affiliate link insertion
• Context-aware product recommendations
• FTC-compliant disclosures
• Link optimization for CTR
• Revenue tracking ready

✅ Content Templates

• Product reviews
• How-to guides
• Comparison articles
• Listicles ("Top 10 X")
• Ultimate guides
• Case studies

Installation

clawhub install seo-article-gen

Quick Start

Generate an Article

const article = await generateArticle({
  keyword: "best wireless headphones 2026",
  type: "product-review",
  wordCount: 2000,
  affiliate: true,
  network: "amazon"
});

console.log(article);

Keyword Research

const keywords = await findKeywords({
  seed: "wireless headphones",
  intent: "transactional",
  difficulty: "low",
  volume: 500
});

// Returns: [
//   { keyword: "best wireless headphones for gaming", volume: 1200, difficulty: 15 },
//   { keyword: "budget wireless noise cancelling", volume: 800, difficulty: 12 }
// ]

Tool Functions

generateArticle

Generate a full SEO-optimized article.

Parameters: - keyword (string, required): Target keyword - type (string): Article type (product-review, how-to, comparison, listicle) - wordCount (number): Target word count (default: 2000) - affiliate (boolean): Insert affiliate links (default: true) - network (string): Affiliate network to use - includeImages (boolean): Generate image suggestions

Returns: - Title, meta description, URL slug - Full article content with headings - Keyword density report - Affiliate links inserted - Schema markup (JSON-LD) - SEO score

findKeywords

Research keywords for content opportunities.

Parameters: - seed (string, required): Seed keyword - intent (string): Filter by intent (informational, transactional, navigational) - difficulty (string): Filter by difficulty (low, medium, high) - volume (number): Minimum search volume - limit (number): Maximum results (default: 20)

Returns: - Array of keyword objects with volume, difficulty, CPC data

optimizeContent

Optimize existing content for SEO.

Parameters: - content (string, required): Content to optimize - keyword (string, required): Target keyword - options (object): - addStructure (boolean): Add proper headings - addMeta (boolean): Generate title/meta - addInternalLinks (boolean): Suggest internal links

Returns: - Optimized content - SEO improvement suggestions - Before/after comparison

generateSchema

Generate structured data markup.

Parameters: - type (string, required): Schema type (Article, FAQ, HowTo, Product) - content (object, required): Content data

Returns: - JSON-LD schema markup - Validation results

analyzeCompetitors

Analyze top-ranking competitors for a keyword.

Parameters: - keyword (string, required): Target keyword - topN (number): Number of competitors (default: 5)

Returns: - Competitor URLs - Word count analysis - Heading structure - Common keywords - Content gaps to exploit

Use Cases

Product Review Articles

Generate comprehensive product reviews with affiliate links: - Pros/cons sections - Comparison tables - Buying guides - User testimonials

How-To Guides

Create helpful how-to content that ranks: - Step-by-step instructions - Expert tips - Required tools/products (affiliate links) - Common mistakes

Listicles

Generate "Best X for Y" articles: - Product recommendations - Comparison tables - Pricing info - Affiliate links for each item

Case Studies

Build authority with real examples: - Before/after results - Methodology explained - Tools used (monetized) - Expert quotes

Article Structure

All generated articles follow SEO best practices:

H1: Optimized Title
- Meta Description (155-160 chars)
- Featured Image Alt Text

H2: Introduction
- Hook paragraph
- Problem statement
- What readers will learn

H2: [Main Content Section]
- In-depth explanation
- Bullet points for readability
- Statistics/data where applicable

H2: [Affiliate Product Recommendation]
- Product description
- Key features
- Pros/cons
- CTA with affiliate link
- FTC disclosure

H2: Comparison (optional)
- Side-by-side comparison
- Pricing table
- Use cases

H2: FAQ
- 5-7 common questions
- Concise answers
- Schema markup

H2: Conclusion
- Key takeaways
- Final recommendation
- CTA

Schema: Article + FAQ

SEO Score Calculation

Generated articles are scored on:

• Title Optimization (20pts): Keyword placement, length, appeal
• Meta Description (15pts): Keyword inclusion, CTR potential
• Heading Structure (15pts): H2/H3 hierarchy, keyword usage
• Content Quality (25pts): Readability, depth, originality
• Keyword Usage (15pts): Density, natural placement
• Internal/External Links (5pts): Link placement, relevance
• Schema Markup (5pts): Proper JSON-LD implementation

Score Guide: - 90-100: Excellent (likely to rank) - 80-89: Good (minor improvements needed) - 70-79: Decent (needs optimization) - <70: Poor (significant improvements needed)

Affiliate Integration

Articles automatically include:

1. Product Recommendations

   • Context-aware product suggestions
   • Price comparisons
   • Feature highlights

2. Strategic Link Placement

   • Above-fold for high-CTR products
   • In-product comparison sections
   • Call-to-action paragraphs

3. FTC Disclosures

   • Automatic disclosure injection
   • Platform-appropriate placement
   • Compliant with FTC guidelines

Pricing

• Free: 5 articles/month (1,500 words max)
• Pro ($15/month): 50 articles, full features
• Unlimited ($49/month): Unlimited articles, API access, priority generation

Roadmap

• [ ] Integration with SEO tools (Ahrefs, SEMrush, Moz)
• [ ] Auto-publishing to CMS (WordPress, Ghost, Medium)
• [ ] Multi-language support
• [ ] Image generation (DALL-E, Midjourney)
• [ ] Content scheduling
• [ ] Team collaboration features

Best Practices

Keyword Selection

• Target long-tail keywords with low difficulty
• Match search intent with article type
• Balance volume vs. competition

Content Quality

• Write for humans first, search engines second
• Use natural language, avoid keyword stuffing
• Include original insights, not just summaries
• Update regularly to stay fresh

Affiliate Links

• Don't over-link (3-5 per 2,000 words)
• Make links contextually relevant
• Add value, don't just monetize
• Always disclose clearly

License

MIT

Generate ranking content. Monetize automatically. 🔮