🚀 AI Viral Thread Marketing Agent

"The Content Distribution Engine for High-Growth Founders"

View Results • Setup Guide • Technical Specs

📖 Table of Contents

• 🛑 The Problem
• 💡 The Solution
• 📸 Live Results
• 🏗️ System Architecture
• 🛠️ Setup Guide
• ⚙️ Configuration Matrix
• 🤓 Technical Deep Dive
• 🚨 Troubleshooting & FAQ
• 💰 Cost & ROI

🛑 The Problem: "Distribution Hell"

Be honest: How many great ideas die in your notes app because you don't have the energy to format them for Twitter, Threads, and Bluesky?

You know consistency brings leads. You know you need to be "everywhere." But writing the same post 3 times is soul-crushing.

And when you stop posting, your meaningful growth stops.

💡 The Solution: Automated Viral Engineering

Day 21 of the 30 Days, 30 AI Agents Challenge.

This isn't just a scheduler. It's a ghostwriter in your pocket. This system monitors your email, picks up raw thoughts, converts them into high-performing viral threads, and broadcasts them key platforms instantly.

⚡ The "Growth Loop"

1. 📥 Capture: Send a quick email to yourself with subject thread.
2. 🧠 Expand: AI Agent #1 (The Strategist) outlines a 5-step argument.
3. ✍️ Refine: AI Agent #2 (The Editor) applies "Spartan" brevity and viral hooks.
4. 🚀 Deploy: The System posts natively to X (Twitter), Threads, and Bluesky.

No dashboards to check. No files to drag. Just email and forget.

📸 Live Results

See what the agent outputs from a single sentence idea:

Platform Output Example 1	Platform Output Example 2
Clean, threaded format with media	Native experience on mobile

🏗️ System Architecture & Workflow

This automation is built on a sophisticated Multi-Agent Architecture tailored for resilience and quality.

🌊 The Flow

🧩 The "Brain" (Agents)

🛠️ Setup Guide

Deploy this engine in less than 15 minutes.

📋 Prerequisites (Click to Expand)

• n8n Instance: Self-hosted (Free) or Cloud.
• OpenAI API Key: Must have GPT-4 access.
• Blotato Account: For managing social APIs via Verified Nodes.
• Gmail Account: Any standard Gmail works.

Step 1: Import The Blueprint

1. Download 2_email_to_longform_thread_N8N_TEMPLATE.json.
2. In n8n, click Import (top right) > From File.
3. You will see the workflow map appear (as shown in the architecture image).

Step 2: Connect Your Tools

The workflow uses "Sticky Notes" to guide you, but here is the critical path:

[!IMPORTANT] Use "Verified Community Nodes" for Blotato. Go to Settings > Community Nodes > Enable. This ensures safe API handling.

🔐 Credential Setup

1. Gmail: Authenticate with OAuth2. Scope: gmail.readonly.
2. OpenAI: Paste your API Key.
3. Blotato: Generate a key in Blotato Settings > API and paste it into the n8n credential manager.

Step 3: Configure The "Voice"

You don't want to sound like a robot.

1. Open the AI Writes Thread node.
2. Scroll to System Prompt.
3. Find the `` block.
4. Edit this! Paste your own best tweets or rules (e.g., "Use 🚀 emojis", "Be sarcastic", "Never use the word 'delve'").

Step 4: Test Run

1. Click Execute Workflow.
2. Send yourself an email:
   • Subject: thread
   • Body: Why remote work is actually harder than office work. Focus on isolation and over-communication.
3. Watch the agents work in real-time! 🟢

⚙️ Configuration Matrix

Customize the workflow behavior by editing these nodes.

🤓 Technical Deep Dive

For the developers and power users.

The JSON Data Structure

The agents are forced to output data in this strict format to ensure platform compatibility:

json
{
  "text": "The first tweet (hook) goes here...",
  "mediaUrls": ["https://example.com/image.jpg"],
  "additionalPosts": [
    {
      "text": "Tweet 2 in the thread...",
      "mediaUrls": []
    },
    {
      "text": "Tweet 3 (CTA)...",
      "mediaUrls": []
    }
  ]
}

Media Handling Logic

• Extraction: The agent parses standard URLs from your email body.
• Assignment: It intelligently decides if an image belongs to the first tweet or a subsequent tweet based on context.
• Safety: If an explicit media URL isn't found, it defaults to clear text to prevent broken image links.

🚨 Troubleshooting & FAQ

❓ ERROR: "No JSON Output"

Cause: The AI Model failed to follow the strict formatting rules. Fix:

1. Check your OpenAI credit balance.
2. In the OpenAI Fixer node, increase the Temperature to 0.2 to allow it more flexibility in correction.

❓ ERROR: "Twitter / X Post Failed"

Cause: Usually due to duplicate content or rate limits. Fix:

1. Ensure you aren't posting the exact same text twice.
2. Check Blotato dashboard for specific API error codes (e.g., 429 Too Many Requests).

❓ Q: Can I use Claude/Anthropic instead?

A: Yes! Simply replace the OpenAI Model node with an Anthropic Chat Model node. Ensure you update the system prompt to be Claude-friendly (XML tags work best, which we already use).

💰 Cost & ROI Analysis

Why build instead of buy?

• Based on ~100 runs per month using GPT-4 API costs.

📄 License

This workflow acts as a template. You are free to modify, sell, or distribute your generated content. Template License: MIT.

"Clarity creates action. Automation creates scale."

💬 Made for the 30 Days AI Challenge. Need help? Comment "Agent 21" or DM me.