🚀 ViralTube: AI Transcript & Content Engine

Turn any YouTube video into a viral content machine. Reliable. Fast. Automated.

Stop fighting with "Sign in required" or "Cookies missing" errors. This Actor is a production-grade tool for content strategists, agencies, and creators who need a guaranteed way to extract transcripts and repurpose videos.

We combined a robust decentralized scraping architecture with Google's latest Gemini 2.5 AI to deliver the ultimate repurposing tool.

---

🔥 Why is ViralTube different?

Most YouTube scrapers fail because they rely on a single IP address or library. ViralTube uses a "Waterfall" Anti-Ban Strategy:

1. 🕵️ Layer 1: The Decentralized Network. First, the Actor rotates through a list of 30+ Invidious instances (open-source YouTube mirrors). This bypasses YouTube's main bot detection algorithms entirely.
2. 🛡️ Layer 2: Android Simulation. If mirrors are busy, it utilizes a fallback mechanism mimicking a mobile Android client.
3. 🔄 Layer 3: Smart Parsers. It parses raw data structures to find captions even when the frontend hides them.

Result: Higher success rates where other actors fail.

---

🧠 The AI Core

Once the transcript is secured, the data is fed into Google Gemini 2.5 Flash. The AI acts as an expert social media strategist to generate:

• 🎣 Viral/Clickbait Titles for re-packaging.
• 📝 TL;DR Summary (The core value in 2 sentences).
• 💼 LinkedIn Post (Professional, structured, emoji-optimized).
• 🐦 Twitter/X Thread (A coherent thread of 3-5 tweets).
• 🎬 Shorts/Reels Scripts (With visual hooks and timestamps).
• 🏷️ SEO Tags for better discoverability.

---

🛠️ How to use

Input Parameters

Field	Type	Description	Required?
videoUrl	String	The full YouTube video URL (e.g., https://www.youtube.com/watch?v=...)	✅ Yes
geminiApiKey	String	Your own Google AI Studio API Key. If left empty, the system tries to use a shared key (subject to strict rate limits).	❌ No (Recommended)
tone	String	The writing style. Options: Viral & Engaging, Professional, Funny, Educational. Default: Viral & Engaging.	❌ No

Example Input JSON

{
  "videoUrl": "https://www.youtube.com/watch?v=0e3GPea1Tyg",
  "tone": "Viral & Engaging",
  "geminiApiKey": "AIzaSyD..."
}

---

📦 Output Example

The Actor produces a clean, validated JSON object perfect for automation workflows (Make.com, Zapier, n8n).

{
  "youtube_url": "https://www.youtube.com/watch?v=0e3GPea1Tyg",
  "video_id": "0e3GPea1Tyg",
  "viral_title": "I Recreated SQUID GAME IRL: $456,000 on the Line! (Red Light, Green Light CHAOS)",
  "summary_tldr": "456 contestants battled through REAL-LIFE versions of every Squid Game challenge, from Red Light Green Light to the Glass Bridge. Only one person walked away with the life-changing $456,000 cash prize.",
  "linkedin_post": "Executing a project of this magnitude is a masterclass in logistics and audience psychology. We just wrapped up a real-life recreation of Squid Game with 456 participants... [full post]",
  "twitter_thread": [
    "🤯 We built the ENTIRE Squid Game set and invited 456 people to compete for $456,000 LIVE! Round 1: Red Light, Green Light. The fear was absolutely real. 💥 #SquidGame #MrBeast",
    "The Honeycomb challenge nearly took out a fan favorite! 🍪 Watching them carve delicate shapes under extreme time pressure was pure suspense. #Challenge",
    "Friendships were tested in the Marble round. We forced best friends to compete against each other. The betrayal factor? 10/10. 💔"
  ],
  "shorts_scripts": [
    {
      "hook": "They thought it was just a game... until Red Light Green Light started!",
      "script": "**(0:00-0:03 Hook)** [Zoom on giant doll] MrBeast: 'Whichever one of you survives longest, wins $456,000.'\n**(0:03-0:08 Action)** [Gunshot sound effect] Host: 'RED LIGHT!' [Player gets eliminated]..."
    }
  ],
  "seo_tags": ["MrBeast", "Squid Game", "Challenge", "Viral Video", "Reality Competition"]
}

---

⚖️ Performance & Limits

• Execution Time: Usually 10-30 seconds (depending on which Invidious mirror responds first).
• Video Length: Supports transcripts up to ~50,000 characters (approx 45-60 mins of speech).
• Languages: Automatically detects subtitles.

---

Built with 💥 by automated content experts.