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)
• \x3C70: 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. 🔮