Twitter Video Optimizer

Purpose & User Intent: The tool analyzes Twitter video content to maximize reach and retention. Target users include social media managers, brands, and creators who publish native video on Twitter. When planning a campaign, during post-publish optimization, or in rapid testing cycles, the tool ingests a video source and optional metadata and returns a quantified optimization plan. It focuses on video length, caption and hashtag effectiveness, thumbnail guidance, and posting-time recommendations. The differentiator is the combination of platform constraints with data-driven engagement models and production-ready templates for captions and thumbnails.
Core Logic & Features: Domain capabilities include validation of Twitter video specs (max duration, accepted formats), optional extraction of performance signals, and generation of optimization suggestions. Required features are video ingestion, duration validation, basic metrics output, engagement scoring, caption and hashtag scoring, and thumbnail guidance. Optional features include posting-time optimization based on historical patterns, multi-language caption suggestions, exportable reports, and thumbnail variant generation. Example: a 90-second video with 2 hashtags yields trimming to 60–75 seconds, a caption of 100–140 characters, and three thumbnail options designed for high contrast and readability.
Inputs & Outputs: Inputs include video_source_type (string: 'url' or 'file'), video_input (string), video_duration_seconds (number, seconds), caption_text (string, optional), hashtags (array, optional), posting_time_hint (string ISO 8601, optional), follower_count (integer, optional), audience_language (string, optional). Outputs include engagement_score (number 0–100), predicted_impressions (integer), recommended_caption (string), recommended_hashtags (array), thumbnail_suggestions (array), recommended_video_length_seconds (integer), best_posting_window (string), and summary_report (string).