BlogForge AI - Complete Usage Guide

🚀 Quick Start (5 Minutes)

Step 1: Add Your API Key (2 minutes)

1. Get a Free Gemini API Key:

   • Visit: https://makersuite.google.com/app/apikey
   • Sign in with Google
   • Click "Create API Key"
   • Copy the key (starts with "AIza...")

2. Add to BlogForge AI:

   • Navigate to Settings (sidebar)
   • Click API Keys tab
   • Select Provider: Gemini (Free - Recommended)
   • Paste your API key
   • Add a nickname (optional): "My Gemini Key"
   • Click Add API Key
   • ✅ You'll see it appear in the list as "Active"

Step 2: Generate Your First Article (2 minutes)

1. Navigate to Generate Content (sidebar)

2. Fill in basic information:

   • Topic: "How to Make Cold Brew Coffee at Home"
   • Target Keyword: "cold brew coffee"
   • Article Type: How-To Guide
   • Tone: Conversational
   • Word Count: 2000 (use slider)

3. Enable recommended features:

   • ✅ Hook
   • ✅ Stories & Examples
   • ✅ HTML Element
   • ✅ Citations

4. Click Generate SEO Content

5. Wait 30-60 seconds ⏱️

6. 🎉 Your article is ready! You'll be redirected to the article view.

Step 3: View & Export (1 minute)

1. In the article view:

   • Preview the beautiful formatted article
   • Click View HTML to see the source code
   • Click Copy HTML to copy to clipboard
   • Click Download to save as HTML file

2. Go to My Articles (sidebar) to see all your generated content

---

📚 Detailed Feature Guides

🎯 Competitor Analysis

Purpose: Create content that outranks your competitors by analyzing their top articles.

How to Use:

1. In Generate Content page, scroll to Competitor Analysis

2. Toggle Enable Competitor Analysis ON

3. Add 3-5 competitor URLs:

   https://competitor1.com/article-about-topic
   https://competitor2.com/best-coffee-methods
   https://competitor3.com/ultimate-guide
   

4. BlogForge AI will:

   • Extract their keywords
   • Analyze their content structure
   • Identify heading patterns
   • Calculate word counts
   • Find content gaps

5. Generate your article - it will automatically:

   • Cover all their topics
   • Add unique insights
   • Use better structure
   • Include more examples

Pro Tips:

• Use Google to find "top 5" results for your keyword
• Analyze articles from authority sites
• Look for recent articles (2024-2026)
• Mix different writing styles for inspiration

---

🔗 Internal Linking System

Purpose: Automatically add relevant internal links to boost SEO and user engagement.

Setup (One-time):

1. Go to Settings > Internal Links tab

2. Enter your sitemap URL:

   • Format: https://yourblog.com/sitemap.xml
   • Or: https://yourblog.com/sitemap_index.xml

3. Click Import Sitemap

4. Wait for import (1-3 minutes for typical sites)

5. ✅ Done! You'll see imported links in the list

Using Internal Links:

1. When generating an article, enable Internal Links toggle in Article Elements section

2. Enter a Target Keyword (important!)

3. BlogForge AI will:

   • Search your imported links
   • Find relevant matches
   • Add contextual internal links
   • Use descriptive anchor text

Example:

• Your sitemap has: "Ultimate Coffee Grinder Guide"
• You're writing about: "Cold Brew Coffee"
• AI will link to your grinder guide when discussing equipment

---

🌐 WordPress Publishing

Setup (One-time, 5 minutes):

1. Generate Application Password in WordPress:

   a. Login to WordPress Dashboard

   b. Navigate to: Users > Your Profile

   c. Scroll to Application Passwords section

   d. Enter Application Name: BlogForge AI

   e. Click Add New Application Password

   f. Copy the generated password (format: xxxx xxxx xxxx xxxx xxxx xxxx)

   ⚠️ Important: Save this password! You can't see it again.

2. Add WordPress Site in BlogForge AI:

   a. Go to Settings > WordPress tab

   b. Fill in the form:

   • Site Name: My Blog
   • WordPress URL: https://yourblog.com
   • Username: your-wordpress-username
   • Application Password: (paste the password from step 1)

   c. Click Test Connection to verify

   d. If successful (✅), click Add Site

Publishing Articles:

1. Generate or open an existing article

2. In article view, click Publish to WordPress

3. Choose options (if multiple sites configured)

4. ✅ Done! Your article is now on your WordPress site

5. Check the success message for the live URL

What Gets Published:

• ✅ Article title
• ✅ Full HTML content
• ✅ Meta description (as excerpt)
• ✅ URL slug
• ✅ Yoast SEO data (if plugin installed)
• ✅ Featured image (if generated)

---

🎭 Brand Voice

Purpose: Maintain consistent tone and style across all your articles.

Creating a Brand Voice:

1. Go to Settings > Brand Voice tab

2. Click Create Brand Voice

3. Fill in details:

   Example: Tech Startup

   • Name: Tech Startup Voice
   • Description: Innovative, data-driven, and forward-thinking
   • Characteristics:
     • Uses data and statistics
     • Focuses on ROI and business value
     • Speaks to decision-makers
     • Balances technical depth with accessibility
     • Includes real-world case studies
   • Tone: Professional

4. Click Add Brand Voice

Using Brand Voice:

1. When generating an article, you'll see Brand Voice & Knowledge section

2. Select your brand voice from dropdown

3. AI will:

   • Match the tone consistently
   • Use appropriate vocabulary
   • Follow the characteristics
   • Maintain brand personality

Pre-built Brand Voices:

• ✅ Default Professional (included)

---

📊 Article Types & When to Use

1️⃣ Informational Articles

Best For:

• How-to guides
• Educational content
• Industry explanations
• Concept breakdowns

Example Topics:

• "What is Content Marketing?"
• "How Does SEO Work in 2026?"
• "Understanding AI in Business"

Structure:

• Hook + TL;DR
• Introduction
• 8-12 main sections
• Practical examples
• FAQ
• Conclusion

---

2️⃣ Product Reviews

Best For:

• Single product analysis
• In-depth reviews
• Affiliate content
• Comparison with competitors

Example Topics:

• "Aeropress Coffee Maker Review"
• "iPhone 16 Pro: Complete Review"
• "Best Budget Laptop for 2026"

Structure:

• Executive summary
• Product overview
• Features analysis
• Performance testing
• Pros & Cons
• Who should buy
• Final verdict

---

3️⃣ Product Roundups

Best For:

• Multiple product comparisons
• "Best of" lists
• Buyer's guides
• Category comparisons

Example Topics:

• "Top 10 Coffee Makers of 2026"
• "Best Budget Smartphones Under $500"
• "7 Best Project Management Tools"

Structure:

• Methodology
• Comparison table
• Individual reviews
• Best for scenarios
• Buying guide
• Recommendations

---

4️⃣ How-To Guides

Best For:

• Step-by-step tutorials
• Process documentation
• DIY projects
• Skill building

Example Topics:

• "How to Make Cold Brew Coffee"
• "Complete Guide to Setting Up WordPress"
• "How to Create a Content Calendar"

Structure:

• Introduction
• Prerequisites
• Step-by-step instructions
• Tips & tricks
• Troubleshooting
• Best practices

---

5️⃣ Listicles

Best For:

• Quick tips
• Resource lists
• Tool recommendations
• Idea collections

Example Topics:

• "15 Content Marketing Tips for 2026"
• "10 Must-Have SEO Tools"
• "25 Creative Blog Post Ideas"

Structure:

• Introduction
• List preview
• Detailed list items
• Bonus items
• FAQ
• Conclusion

---

🎨 Article Elements Explained

🪝 Hook

What it does: Creates an attention-grabbing opening that makes readers want to continue.

When to use: Always! First impressions matter.

Examples:

• "Did you know that 90% of content gets zero traffic from Google?"
• "Imagine waking up to 10,000 new visitors on your blog..."
• "What if I told you there's a coffee brewing method that takes 12 hours but tastes amazing?"

---

👤 First Person

What it does: Uses "I" or "We" perspective instead of third person.

When to use:

• Personal blogs
• Opinion pieces
• Experience-based content
• Building trust and connection

Example:

• ❌ Third Person: "One should consider these factors..."
• ✅ First Person: "I've found that these factors make a huge difference..."

---

📖 Stories & Examples

What it does: Adds real-world case studies, anecdotes, and concrete examples.

When to use:

• Complex topics that need illustration
• Building credibility
• Making content memorable
• Engaging readers emotionally

Example:

• Abstract: "Email marketing is effective"
• With Story: "Last year, I helped a client increase their revenue by 300% using simple email automation. Here's how..."

---

🧮 HTML Elements

What it does: Adds interactive widgets like tables, accordions, callouts, and progress bars.

When to use:

• Product comparisons
• Feature breakdowns
• Important notices
• Ratings and scores

Available Elements:

1. Comparison Tables: Side-by-side product comparisons
2. Callout Boxes: Highlight important info (tips, warnings, success)
3. FAQ Accordions: Expandable Q&A sections
4. Progress Bars: Visual ratings (8.5/10)

Custom Instructions:

• Specify placement: "Put widget at the bottom"
• Style preferences: "Don't use emojis in tables"
• Avoid conflicts: "No checkmarks, they clash with my theme"

---

📚 Citations

What it does: Adds formal references, statistics sources, and expert quotes.

When to use:

• Data-driven content
• Scientific/medical topics
• Building authority
• E-E-A-T optimization

Example:

• "According to a 2026 study by Content Marketing Institute, 72% of marketers report increased engagement..."

---

🔗 Internal Links

What it does: Automatically suggests and adds relevant internal links from your sitemap.

When to use: ALWAYS! Internal linking is crucial for SEO.

Benefits:

• Improves site structure
• Distributes page authority
• Increases page views
• Reduces bounce rate
• Helps Google understand your site

---

🎯 Advanced Workflows

Workflow 1: Complete Blog Post Creation

1. Research (5 minutes):

   • Google your target keyword
   • Copy top 5 competitor URLs
   • Note common topics they cover

2. Generate (2 minutes):

   • Enter topic and keyword
   • Enable competitor analysis
   • Add competitor URLs
   • Select article type
   • Enable all article elements
   • Set word count: 2500

3. Review (5 minutes):

   • Read the generated article
   • Check for accuracy
   • Verify links work
   • Review SEO metadata

4. Publish (2 minutes):

   • Add featured image (optional)
   • Publish to WordPress
   • Share on social media

Total Time: ~15 minutes for a 2500-word SEO-optimized article!

---

Workflow 2: Bulk Content Creation

1. Prepare Topics (10 minutes):

   • List 10-20 article topics
   • Find target keywords
   • Note article types

2. Generate in Batches (30 minutes):

   • Generate 5 articles
   • Use different tones for variety
   • Enable relevant features

3. Schedule Publishing (20 minutes):

   • Review all articles
   • Schedule 2-3 per week
   • Plan social promotion

Result: Month's worth of content in 1 hour!

---

Workflow 3: Competitor Domination

1. Identify Target (10 minutes):

   • Choose keyword to dominate
   • Find top 5 ranking articles
   • Analyze their approach

2. Deep Analysis (5 minutes):

   • Use competitor analysis feature
   • Note content gaps
   • Identify unique angles

3. Create Superior Content (10 minutes):

   • Generate 3000+ word article
   • Cover all competitor topics
   • Add unique insights
   • Include multimedia elements

4. Optimize & Publish (10 minutes):

   • Add internal links
   • Optimize metadata
   • Include schema markup
   • Publish to WordPress

5. Promote (Variable):

   • Share on social media
   • Build backlinks
   • Email to subscribers

Goal: Outrank competitors in 2-3 months!

---

🔧 Troubleshooting

Issue: "No active API key found"

Solution:

1. Go to Settings > API Keys
2. Make sure you have added a key
3. Check that it's toggled to "Active"
4. Try toggling off and on again

Issue: "Failed to generate article"

Possible Causes:

1. API key invalid: Generate a new key
2. Rate limit exceeded: Wait 60 seconds and try again
3. Network error: Check internet connection
4. Topic too vague: Be more specific

Issue: WordPress publishing failed

Solutions:

1. Test connection in Settings
2. Check WordPress URL is correct (include https://)
3. Verify application password (no typos)
4. Make sure WordPress REST API is enabled
5. Check if your host blocks API requests

Issue: Competitor analysis not working

Solutions:

1. Check URLs are publicly accessible
2. Some sites block scraping - try different URLs
3. Use recent articles (better success rate)
4. Try 3 URLs instead of 5

Issue: Internal links not appearing

Solutions:

1. Import sitemap first in Settings
2. Make sure you entered a target keyword
3. Check if internal links toggle is enabled
4. Verify imported links are relevant to topic

---

💡 Pro Tips & Best Practices

Content Quality

1. Always use competitor analysis - creates better content
2. Enable all article elements - richer, more engaging
3. Use brand voice - maintains consistency
4. Target 2000+ words - better SEO performance
5. Include internal links - improves site structure

SEO Optimization

1. Research keywords first - use Ahrefs, SEMrush, or free tools
2. Use long-tail keywords - easier to rank
3. Analyze competitor word count - match or exceed
4. Enable citations - builds E-E-A-T
5. Optimize meta description - improves CTR

WordPress Publishing

1. Add featured images - better engagement
2. Set categories - improves navigation
3. Schedule posts - consistent publishing
4. Interlink new posts - distribute authority
5. Promote immediately - social signals help SEO

Time Saving

1. Create templates - reuse successful formats
2. Batch generate - create multiple articles at once
3. Use custom outlines - speed up generation
4. Save competitor URLs - reuse for similar topics
5. Pre-import sitemaps - ready for internal linking

---

📈 Measuring Success

Article Performance Metrics

Week 1-4: Index & Crawl

• Check Google Search Console
• Verify article is indexed
• Monitor impressions

Month 2-3: Initial Rankings

• Track keyword positions
• Monitor organic traffic
• Check bounce rate

Month 4-6: Growth Phase

• Analyze top-performing articles
• Update underperforming content
• Build backlinks to best content

Key Metrics to Track

• Organic traffic (Google Analytics)
• Keyword rankings (Ahrefs, SEMrush)
• Backlinks (Ahrefs, Moz)
• Time on page (Google Analytics)
• Conversion rate (Goals in GA)

---

🚀 Next Steps

Now that you know how to use BlogForge AI:

1. ✅ Add your API key (if not done)
2. ✅ Generate 3 test articles (practice)
3. ✅ Set up WordPress (optional)
4. ✅ Import your sitemap (for internal links)
5. ✅ Create a brand voice (consistency)
6. ✅ Generate your first real article
7. ✅ Publish and promote
8. ✅ Analyze and iterate

---

🎓 Additional Resources

Learn More About SEO

• Google Search Central: https://developers.google.com/search
• Ahrefs Blog: https://ahrefs.com/blog
• Moz Beginner's Guide: https://moz.com/beginners-guide-to-seo

WordPress Resources

• WordPress REST API: https://developer.wordpress.org/rest-api
• Application Passwords: https://make.wordpress.org/core/2020/11/05/application-passwords

AI Writing

• Google AI Studio: https://makersuite.google.com
• OpenRouter: https://openrouter.ai

---

Happy Blogging! 🎉

If you have questions or need help, feel free to open an issue on GitHub or reach out to the community.