Runs on Node.js 22+ No npm dependencies Multi-tenant SaaS 15 connectors

BotMaster AI

BotMaster AI is a multi-tenant SaaS for social listening and AI replies. It crawls 17 social networks and forums on a schedule, picks out posts that show buying intent, and replies to them, automatically or after you approve the draft.

Features

🌐 15 connectors, 16 platforms

Twitter/X v2, Reddit, YouTube, Threads, Instagram, Bluesky, Mastodon, GitHub Discussions, Discord, Telegram, Hacker News, TikTok, Pinterest, Discourse, Disqus, and Quora. With an Apify token, LinkedIn, Instagram public posts, TikTok, X, Reddit, YouTube and Quora can also be read on a schedule where there's no usable search API.

🎯 Competitors, reviews and AI visibility

Switch alerts when people talk about leaving a competitor, 1–3 star reviews on G2, Capterra, Trustpilot and Google Maps (with Apify), "why customers leave" themes, AI answer visibility across ChatGPT, Gemini, Perplexity, Claude and Google AI Overviews, and the cited pages that name competitors but not you.

🌐 Set up from a website

New workspaces enter their address and get a suggested brand profile, keywords and competitors to review before saving.

🧠 AI replies

Google Gemini (Flash by default; you can pick the model in /admin), a 0 to 100 tone slider (Professional, Balanced, Witty), memory of earlier turns in a thread, filtering of negative-sentiment posts, and a manual approval queue.

💳 Stripe and Razorpay payments

Stripe Checkout (USD) and Razorpay (INR) with signed webhooks, server-side pricing and idempotent fulfillment. Subscription tiers are editable, and each payment gets a tax invoice.

📧 Email and webhooks

Welcome emails and tax receipts go out through Resend, SendGrid or the local sandbox simulator. Alerts can go to Slack (Block Kit) and Microsoft Teams.

🔒 Security

Signed sessions, scrypt password hashing, role-based admin access, masked secrets and per-tenant data isolation. Google and Apple sign-in check verified ID tokens; turn them on by adding client IDs in /admin.

First admin login

There are no default passwords in production. On first start the superadmin is created from the ADMIN_EMAIL / ADMIN_PASSWORD environment variables; if ADMIN_PASSWORD is unset, a random one-time password is printed to the server log.

The sample accounts below exist only on demo servers started with DEMO_MODE=true:

Role	URL	Email	Password
Superadmin (demo)	`/admin`	`[email protected]`	`admin123`
Demo user (demo)	`/app`	`[email protected]`	`demo123`

Installation and deployment

BotMaster AI has no external npm dependencies. It runs on Node.js 22 or later, or in Docker.

1. Local development (about a minute)

node -v # Verify Node.js is 22 or higher
cd social-bot-platform
npm start

Open http://localhost:3000 in your browser.

2. Production with Docker Compose

docker compose up -d
docker compose ps

This mounts ./data at /app/data, so the SQLite database survives container updates.

3. Linux VPS (systemd + Nginx SSL)

INSTALLATION_GUIDE.md has systemd unit file templates, an Nginx reverse proxy config and the steps for a free Let's Encrypt certificate.

Superadmin manual

Open the admin console at http://localhost:3000/admin with the superadmin created from ADMIN_EMAIL / ADMIN_PASSWORD (or the one-time password printed to the server log on first start).

What the superadmin can do

Create, edit, suspend or delete tenant workspaces. Each one keeps its data separate.
Add, edit or archive subscription plans without a restart.
Set Stripe and Razorpay test or live credentials and webhook secrets.
Choose the email provider (local simulator, Resend or SendGrid) and send a test email.
Set up Slack and Teams incoming webhooks (Block Kit and MessageCard formats).
Read and answer support tickets sent from the help center.

The full walkthrough is in ADMIN_MANUAL.md.

Connectors and API keys

What each of the 16 supported networks needs. There are 15 connector modules because one Meta connector covers both Threads and Instagram.

Platform	Method	Keys required
Hacker News	Algolia Search API	None (free public API)
Bluesky	AT Protocol XRPC	Handle and app password
Mastodon	REST (per instance)	Instance URL and access token
GitHub	Discussions / Issues	Personal access token
Discord	Bot and webhooks	Bot token and channel webhook
Telegram	Bot API	Bot token (from @BotFather) and chat ID
Twitter / X	API v2 REST	API key and secret, access token and secret (OAuth 1.0a); bearer token for search
Reddit	OAuth 2.0	Client ID, secret, username, password
YouTube	Data API v3	Google Cloud API key
Threads / Instagram	Meta Graph API	Meta app ID, secret, access token
TikTok & Pinterest	Developer APIs	Client key, secret and access token
Discourse & Disqus	Community APIs	Base URL and API key
Quora	Radar assistant	None: built-in search radar and one-click reply generator

Step-by-step instructions are in CONNECTORS_GUIDE.md.

REST API reference

The main HTTP endpoints. API_REFERENCE.md has the full list with payload examples.

GET /api/state: workspace settings and metrics
POST /api/auth/register: registers a tenant and starts onboarding
POST /api/crawl/cycle: runs a keyword crawl now
POST /api/queue/approve: approves a queued reply and posts it
POST /api/payment/checkout: takes a payment and emails the invoice
POST /api/admin/email/test: sends a test email
POST /api/webhook/test: sends a test Slack or Teams alert

CodeCanyon item description

The item description, as HTML ready to paste, is in CODECANYON_ITEM_DESCRIPTION.html.

Title: BotMaster AI — Autonomous Omnichannel Social Listening & Auto-Reply SaaS Platform

Tags: ai bot, social listening, auto reply, gemini flash, multi tenant saas, stripe billing, twitter bot, reddit bot, youtube bot, discord bot, threads bot, lead generation, marketing automation, nodejs saas, docker

Pricing: Regular: $49 to $69 | Extended: $199 to $299

Packaging and submission checklist

The package layout and the checklist to run before submitting are in MARKETPLACE_SUBMISSION_CHECKLIST.md.

Commercial license

BotMaster AI Commercial License (Regular & Extended)
(c) 2026 BotMaster AI. All Rights Reserved.
See LICENSE.txt in the root directory for the complete legal text.

Changelog

Release notes for each version are in CHANGELOG.md.