SEO-Article-Gen

SEO-optimized article generator with automatic affiliate link integration. Generate high-ranking content with keyword research, structured data, and monetization built-in.

Security Scan

The skill's code and runtime instructions are coherent with its stated purpose (SEO article generation with affiliate link insertion); it reads a local config file but requests no unrelated credentials or system access.

Purpose & Capability

The skill's name/description (SEO article generation + affiliate integration) matches the provided SKILL.md, README, and index.js functionality: keyword research, article generation, schema, and affiliate-link placeholders. It only reads a local config.json for settings, which is appropriate for configurable behavior.

Instruction Scope

SKILL.md describes the same functions implemented in the code (generateArticle, findKeywords, optimizeContent, generateSchema, competitor analysis). The instructions do not ask the agent to read unrelated system files, environment variables, or exfiltrate data. The code does read its own config.json via fs, which is expected and documented.

Install Mechanism

No install spec is provided (instruction-only install via clawhub). There are local code files but no remote download/install steps, package dependencies, or extract-from-URL operations. This reduces supply-chain risk.

Credentials

The skill declares no required environment variables, credentials, or config paths beyond its own config.json. That is proportional to generating content and inserting affiliate links. There are no requests for unrelated secrets or cloud credentials.

Persistence & Privilege

always is false and the skill does not request permanent system presence or modify other skills. It only reads/writes within its own directory (reads config.json); no privileged actions are requested.

Assessment

This skill appears internally consistent and implements the advertised features, but you should still exercise normal caution because the source and homepage are unknown. Before installing or using: 1) Inspect the generateAffiliateData (or equivalent) function to confirm where affiliate links point and that no hard-coded affiliate IDs or remote tracking endpoints are embedded. 2) If you plan to use real affiliate IDs, prefer providing them explicitly via the local config (not hard-coded) and confirm the skill does not transmit them off-host. 3) Run the included test.js in a sandbox/local environment to verify behavior and outputs. 4) Ensure FTC disclosure and privacy practices meet your requirements (SKILL.md shows a disclosure but verify placement and accuracy). 5) If you need higher assurance, request the full untruncated source or a publisher/homepage and confirm the author identity before enabling in production.

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. 🔮