SEOOptimizerAgent

const { SEOOptimizerAgent } = require('./agents/seo-optimizer-agent');

const agent = new SEOOptimizerAgent(db, credentials);

await agent.initialize();
// Loads keyword performance history for optimization

const seoData = await agent.optimize(script, strategy);

console.log(seoData);
// {
//   title: 'Ultimate JavaScript Tutorial - Master JS in 2026',
//   description: 'JavaScript Tutorial - In this video, you\'ll discover...',
//   tags: ['javascript', 'tutorial', 'programming', 'how to javascript', ...],
//   hashtags: ['#JavaScript', '#Tutorial', '#Programming', ...],
//   chapters: [
//     { time: '00:00', title: 'Introduction', seconds: 0 },
//     { time: '00:20', title: 'The Challenge', seconds: 20 },
//     ...
//   ],
//   endScreen: { elements: [...], startTime: -20, template: 'standard' },
//   seoScore: 87,
//   metadata: {
//     primaryKeyword: 'javascript',
//     secondaryKeywords: ['tutorial', 'programming', 'coding', 'learn'],
//     targetLength: '10-15 minutes',
//     language: 'en',
//     category: 28
//   },
//   createdAt: '2026-03-05T10:00:00.000Z'
// }

const optimized = await agent.optimizeTitle(
  'JavaScript Tutorial',
  { keywords: ['javascript', 'programming'], contentType: 'Tutorial' }
);
// 'Ultimate JavaScript Tutorial (2026) - Programming'

// Optimization includes:
// - Power words (Ultimate, Complete, Essential, etc.)
// - Current year if under 70 characters
// - Primary keyword inclusion
// - Proper title case formatting
// - Length optimization (60-70 characters ideal)

const description = await agent.generateDescription(script, strategy);

// Description includes:
// - Hook (first 125 characters - shown in search)
// - What you'll learn section
// - Timestamps/chapters
// - About this video (keyword-rich paragraph)
// - Useful links (channel, website, social)
// - Related videos
// - Tools & resources (for tutorials)
// - Business inquiries
// - Hashtags
// - Disclaimer
// - Copyright and music credits

const tags = await agent.generateTags(script, strategy);

// Tag sources:
// - Primary keywords from strategy
// - Topic variations (with spaces, without, with underscores)
// - Content type tags (tutorial, how to, guide, etc.)
// - Year tags (2026, JavaScript 2026)
// - Niche-specific tags (tech, gaming, education, etc.)
// - Long-tail keywords (how to javascript, javascript for beginners)
// - Channel branding tags

console.log(tags);
// ['javascript', 'tutorial', 'how to', 'programming', '2026', 
//  'javascript 2026', 'javascript tutorial', 'learn javascript', ...]

const hashtags = await agent.generateHashtags(strategy);

// Includes:
// - Primary topic hashtag (#JavaScript)
// - Content type hashtag (#Tutorial)
// - Trending hashtags (#YouTube, #Subscribe, #Trending)
// - Niche hashtags (#Tech, #Programming)
// - Year hashtag (#2026)

console.log(hashtags);
// ['#JavaScript', '#Tutorial', '#YouTube', '#Tech', '#Programming', 
//  '#Subscribe', '#Video', '#2026', ...]

const chapters = await agent.generateChapters(script);

console.log(chapters);
// [
//   { time: '00:00', title: 'Introduction', seconds: 0 },
//   { time: '00:20', title: 'The Challenge', seconds: 20 },
//   { time: '00:50', title: 'The Solution', seconds: 50 },
//   { time: '03:05', title: 'Live Demo', seconds: 185 },
//   { time: '05:05', title: 'Conclusion & Next Steps', seconds: 305 }
// ]

const endScreen = await agent.generateEndScreenStrategy();

console.log(endScreen);
// {
//   elements: [
//     { type: 'video', position: 'left', title: 'Recommended Video', duration: 20 },
//     { type: 'playlist', position: 'right', title: 'Watch More', duration: 20 },
//     { type: 'subscribe', position: 'center-bottom', duration: 20 }
//   ],
//   startTime: -20,  // 20 seconds before end
//   template: 'standard'
// }

const score = await agent.calculateSEOScore(title, description, tags);

// Scoring breakdown:
// Title (30 points max):
//   - Optimal length 60-70 chars: 10 points
//   - Contains number: 5 points
//   - Proper capitalization: 5 points
//   - Current year: 5 points
//   - Power words (how, what, why, best): 5 points
//
// Description (40 points max):
//   - Length >= 200 chars: 10 points
//   - Length >= 500 chars: 10 points
//   - Contains TIMESTAMPS: 5 points
//   - Contains links: 5 points
//   - Well formatted (10+ lines): 5 points
//   - Primary keyword in first 125 chars: 5 points
//
// Tags (30 points max):
//   - 10+ tags: 10 points
//   - 15+ tags: 5 points
//   - Contains long-tail keywords: 5 points
//   - Within 500 char limit: 5 points
//   - No duplicates: 5 points

console.log('SEO Score:', score);
// 87

const niche = agent.identifyNiche({ topic: 'Python Programming Tutorial' });
// 'technology'

const categoryId = agent.selectCategory(strategy);
// 28 for technology/science
// 20 for gaming
// 27 for education
// 22 for people & blogs (default)

const length = agent.calculateOptimalLength('Tutorial');
// '10-15 minutes'

// Optimal lengths:
// Tutorial: 10-15 minutes
// Explainer: 5-10 minutes
// Review: 8-12 minutes
// List: 8-15 minutes
// Story: 10-20 minutes

const { SEOOptimizerAgent } = require('./agents/seo-optimizer-agent');

const agent = new SEOOptimizerAgent(db, credentials);
await agent.initialize();

const script = {
  title: 'JavaScript Promises Tutorial',
  mainContent: {
    sections: [
      { title: 'The Challenge', duration: 30 },
      { title: 'The Solution', duration: 90 },
      { title: 'Live Demo', duration: 120 }
    ]
  }
};

const strategy = {
  topic: 'JavaScript Promises',
  contentType: 'Tutorial',
  keywords: ['javascript', 'promises', 'async', 'tutorial'],
  targetAudience: 'Developers'
};

const seoData = await agent.optimize(script, strategy);

console.log('Optimized Title:', seoData.title);
console.log('SEO Score:', seoData.seoScore, '/100');
console.log('Tags:', seoData.tags.join(', '));
console.log('Chapters:', seoData.chapters.length);

// Use in video upload
const uploadMetadata = {
  title: seoData.title,
  description: seoData.description,
  tags: seoData.tags,
  categoryId: seoData.metadata.category.toString()
};