workflows/viral_hunter.md

Workflow: Viral Hunter

Objective: Research a specific niche to find high-engagement (viral) content on Reddit and synthesize a "Trend Proof" report.

Required Inputs

• NICHE: The topic or industry to research (e.g., "AI Tools", "Mechanical Keyboards").

Steps

1. Identify Trends

   • Use the agent's knowledge or the search_web tool to identify 3-5 trending visual or news-based topics in the NICHE.

2. Fetch Viral Content

   • Execute tools/get_youtube_viral.py and tools/get_tiktok_trends.py for the identified topics.

3. Analyze Content & Reasoning

   • For each top post/video:
     • Identify the core hook or trend.
     • Look for recurring patterns (e.g., specific keywords, visual styles).
     • Synthesize information from across platforms to understand why it is resonating.

4. Generate Report

   • Produce a flat text report with the following structure:
     • Trend Name
     • Proof: Link to post/comment and engagement metrics.
     • Reasoning: Explanation of why this is a trend and how to capitalize on it.

Edge Cases

• No active trends: If no viral content is found, fallback to searching related niches or general industry news.
• API Errors: Ensure .env is correctly configured with Reddit credentials.