tiktok-ad-analysis

What problem does it solve?

This Skill automates the analysis of TikTok reference videos to extract hooks, strategies, and insights that inform script generation and market positioning. It produces bilingual outputs to support multilingual teams and faster decision making.

Core Features & Use Cases

• Automated video analysis: Processes reference videos from ref_video/ to identify opening hooks, messaging angles, and value propositions.
• Batch & parallel processing: Runs analysis across multiple products in parallel, generating per-video analysis files and a market synthesis.
• Outputs & integration: Produces video_N_analysis.md for each video and a mandatory video_synthesis.md that summarizes market insights for script generation.
• Automation-ready workflow: Integrates with downstream script-generation skill to create production-ready scripts from analysis.

Quick Start

Place your product videos in product_list/YYYYMMDD/{product_id}/ref_video/. Install required tools (Python 3.8+, ffmpeg, yt-dlp, faster-whisper, and gemini-cli). Run python analyze_video_batch.py <product_id> to process all videos for a product; results will appear as video_N_analysis.md files and video_synthesis.md in the same ref_video directory.