{ "project_name": "YouTube Global View Simulator", "description": "Fully automated system that creates 10 real browser instances from 10 different countries to watch YouTube videos and generate authentic global engagement", "core_objective": "When user submits YouTube URL → System automatically creates 10 real browsers from 10 different countries → Each browser plays video completely → 100% authentic traffic from real global sources", "technical_requirements": { "real_browsers": "Yes - actual Chrome/Firefox instances", "locations": "10 different countries - 100% authentic IPs", "video_playback": "Complete video watch with real engagement", "automation": "Fully automatic after URL submission", "authenticity": "100% real traffic from genuine sources" }, "system_architecture": { "dashboard_interface": { "url_input": "YouTube URL submission form", "real_time_monitoring": "Live view of all 10 browsers", "analytics_dashboard": "Real-time statistics and completion status" }, "browser_farm": { "total_instances": 10, "browser_types": ["Chrome", "Firefox", "Edge"], "mode": "Visible browsers (not headless)", "location_distribution": { "country_1": "United States", "country_2": "United Kingdom", "country_3": "Germany", "country_4": "Japan", "country_5": "India", "country_6": "Brazil", "country_7": "Australia", "country_8": "Canada", "country_9": "France", "country_10": "Singapore" } }, "proxy_network": { "type": "Residential proxies (100% real IPs)", "providers": ["BrightData", "Oxylabs", "SmartProxy"], "authentication": "API-based rotation", "location_accuracy": "City-level targeting" } }, "automation_workflow": { "step_1": "User submits YouTube URL through dashboard", "step_2": "System validates URL and extracts video ID", "step_3": "Simultaneously launch 10 browser instances with different country IPs", "step_4": "Each browser navigates to YouTube URL with location-specific settings", "step_5": "Automatic video playback with realistic watch behavior", "step_6": "Monitor playback completion for each instance", "step_7": "Collect real-time analytics and display on dashboard", "step_8": "Generate comprehensive report after completion" }, "browser_configuration": { "realistic_behavior": { "watch_time": "Complete video duration", "interaction_patterns": ["Random pauses", "Volume adjustments", "Fullscreen toggle"], "mouse_movements": "Realistic human-like interactions", "scroll_behavior": "Natural scrolling patterns" }, "location_specific_settings": { "language": "Local language based on country", "timezone": "Automatic timezone detection", "resolution": "Common screen resolutions per country", "user_agents": "Real browser user agents per location" } }, "technical_implementation": { "core_technologies": { "automation_framework": "Selenium WebDriver + Puppeteer", "proxy_management": "Residential proxy API integration", "browser_management": "WebDriver manager with parallel execution", "real_time_monitoring": "WebSocket connections for live updates" }, "key_scripts": { "main_orchestrator": "orchestrate_browser_farm.py", "proxy_rotator": "residential_proxy_manager.py", "youtube_player": "youtube_automation_engine.py", "dashboard_server": "flask_dashboard.py", "analytics_collector": "real_time_analytics.py" } }, "claude_ai_prompts": { "prompt_1": { "title": "Create Main Browser Orchestrator", "content": "Create a Python class `BrowserFarmOrchestrator` that simultaneously launches 10 real browser instances from 10 different countries using residential proxies. Each browser should have unique: IP address, user agent, language, timezone, and screen resolution. Implement parallel execution with real-time monitoring.", "requirements": [ "Use Selenium WebDriver with visible browsers", "Integrate residential proxy APIs (BrightData/Oxylabs)", "Handle 10 parallel browser sessions", "Real-time status monitoring", "Error handling and retry mechanisms" ] }, "prompt_2": { "title": "YouTube Video Player Automation", "content": "Create `YouTubeVideoPlayer` class that automatically plays YouTube videos with realistic human behavior. Include: video quality selection, random pauses, volume adjustments, fullscreen toggles, and natural mouse movements. Ensure complete video watch with engagement metrics collection.", "features": [ "Auto-play video with sound", "Realistic watch patterns", "Interaction with video player", "Completion detection", "Engagement metrics tracking" ] }, "prompt_3": { "title": "Real-Time Dashboard", "content": "Build a Flask dashboard that shows live status of all 10 browsers: current country, playback status, time watched, completion percentage. Include URL submission form and real-time analytics with world map visualization.", "components": [ "URL input form", "Live browser status grid", "World map with active locations", "Real-time analytics panel", "Completion reports" ] } }, "proxy_configuration": { "residential_proxies": { "provider_config": { "brightdata": { "api_key": "YOUR_BRIGHTDATA_API", "zone": "residential", "country_targeting": "specific countries" }, "oxylabs": { "api_key": "YOUR_OXYLABS_API", "country_list": ["us", "gb", "de", "jp", "in", "br", "au", "ca", "fr", "sg"] } }, "authentication": "Username/password rotation", "session_management": "Sticky sessions for video duration" } }, "data_collection_analytics": { "real_time_metrics": { "per_browser": [ "country", "playback_status", "time_watched", "completion_percentage", "video_quality", "engagement_score" ], "aggregate_metrics": [ "total_watch_time", "global_reach_score", "completion_rate", "geographic_distribution" ] }, "final_report": { "video_performance": "Global engagement analysis", "geographic_insights": "Country-specific behavior", "completion_analytics": "Watch duration statistics", "recommendations": "Optimization suggestions" } }, "deployment_structure": { "project_layout": { "src/": { "orchestrator.py": "Main browser farm controller", "proxy_manager.py": "Residential proxy handling", "youtube_engine.py": "Video playback automation", "dashboard/": "Web interface files", "config/": "Configuration files" }, "requirements.txt": "Python dependencies", "run_system.py": "Main execution script", "README.md": "Setup and usage instructions" }, "dependencies": [ "selenium==4.15.0", "flask==2.3.3", "requests==2.31.0", "websocket-client==1.6.3", "pandas==2.1.3", "gevent==23.9.1" ] }, "execution_instructions": { "setup": "1. Install Python dependencies 2. Configure proxy API keys 3. Set up browser drivers", "execution": "1. Run main system 2. Access dashboard 3. Submit YouTube URL 4. Monitor 10 browsers in real-time", "monitoring": "Live view of all browsers with country flags and status indicators", "completion": "Detailed analytics report with global engagement metrics" } }