🌟 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.