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:
Product Recommendations
- Context-aware product suggestions
- Price comparisons
- Feature highlights
Strategic Link Placement
- Above-fold for high-CTR products
- In-product comparison sections
- Call-to-action paragraphs
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
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. 🔮
1---2name: seo-article-gen3description: SEO-optimized article generator with automatic affiliate link integration. Generate high-ranking content with keyword research, structured data, and monetization built-in.4---5
6# SEO-Article-Gen - SEO-Optimized Content Generator
7
8**Generate ranking content with affiliate monetization built-in.**
9
10## Overview
11
12SEO-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.
13
14## Features
15
16### ✅ Keyword Research
17- Find low-competition, high-volume keywords
18- Analyze search intent (informational, transactional, navigational)
19- Get keyword difficulty scores
20- Find related questions (People Also Ask)
21- Generate long-tail keyword variations
22
23### ✅ AI-Powered Writing
24- Generate full articles from keywords
25- Natural language optimization
26- Proper heading structure (H1, H2, H3)
27- Readable, engaging content
28- Word count optimization (1,500-2,500 words)
29
30### ✅ SEO Optimization
31- Optimized title tags & meta descriptions
32- Proper URL slug generation
33- Image alt text suggestions
34- Internal link suggestions
35- External link opportunities
36- Schema markup (Article, FAQ, HowTo)
37
38### ✅ Affiliate Integration
39- Automatic affiliate link insertion
40- Context-aware product recommendations
41- FTC-compliant disclosures
42- Link optimization for CTR
43- Revenue tracking ready
44
45### ✅ Content Templates
46- Product reviews
47- How-to guides
48- Comparison articles
49- Listicles ("Top 10 X")
50- Ultimate guides
51- Case studies
52
53## Installation
54
55```bash
56clawhub install seo-article-gen
57```
58
59## Quick Start
60
61### Generate an Article
62
63```javascript
64const article = await generateArticle({
65 keyword: "best wireless headphones 2026",
66 type: "product-review",
67 wordCount: 2000,
68 affiliate: true,
69 network: "amazon"
70});
71
72console.log(article);
73```
74
75### Keyword Research
76
77```javascript
78const keywords = await findKeywords({
79 seed: "wireless headphones",
80 intent: "transactional",
81 difficulty: "low",
82 volume: 500
83});
84
85// Returns: [
86// { keyword: "best wireless headphones for gaming", volume: 1200, difficulty: 15 },
87// { keyword: "budget wireless noise cancelling", volume: 800, difficulty: 12 }
88// ]
89```
90
91## Tool Functions
92
93### `generateArticle`
94Generate a full SEO-optimized article.
95
96**Parameters:**
97- `keyword` (string, required): Target keyword
98- `type` (string): Article type (product-review, how-to, comparison, listicle)
99- `wordCount` (number): Target word count (default: 2000)
100- `affiliate` (boolean): Insert affiliate links (default: true)
101- `network` (string): Affiliate network to use
102- `includeImages` (boolean): Generate image suggestions
103
104**Returns:**
105- Title, meta description, URL slug
106- Full article content with headings
107- Keyword density report
108- Affiliate links inserted
109- Schema markup (JSON-LD)
110- SEO score
111
112### `findKeywords`
113Research keywords for content opportunities.
114
115**Parameters:**
116- `seed` (string, required): Seed keyword
117- `intent` (string): Filter by intent (informational, transactional, navigational)
118- `difficulty` (string): Filter by difficulty (low, medium, high)
119- `volume` (number): Minimum search volume
120- `limit` (number): Maximum results (default: 20)
121
122**Returns:**
123- Array of keyword objects with volume, difficulty, CPC data
124
125### `optimizeContent`
126Optimize existing content for SEO.
127
128**Parameters:**
129- `content` (string, required): Content to optimize
130- `keyword` (string, required): Target keyword
131- `options` (object):
132 - `addStructure` (boolean): Add proper headings
133 - `addMeta` (boolean): Generate title/meta
134 - `addInternalLinks` (boolean): Suggest internal links
135
136**Returns:**
137- Optimized content
138- SEO improvement suggestions
139- Before/after comparison
140
141### `generateSchema`
142Generate structured data markup.
143
144**Parameters:**
145- `type` (string, required): Schema type (Article, FAQ, HowTo, Product)
146- `content` (object, required): Content data
147
148**Returns:**
149- JSON-LD schema markup
150- Validation results
151
152### `analyzeCompetitors`
153Analyze top-ranking competitors for a keyword.
154
155**Parameters:**
156- `keyword` (string, required): Target keyword
157- `topN` (number): Number of competitors (default: 5)
158
159**Returns:**
160- Competitor URLs
161- Word count analysis
162- Heading structure
163- Common keywords
164- Content gaps to exploit
165
166## Use Cases
167
168### Product Review Articles
169Generate comprehensive product reviews with affiliate links:
170- Pros/cons sections
171- Comparison tables
172- Buying guides
173- User testimonials
174
175### How-To Guides
176Create helpful how-to content that ranks:
177- Step-by-step instructions
178- Expert tips
179- Required tools/products (affiliate links)
180- Common mistakes
181
182### Listicles
183Generate "Best X for Y" articles:
184- Product recommendations
185- Comparison tables
186- Pricing info
187- Affiliate links for each item
188
189### Case Studies
190Build authority with real examples:
191- Before/after results
192- Methodology explained
193- Tools used (monetized)
194- Expert quotes
195
196## Article Structure
197
198All generated articles follow SEO best practices:
199
200```
201H1: Optimized Title
202- Meta Description (155-160 chars)
203- Featured Image Alt Text
204
205H2: Introduction
206- Hook paragraph
207- Problem statement
208- What readers will learn
209
210H2: [Main Content Section]
211- In-depth explanation
212- Bullet points for readability
213- Statistics/data where applicable
214
215H2: [Affiliate Product Recommendation]
216- Product description
217- Key features
218- Pros/cons
219- CTA with affiliate link
220- FTC disclosure
221
222H2: Comparison (optional)
223- Side-by-side comparison
224- Pricing table
225- Use cases
226
227H2: FAQ
228- 5-7 common questions
229- Concise answers
230- Schema markup
231
232H2: Conclusion
233- Key takeaways
234- Final recommendation
235- CTA
236
237Schema: Article + FAQ
238```
239
240## SEO Score Calculation
241
242Generated articles are scored on:
243
244- **Title Optimization** (20pts): Keyword placement, length, appeal
245- **Meta Description** (15pts): Keyword inclusion, CTR potential
246- **Heading Structure** (15pts): H2/H3 hierarchy, keyword usage
247- **Content Quality** (25pts): Readability, depth, originality
248- **Keyword Usage** (15pts): Density, natural placement
249- **Internal/External Links** (5pts): Link placement, relevance
250- **Schema Markup** (5pts): Proper JSON-LD implementation
251
252**Score Guide:**
253- 90-100: Excellent (likely to rank)
254- 80-89: Good (minor improvements needed)
255- 70-79: Decent (needs optimization)
256- <70: Poor (significant improvements needed)
257
258## Affiliate Integration
259
260Articles automatically include:
261
2621. **Product Recommendations**
263 - Context-aware product suggestions
264 - Price comparisons
265 - Feature highlights
266
2672. **Strategic Link Placement**
268 - Above-fold for high-CTR products
269 - In-product comparison sections
270 - Call-to-action paragraphs
271
2723. **FTC Disclosures**
273 - Automatic disclosure injection
274 - Platform-appropriate placement
275 - Compliant with FTC guidelines
276
277## Pricing
278
279- **Free**: 5 articles/month (1,500 words max)
280- **Pro ($15/month)**: 50 articles, full features
281- **Unlimited ($49/month)**: Unlimited articles, API access, priority generation
282
283## Roadmap
284
285- [ ] Integration with SEO tools (Ahrefs, SEMrush, Moz)
286- [ ] Auto-publishing to CMS (WordPress, Ghost, Medium)
287- [ ] Multi-language support
288- [ ] Image generation (DALL-E, Midjourney)
289- [ ] Content scheduling
290- [ ] Team collaboration features
291
292## Best Practices
293
294### Keyword Selection
295- Target long-tail keywords with low difficulty
296- Match search intent with article type
297- Balance volume vs. competition
298
299### Content Quality
300- Write for humans first, search engines second
301- Use natural language, avoid keyword stuffing
302- Include original insights, not just summaries
303- Update regularly to stay fresh
304
305### Affiliate Links
306- Don't over-link (3-5 per 2,000 words)
307- Make links contextually relevant
308- Add value, don't just monetize
309- Always disclose clearly
310
311## License
312
313MIT
314
315---
316
317**Generate ranking content. Monetize automatically.** 🔮