🌟 NOVA — Niche-Optimized Viral Accelerator

The Ultimate Instagram Growth AI Agent for n8n

One node. All the power. Zero headaches. Connects to real Instagram.

📋 Table of Contents

• What Is NOVA?
• Features
• Installation
• Quick Start (2 Minutes)
• Connecting Instagram
• Full Configuration Guide
• Sample Carousel Feature
• Custom Tools & Integrations
• Example Workflows
• Output Format
• Supported LLMs
• Publishing Updates
• Troubleshooting
• FAQ

What Is NOVA?

NOVA is a custom n8n community node that runs an entire Instagram growth operation from a single node. Drop it on your canvas, connect any trigger, configure a few settings, and watch it:

1. 🔍 Research your niche across Reddit, Google Trends, forums, blogs, competitors
2. 🎨 Create carousel content with hooks, captions, and hashtags
3. 🖼️ Design carousels in HTML/CSS (6 styles, or copy any design)
4. 📤 Post directly to Instagram via the Graph API
5. 📊 Analyze performance with real Instagram insights
6. 🧪 Optimize with A/B tests on hooks, captions, and strategies
7. 🧠 Learn from every cycle and get smarter

Works with ANY n8n trigger: Schedule, Cron, Webhook, Manual, Chat, Telegram, Discord, Slack, Email, HTTP, and more.

Features

Core

• 🚀 Full Growth Cycle — Research → Create → Design → Post → Analyze → Optimize
• 🔍 5 Operation Modes — Full Cycle, Research Only, Content Only, Analyze Only, Optimize Only
• 🤖 Universal LLM — OpenAI, Anthropic, Google, Ollama, Mistral, Groq, DeepSeek, Custom
• 🧠 Self-Improving — Gets smarter every cycle

Content & Carousels

• 🎨 6 Built-in Styles — Minimal, Bold, Neon, Corporate, Dark Mode, Pastel
• 🔗 Copy from Image URL — Point to any design, NOVA matches the style
• 📝 Copy from HTML Code — Paste your own template
• ✏️ Design Description — Describe what you want in plain English
• 📐 Configurable — Choose number of carousels (1-50) and slides per carousel (3-15)

Instagram Integration

• 📤 Post Carousels — Directly to Instagram via Graph API
• 🖼️ Post Images — Single image posts
• 🎬 Post Reels — Video content
• 📖 Post Stories — Story content
• 📊 Account Insights — Reach, impressions, follower count
• 📈 Post Insights — Likes, comments, saves, shares
• 👥 Audience Demographics — City, country, gender, age
• 💬 Comment Management — Read and reply to comments
• #️⃣ Hashtag Search — Find trending hashtags

Timing & Scheduling

• 🤖 AI Optimal Timing — Best times for YOUR audience
• 📅 Custom Schedule — You set the times
• ⏳ Queue Mode — Posts as fast as safely possible
• ⏰ Configurable — 1-10 posts per day, min hours between posts
• 🌍 Timezone Support — Any timezone

Custom Tools & Integrations

• 🌐 Web Scraping — Research the web automatically
• 🟠 Reddit Scraping — Monitor subreddits for niche insights
• 📊 Google Sheets — Log results to spreadsheets
• 🗄️ Database — Store knowledge base in Postgres/etc.
• 🔗 Custom APIs — Call any endpoint during research
• 🔔 Webhooks — Slack, Discord, notifications

Safety

• 🛡️ Shadowban Prevention — Smart rate limiting
• ⏱️ Rate Limiting — Max actions per hour
• 📝 Content Moderation — Review before posting

Installation

Method 1: n8n Community Nodes GUI (Recommended — 30 seconds)

1. Open your n8n instance
2. Go to Settings → Community Nodes
3. Click Install a community node
4. Type: n8n-nodes-nova
5. Click Install
6. ✅ NOVA appears in your node palette under "Transform"

Method 2: npm (Self-Hosted)

npm install n8n-nodes-nova
n8n restart

Method 3: Docker

FROM n8nio/n8n:latest
RUN cd /usr/local/lib/node_modules/n8n && npm install n8n-nodes-nova

Quick Start

Step 1: Add Credentials

1. Go to Credentials → Add Credential → NOVA API
2. Fill in:
   • LLM Provider: Select your provider
   • API Key: Your LLM API key
   • Instagram Token (optional): For posting and analytics
   • Instagram Account ID (optional): Your business account ID

Step 2: Build Your Workflow

[Schedule Trigger] → [NOVA] → [View Output]

Step 3: Configure NOVA

| Setting | What to enter | |---------|--------------| | Niche | Your niche (e.g., "fitness") | | Mode | Full Growth Cycle | | Goal | Your target | | Model | gpt-4o-mini |

That's it! Run it and watch the magic. ✨

Connecting Instagram

Getting Instagram Access Token

1. Go to Meta Developer Portal
2. Create an app → Business type
3. Add Instagram Graph API product
4. Generate an access token with these permissions:
   • instagram_basic
   • instagram_content_publish
   • instagram_manage_insights
   • pages_show_list
   • pages_read_engagement
5. Copy the token

Getting Instagram Business Account ID

1. Go to Facebook Business Suite
2. Select your Instagram account
3. Go to Settings → Instagram Account
4. The ID is in the URL or account settings

Adding to NOVA

1. In n8n, go to Credentials → NOVA API
2. Paste your Instagram Access Token
3. Paste your Instagram Business Account ID
4. Save

What You Can Do With Instagram Connected

| Feature | Without IG Token | With IG Token | |---------|-----------------|---------------| | Research niche | ✅ | ✅ | | Create content | ✅ | ✅ | | Design carousels | ✅ | ✅ | | Post to Instagram | ❌ | ✅ | | Get account insights | ❌ | ✅ | | Get post metrics | ❌ | ✅ | | Comment management | ❌ | ✅ | | Hashtag search | ❌ | ✅ |

Full Configuration Guide

🎯 Basic Settings

| Parameter | Options | Default | |-----------|---------|---------| | Operation Mode | Full Cycle / Research / Content / Analyze / Optimize | Full Cycle | | Niche | Any text | fitness | | Target Audience | Any text | millennials | | Growth Goal | Any text | Grow to 10K followers |

🧠 LLM Settings

| Parameter | Options | Default | |-----------|---------|---------| | Model | Any model name | gpt-4o-mini | | Temperature | 0.0 - 2.0 | 0.7 |

🎨 Content & Carousel Settings

| Parameter | Options | Default | |-----------|---------|---------| | Number of Carousels | 1-50 | 5 | | Slides Per Carousel | 3-15 | 7 | | Carousel Style | Minimal / Bold / Neon / Corporate / Dark / Pastel | Minimal | | Sample Design Mode | None / Image URL / HTML Code | None | | Caption Tone | Casual / Professional / Humorous / Educational / Inspirational | Casual | | Hashtag Strategy | Aggressive (25-30) / Moderate (15-20) / Minimal (5-10) | Moderate |

📅 Posting & Timing Settings

| Parameter | Options | Default | |-----------|---------|---------| | Posting Strategy | AI Optimal / Custom / Queue | AI Optimal | | Posts Per Day | 1-10 | 1 | | Manual Times | 24h format | 09:00,12:00,18:00 | | Timezone | Any IANA timezone | UTC | | Min Hours Between Posts | 1-24 | 4 |

🔍 Research Settings

| Parameter | Options | Default | |-----------|---------|---------| | Research Depth | Quick (5min) / Deep (15min) / Exhaustive (30min+) | Deep | | Sources | Reddit / Google Trends / Forums / Competitors / Blogs / Twitter / YouTube / TikTok | Reddit, Trends, Competitors, Blogs | | Competitor Accounts | @handles | (empty) |

🔧 Custom Tools

| Parameter | Description | |-----------|-------------| | Web Scraping | Enable/disable web research | | Reddit Scraping | Monitor subreddits for insights | | Reddit Subreddits | Comma-separated list | | Google Sheets URL | Log results to spreadsheet | | Database URL | Store knowledge base | | Custom API Endpoints | Call any API (one per line) | | Webhook Notifications | Slack/Discord webhook URL |

🛡️ Safety

| Parameter | Default | |-----------|---------| | Shadowban Prevention | On | | Max Actions Per Hour | 20 |

⚙️ Advanced

| Parameter | Default | |-----------|---------| | Custom Instructions | (empty) | | Memory Window | 50 |

Sample Carousel Feature

Option A: Use Built-in Style

Pick a Carousel Style (Minimal, Bold, Neon, Corporate, Dark, Pastel). Done.

Option B: Copy from Image URL

1. Set Sample Design Mode → "Copy Style from Image URL"
2. Paste the URL of a carousel design you like
3. NOVA analyzes the image and matches the style

Option C: Copy from HTML Code

1. Set Sample Design Mode → "Copy Style from HTML Code"
2. Paste your HTML/CSS template
3. NOVA follows your template precisely

Option D: Describe It

Set Design Description to something like:

"Clean white background, large bold black headlines, small gray body text, orange accent color, numbered steps on each slide"

Works with any mode as extra instructions.

Custom Tools & Integrations

Reddit Scraping

Enable to automatically scrape Reddit for:

• Trending topics in your niche
• Audience pain points and language
• Viral content ideas
• Community discussions

Set Reddit Subreddits to comma-separated list: fitness, bodyweightfitness, loseit

Web Scraping

NOVA automatically scrapes the web for research data when enabled.

Google Sheets Logging

1. Create a Google Sheet
2. Go to Extensions → Apps Script
3. Create a webhook that accepts POST requests
4. Deploy as web app
5. Paste the URL in Google Sheets URL

Custom API Endpoints

Add any API endpoints (one per line) that NOVA should call during research:

https://api.example.com/trends
https://api.example.com/content-ideas

Webhook Notifications

Get notified when NOVA completes:

• Slack: Paste your Slack webhook URL
• Discord: Paste your Discord webhook URL
• Any: Any URL that accepts POST with { "text": "..." }

Example Workflows

Daily Auto-Growth

[Schedule: 9am daily] → [NOVA: full_cycle] → [IF: success] → [Slack: notify]

Telegram Bot

[Telegram Trigger] → [NOVA: content_only] → [Telegram: send message]

Weekly Analysis

[Schedule: Monday 9am] → [NOVA: analyze_only] → [Email: send report]

Research Pipeline

[Webhook] → [NOVA: research_only] → [Google Sheets: log results]

Multi-Account

[Schedule: 9am] → [NOVA: full_cycle (fitness)] → [Post to IG]
[Schedule: 12pm] → [NOVA: full_cycle (cooking)] → [Post to IG]

Output Format

{
  "success": true,
  "mode": "full_cycle",
  "niche": "fitness",
  "goal": "Grow to 10K followers",
  "timestamp": "2024-01-15T10:30:00Z",
  "igStatus": {
    "connected": true,
    "username": "your_account"
  },
  "research": {
    "niche": "...",
    "competitors": "...",
    "trends": "...",
    "hashtags": "...",
    "reddit": "...",
    "customApiData": "...",
    "webData": "..."
  },
  "content": "...",
  "hooks": "...",
  "carousels": ["<html>...</html>"],
  "caption": "...",
  "schedule": "...",
  "analyticsPlan": {
    "kpis": ["Engagement Rate (3-6%)", "..."],
    "tracking": "daily"
  },
  "summary": "✅ Full cycle complete. 5 carousels created for 'fitness'. Connected to @your_account."
}

Supported LLMs

| Provider | Models | Speed | Cost | |----------|--------|-------|------| | OpenAI | GPT-4o, GPT-4o-mini | Fast | $0.15-5/1M tokens | | Anthropic | Claude 3.5 Sonnet, Claude 3 Opus | Fast | $3-15/1M tokens | | Google | Gemini Pro, Gemini 1.5 | Fast | Free tier available | | Ollama | Llama 3, Mistral, any local | Varies | Free | | Mistral | Mistral Large, Medium | Fast | $0.25-2/1M tokens | | Groq | Llama 3, Mixtral | Fastest | Free tier | | DeepSeek | DeepSeek Chat | Fast | $0.14-2/1M tokens | | Custom | Any OpenAI-compatible API | Varies | Varies |

Publishing Updates

# Login to npm
npm login

# Bump version
npm version patch   # 1.0.0 → 1.0.1
npm version minor   # 1.0.0 → 1.1.0
npm version major   # 1.0.0 → 2.0.0

# Publish
npm publish

Troubleshooting

| Problem | Solution | |---------|----------| | NOVA not appearing | Restart n8n after install | | LLM API error | Check API key in credentials | | Instagram posting fails | Verify token has instagram_content_publish permission | | No insights data | Ensure token has instagram_manage_insights permission | | Carousel HTML not rendering | Check Playwright endpoint (optional) | | Rate limit errors | Lower "Max Actions Per Hour" |

FAQ

Q: Do I need Docker? A: No! Install via n8n's Community Nodes GUI.

Q: Can I post directly to Instagram? A: Yes! Add your Instagram Graph API token in credentials.

Q: Can I use multiple LLMs? A: Each NOVA node uses one LLM. Add multiple NOVA nodes for different LLMs.

Q: How does it get smarter? A: Each cycle analyzes performance and feeds insights back into content generation.

Q: Can I use my own carousel templates? A: Yes! Paste HTML code in "Sample HTML Code" or point to an image URL.

Q: How much does it cost? A: With GPT-4o-mini: ~$0.01-0.05 per cycle. With Ollama: free.

Q: Does it work with n8n Cloud? A: Yes! Install via Community Nodes GUI.

License

MIT

Links

• npm Package
• n8n Community Nodes
• Instagram Graph API Docs
• Report Issues

Built with ❤️ for the n8n community.