Running the System - Quick Guide

🚀 First Time Setup

Step 1: Run Quick Test

cd C:\dev\itblogpros\_automation
QUICK-TEST.bat

This will:

• ✅ Check Node.js is installed
• ✅ Verify .env file exists
• ✅ Install @google/generative-ai if needed
• ✅ Verify all files are present
• ✅ Run full system check

Step 2: Generate Data Files

START-HERE.bat

Then select:

• Option 9 - Run Bing Analysis (30 seconds)
• Option 0 - Run SEO Check (1 minute)

Step 3: Test Article Generation

START-HERE.bat

Then select:

• Option T - Test Gemini Integration

📝 Regular Usage

Generate a Single Article

cd C:\dev\itblogpros\_automation
START-HERE.bat

Select Option 4

Check What to Write About

START-HERE.bat

Select Option 6 - Shows Bing opportunities

Batch Generate Multiple Articles

START-HERE.bat

Select Option 5 - Uses CSV file

🔧 If START-HERE.bat Doesn't Work

Method 1: Use Direct Commands

cd C:\dev\itblogpros\_automation

REM Check opportunities
node integrated-system.js opportunities

REM Generate test article
node integrated-system.js test

REM Generate single article
node gemini-article-generator.js generate

Method 2: Check Requirements

REM 1. Verify Node.js installed
node --version

REM 2. Verify in correct directory
cd C:\dev\itblogpros\_automation
dir

REM 3. Check .env file exists
cd ..
type .env | findstr GEMINI_API_KEY

REM 4. Install dependencies if needed
npm install @google/generative-ai

Method 3: Run Verification

cd C:\dev\itblogpros
node verify-integration.js

🎯 Common Issues

"node is not recognized"

Fix: Install Node.js from https://nodejs.org

"Cannot find module '@google/generative-ai'"

Fix:

cd C:\dev\itblogpros
npm install @google/generative-ai

"GEMINI_API_KEY not found"

Fix: Already configured in .env file, just verify:

cd C:\dev\itblogpros
type .env | findstr GEMINI

Should show: GEMINI_API_KEY=AIzaSyB2BwTcHD5XXgGexBsSwhtZCcL6YqwWPPQ

"No opportunities file found"

Fix:

cd C:\dev\itblogpros
node run-bing-analysis.js

📊 All Available Commands

From _automation folder:

REM Menu system
START-HERE.bat

REM Quick test
QUICK-TEST.bat

REM Check opportunities
node integrated-system.js opportunities

REM Check SEO health
node integrated-system.js health

REM Full report
node integrated-system.js report

REM Test generation
node integrated-system.js test

REM Generate article
node gemini-article-generator.js generate

From project root:

REM Bing analysis
node run-bing-analysis.js

REM SEO check
node run-seo-check.js

REM Verify system
node verify-integration.js

REM Build site
npm run build

✅ Success Checklist

Before generating articles:

• [ ] Node.js installed (node --version works)
• [ ] In correct directory (C:\dev\itblogpros\_automation)
• [ ] .env file exists with Gemini key
• [ ] @google/generative-ai installed (QUICK-TEST.bat passes)
• [ ] Bing analysis run (option 9)
• [ ] SEO check run (option 0)
• [ ] Test generation successful (option T)

🎉 Quick Start Command

Just run this:

cd C:\dev\itblogpros\_automation && QUICK-TEST.bat && START-HERE.bat

This will:

1. Go to correct directory
2. Run full verification
3. Open main menu

Then select options 9, 0, T in sequence!

Need help? Check NEXT-STEPS.md for detailed instructions.