Skip to content

Chirag-is-a-dev/SocialForge-AI

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 

Repository files navigation

SocialForge AI — Elite AI-Powered Social Media Content Generator

Transform a single brief into fully scheduled, platform-native content across 6 social networks — automatically.

n8n Gemini Flux Kling License

Overview

SocialForge AI is a fully automated n8n workflow that takes a content brief and produces SEO-optimized, platform-native posts for LinkedIn, Facebook, Instagram, X (Twitter), WhatsApp, and Telegram — complete with AI-generated images and videos — and schedules them for peak engagement times, all with human-in-the-loop approval via Gmail.

No more manually rewriting the same post six times. Fill out a form, approve the draft, and let the pipeline do the rest.


Features

  • Multi-platform content generation — tailored copy for LinkedIn, Facebook, Instagram, X, WhatsApp, and Telegram
  • SEO-optimized output — keyword integration, intent mapping, and platform-specific hashtag strategies
  • AI image generation — via Flux 1.1 Pro Ultra Finetuned (Replicate)
  • AI video generation — via Kling v1.6 Standard (Replicate)
  • Human approval gate — Gmail-based approve/reject flow before anything goes live
  • Smart scheduling — posts go out at optimal times per platform
  • Multilingual support — generate content in any language
  • Structured JSON output — automation-ready, fully parseable

Workflow Architecture

Form Submission
      │
      ▼
 AI Agent (Gemini)
  ├── SEO Strategy
  ├── Platform Content (6 platforms)
  ├── Hashtag Sets
  └── AI Prompts
      │
      ▼
Image Generation (Flux 1.1 Pro Ultra)
      │
      ▼
Video Generation (Kling v1.6)
      │
      ▼
Wait for Generation (~2.5 min)
      │
      ▼
Gmail Approval Request
      │
   ┌──┴──┐
APPROVE  REJECT
   │        │
   ▼        ▼
Schedule  Rejection
& Publish  Email
   │
   ├── Facebook  → 15:00
   ├── LinkedIn  → 13:30
   ├── Telegram  → 18:00
   ├── Twitter/X → 17:30
   ├── Instagram → 11:30
   └── WhatsApp  → immediate

Tech Stack

Component Tool
Workflow Engine n8n
LLM Google Gemini (via LangChain node)
Image Generation Flux 1.1 Pro Ultra Finetuned
Video Generation Kling v1.6 Standard
Approval & Notifications Gmail (OAuth2)
Social Publishing LinkedIn, Facebook Graph API, Instagram Graph API, Twitter/X, Telegram Bot, WhatsApp API

Setup & Configuration

Prerequisites

  • n8n instance (self-hosted or cloud)
  • Google Gemini API key
  • Replicate API token
  • Credentials for each social platform you intend to publish to

1. Import the Workflow

  1. Copy the workflow JSON file
  2. In n8n, go to Workflows → Import from File
  3. Paste or upload the JSON

2. Configure Credentials

Set up the following credentials in n8n's Credentials panel:

Credential Node(s)
Google Gemini (PaLM API) AI Agent, Auto-fixing Output Parser
Gmail OAuth2 Wait For Approval, Content Rejected
Facebook Graph API Facebook, Instagram_Container_ID, Instagram
LinkedIn OAuth2 Linkedin
Twitter OAuth2 Create Tweet
Telegram API Send a text message
WhatsApp API Send message

3. Configure Replicate

In the Image Generation and Video Generation HTTP Request nodes, replace the placeholder values:

"Authorization": "Token YOUR_REPLICATE_TOKEN"
"finetune_id": "YOUR_FLUX_FINETUNE_ID"

4. Configure Telegram

In the Send a text message node, replace Your Chat ID with your Telegram channel or chat ID.

5. (Optional) Adjust Posting Schedule

The scheduling times are defined in each Code node. Edit the platformTimes object to match your audience's timezone:

const platformTimes = {
  telegram:  "18:00",
  linkedin:  "13:30",
  twitter:   "17:30",
  facebook:  "15:00",
  instagram: "11:30"
};

Usage

  1. Trigger the workflow — navigate to the form URL generated by the On form submission trigger node
  2. Fill in the form fields:
Field Description
Content Topic/Brief What you want to post about
Tone Professional, Casual, Humorous, Inspirational, Educational, or Promotional
Target Audience Who the content is for
Key Message/CTA Main takeaway or call-to-action
Keywords/Hashtags SEO keywords or specific hashtags to include
Language Output language for all content
  1. Wait — the AI generates copy, an image, and a video (~3–5 minutes total)
  2. Review — you'll receive a Gmail approval request with all content previews
  3. Approve or Reject — click Approve to schedule publishing, or Reject to receive a notification email and halt the workflow
  4. Done — approved content is automatically posted to each platform at its scheduled time

Output Structure

The AI Agent returns a structured JSON object used throughout the workflow:

{
  "meta": { ... },
  "seo_strategy": { ... },
  "platform_content": {
    "linkedin": { "post_text": "...", "cta": "...", "hashtags": [...] },
    "facebook": { ... },
    "instagram": { ... },
    "twitter_x":  { "post_text": "...", "thread": [...] },
    "whatsapp": { ... },
    "telegram": { ... }
  },
  "ai_prompts": {
    "image_generation": { "platform_prompts": { ... } },
    "video_generation":  { "platform_prompts": { ... } }
  },
  "automation_notes": { ... }
}

Roadmap

  • Google Sheets / Airtable input source for batch content generation
  • Analytics feedback loop (pull post performance back into the workflow)
  • Support for Pinterest and TikTok
  • Slack notification option alongside Gmail approval
  • Multi-brand / multi-account support

Contributing

Pull requests are welcome! For major changes, please open an issue first to discuss what you'd like to change.

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

License

Distributed under the MIT License. See LICENSE for more information.


Acknowledgements


Built with ❤️ using n8n + Gemini + Flux + Kling

About

AI-powered n8n workflow that generates SEO-optimized social media content for 6 platforms with auto-scheduling and human approval

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors