Automation Schedule - YouTube Automation Agent

Overview

The YouTube Automation Agent runs on a comprehensive schedule that handles content generation, publishing, analytics, and optimization tasks automatically. This guide explains each scheduled task and how to customize them.

All times are based on your server’s local timezone. Ensure your system time is correctly configured.

Daily Schedule Overview

Here’s what happens automatically each day:

Time	Task	Frequency	Description
6:00 AM	Content Generation	Daily	Generate new video content
Every 15 min	Publish Queue	Continuous	Check and publish scheduled videos
9:00 AM	Analytics Collection	Daily	Gather performance data
10:00 PM	Optimization	Daily	Update SEO and keywords
8:00 AM Sunday	Strategy Review	Weekly	Analyze and adjust content strategy
3:00 AM Saturday	Database Maintenance	Weekly	Backup and cleanup

Scheduled Tasks Detail

1. Daily Content Generation (6:00 AM)

Cron Expression: 0 6 * * * This is the primary automation task that creates new video content.

What Happens

Check Content Buffer

System verifies if new content is needed based on:

Current scheduled videos (default: maintain 3-day buffer)
Posting frequency setting (daily, every-2-days, 3-per-week, weekly)
Last generation timestamp

Generate Content

If content is needed, runs full pipeline:

Content Strategy Agent selects topic
Script Writer Agent creates script
Thumbnail Designer Agent generates thumbnail
SEO Optimizer Agent optimizes metadata
Production Management Agent compiles assets
Publishing Scheduling Agent queues for upload

Log Results

Records generation event to database with:

Content ID
Topic and title
Scheduled publish time
Success/failure status

Smart Buffer Management

The system intelligently decides whether to generate content:

// Content buffer check logic
const upcomingContent = await getUpcomingSchedule(3);
const bufferDays = 3; // configurable

if (upcomingContent.length >= bufferDays) {
  console.log('Skipping - sufficient content in pipeline');
  return;
}

The default 3-day buffer ensures you always have content ready, even if the system experiences downtime.

2. Publish Queue Processing (Every 15 Minutes)

Cron Expression: */15 * * * * Continuously monitors and publishes scheduled content.

Processing Flow

Query Database: Get all content with status = 'scheduled' and publishTime <= NOW()
Upload to YouTube: Use YouTube Data API v3 to upload video
Update Status: Mark as published with YouTube video ID
Enable Monitoring: Add to analytics tracking queue

# Monitor publish queue activity
curl http://localhost:3456/schedule

Example Response:

[
  {
    "id": "content_001",
    "title": "The Art of Digital Storytelling",
    "publishTime": "2024-01-16T14:00:00.000Z",
    "status": "scheduled"
  },
  {
    "id": "content_002",
    "title": "Understanding Visual Narratives",
    "publishTime": "2024-01-17T14:00:00.000Z",
    "status": "scheduled"
  }
]

3. Daily Analytics Collection (9:00 AM)

Cron Expression: 0 9 * * * Collects performance data for recently published videos.

Collection Process

Identify Recent Videos

Fetch all videos published in the last 7 days:

SELECT * FROM publish_schedule 
WHERE status = 'published' 
AND published_at > datetime('now', '-7 days')
ORDER BY published_at DESC

Query YouTube Analytics

For each video, collect:

View count
Watch time
Average view duration
Likes, comments, shares
Click-through rate
Audience retention
Traffic sources

Calculate Performance Score

Generate composite performance score (0-100) based on:

Engagement rate (30%)
View velocity (25%)
Retention rate (25%)
CTR (20%)

Store Results

Save analytics to database with 2-second delay between API calls to avoid rate limits.

# View collected analytics
curl http://localhost:3456/analytics

4. Weekly Strategy Review (8:00 AM Sunday)

Cron Expression: 0 8 * * 0 Analyzes performance and adjusts content strategy.

Review Process

Aggregate Weekly Data
- Collect analytics for all videos from past 7 days
- Identify top 3 performers
- Calculate average performance score

Extract Insights

const insights = {
  topPerformingTopics: weeklyAnalytics.topPerformers
    .map(video => video.videoDetails.title)
    .slice(0, 3),
  averageScore: weeklyAnalytics.averagePerformanceScore,
  recommendation: score > 80 ? 'excellent' : 'needs_improvement'
};

Optimize Publishing Times
- Analyze when your audience is most active
- Adjust default publish time (currently 2:00 PM)
- Update scheduling algorithm
Update Content Focus
- Feed top-performing topics to Content Strategy Agent
- Adjust content style preferences
- Update keyword priorities

5. Daily Optimization Tasks (10:00 PM)

Cron Expression: 0 22 * * * Maintains and improves existing content.

Optimization Tasks

Re-optimize Low Performers

Identifies videos with performance score < 50 in last 30 days:

Re-analyze SEO metadata
Generate updated titles/descriptions
Suggest thumbnail improvements
Update tags and keywords

Update Keyword Performance

Track keyword effectiveness:

Map keywords to video performance
Calculate keyword ROI
Build trending keyword database
Update SEO strategy

Cleanup Old Files

Remove temporary files:

Temp directory: Files older than 7 days
Uploads directory: Files older than 30 days
Maintains storage efficiency

6. Database Maintenance (3:00 AM Saturday)

Cron Expression: 0 3 * * 6 Weekly maintenance ensures system health.

Maintenance Operations

Create Backup

const backupPath = await db.backup();
// Saves to: ./backups/backup_YYYY-MM-DD_HH-mm-ss.db

Database Statistics

{
  "totalContent": 45,
  "publishedVideos": 42,
  "scheduledVideos": 3,
  "analyticsRecords": 294,
  "databaseSize": "2.4 MB"
}

Cleanup Old Data
- Remove analytics older than 90 days
- Archive completed automation events
- Optimize database indexes

Customizing the Schedule

Change Content Generation Time

Edit schedules/daily-automation.js:

// Change from 6:00 AM to 8:00 AM
this.scheduledTasks.set('daily-content-generation', 
  cron.schedule('0 8 * * *', async () => {
    if (this.isEnabled) {
      await this.runDailyContentGeneration();
    }
  })
);

Adjust Posting Frequency

Modify the content buffer settings in your database:

// Set posting frequency
await db.setSetting('posting_frequency', 'every-2-days');

// Options:
// - 'daily': Generate content every day
// - 'every-2-days': Generate every 2 days
// - '3-per-week': Monday, Wednesday, Friday
// - 'weekly': Once per week

Change Content Buffer Size

// Maintain 5-day buffer instead of 3
await db.setSetting('content_buffer_days', '5');

Adjust Analytics Collection Frequency

// Collect analytics every 6 hours instead of daily
this.scheduledTasks.set('analytics-collection',
  cron.schedule('0 */6 * * *', async () => {
    await this.collectDailyAnalytics();
  })
);

Monitoring Automation

View Automation Status

Check current automation state:

curl http://localhost:3456/health

Response includes:

{
  "status": "healthy",
  "initialized": true,
  "agents": ["strategy", "scriptWriter", "..." ],
  "timestamp": "2024-01-15T10:30:00.000Z"
}

View Recent Automation Events

Query the automation events log:

SELECT * FROM automation_events 
ORDER BY created_at DESC 
LIMIT 10;

Event Types:

daily_content_generation
queue_processing
analytics_collection
weekly_strategy_review
daily_optimization
database_maintenance

Dashboard Monitoring

The web dashboard at http://localhost:3456 displays:

Next scheduled generation time
Automation status (active/paused)
Recent automation activity log
System health score

Controlling Automation

While the schedule is automated, you maintain full control:

Pause Automation

// Temporarily pause all automation
await automation.pauseAutomation();

Pausing automation stops scheduled content generation but allows manual operations to continue.

Resume Automation

await automation.resumeAutomation();

Stop All Tasks

// Completely stop all scheduled tasks
await automation.stopAutomation();

System Health Monitoring

The automation system includes self-monitoring:

Hourly Health Checks

Every hour, the system performs:

Database Connectivity

Verifies database is accessible and responsive.

Scheduled Task Status

Confirms all cron jobs are running properly.

System Resources

Monitors memory usage and uptime.

Health Score Calculation

Generates score 0-100:

100: Perfect health
80-99: Good health
50-79: Warning state
Below 50: Critical issues

// Health check results
{
  "timestamp": "2024-01-15T14:00:00.000Z",
  "database": true,
  "scheduledTasks": {
    "daily-content-generation": true,
    "publish-queue-processing": true,
    "daily-analytics": true,
    "weekly-strategy-review": true,
    "daily-optimization": true,
    "database-maintenance": true
  },
  "systemResources": {
    "uptime": 86400,
    "memory": {
      "heapUsed": 45.2,
      "heapTotal": 68.8
    }
  },
  "healthScore": 100
}

Failure Notifications

When tasks fail, the system:

Logs error details to database
Logs to console with ERROR level
Stores failure in automation_events table
Continues other scheduled tasks

// Example failure log
{
  "event_type": "daily_content_generation",
  "status": "error",
  "data": {
    "error": "OpenAI API rate limit exceeded"
  },
  "created_at": "2024-01-15T06:00:00.000Z"
}

Best Practices

Keep the automation running continuously for best results. The system learns and improves over time.

Recommended Configuration

For New Channels:

Posting frequency: daily
Content buffer: 3 days
Manual topic selection for first 5-10 videos

For Established Channels:

Posting frequency: every-2-days or 3-per-week
Content buffer: 5 days
Full automation with strategy agent

Monitoring Checklist

Check dashboard daily for first week
Review analytics after each video publishes
Verify health endpoint returns “healthy”
Monitor content buffer stays above 2 days
Review weekly strategy insights
Check database backups are being created

Troubleshooting

Content Not Generating

Check automation status:

curl http://localhost:3456/health

Common causes:

Automation paused: Resume with resumeAutomation()
Buffer full: Content buffer already satisfied
API rate limits: Wait for quota reset
Missing credentials: Run npm run credentials:setup

Videos Not Publishing

Verify publish queue:

curl http://localhost:3456/schedule

Check for:

OAuth token expiration (reauthorize)
Network connectivity issues
YouTube API quota limits
Content stuck in “processing” status

Analytics Not Updating

Common issues:

Videos too new (wait 24 hours for data)
YouTube Analytics API not enabled
Insufficient video history
Rate limiting from excessive requests

Next Steps

Manual Operations

Override automation with manual control endpoints

Dashboard Guide

Master the web interface for monitoring

Agent Configuration

Customize individual agent behaviors

API Reference

Explore all available API endpoints

Get Started

Core Features

Configuration

Usage Guides

Deployment

Advanced

Documentation Index

​Overview

​Daily Schedule Overview

​Scheduled Tasks Detail

​1. Daily Content Generation (6:00 AM)

​What Happens

​Smart Buffer Management

​2. Publish Queue Processing (Every 15 Minutes)

​Processing Flow

​3. Daily Analytics Collection (9:00 AM)

​Collection Process

​4. Weekly Strategy Review (8:00 AM Sunday)

​Review Process

​5. Daily Optimization Tasks (10:00 PM)

​Optimization Tasks

​6. Database Maintenance (3:00 AM Saturday)

​Maintenance Operations

​Customizing the Schedule

​Change Content Generation Time

​Adjust Posting Frequency

​Change Content Buffer Size

​Adjust Analytics Collection Frequency

​Monitoring Automation

​View Automation Status

​View Recent Automation Events

​Dashboard Monitoring

​Controlling Automation

​Pause Automation

​Resume Automation

​Stop All Tasks

​System Health Monitoring

​Hourly Health Checks

​Failure Notifications

​Best Practices

​Recommended Configuration

​Monitoring Checklist

​Troubleshooting

​Content Not Generating

​Videos Not Publishing

​Analytics Not Updating

​Next Steps

Manual Operations

Dashboard Guide

Agent Configuration

API Reference

Build docs developers (and LLMs) love

Overview

Daily Schedule Overview

Scheduled Tasks Detail

1. Daily Content Generation (6:00 AM)

What Happens

Smart Buffer Management

2. Publish Queue Processing (Every 15 Minutes)

Processing Flow

3. Daily Analytics Collection (9:00 AM)

Collection Process

4. Weekly Strategy Review (8:00 AM Sunday)

Review Process

5. Daily Optimization Tasks (10:00 PM)

Optimization Tasks

6. Database Maintenance (3:00 AM Saturday)

Maintenance Operations

Customizing the Schedule

Change Content Generation Time

Adjust Posting Frequency

Change Content Buffer Size

Adjust Analytics Collection Frequency

Monitoring Automation

View Automation Status

View Recent Automation Events

Dashboard Monitoring

Controlling Automation

Pause Automation

Resume Automation

Stop All Tasks

System Health Monitoring

Hourly Health Checks

Failure Notifications

Best Practices

Recommended Configuration

Monitoring Checklist

Troubleshooting

Content Not Generating

Videos Not Publishing

Analytics Not Updating

Next Steps