Posthive

Agentic social media scheduler to post on multi platforms with built-in MCP

Digital Marketing & SEOTypeScriptAGPL-3.0

Abstract

Posthive is an open-source Digital Marketing & SEO project. Agentic social media scheduler to post on multi platforms with built-in MCP. The agentic social media scheduling platform with built-in AI agent support. Schedule posts across platforms from one place self-hostable, no vendor lock-in. It is built using TypeScript, Next.js. Key capabilities include: Multi-platform posting - write once, publish to 14+ platforms simultaneously; AI agent support - connect Claude, ChatGPT, Cursor, VS Code via MCP; OAuth 2.0 + PKCE, no API key to paste; Calendar view - FullCalendar month/week/day with drag-to-reschedule. The complete source code is publicly available on GitHub under the GNU Affero General Public License v3.0, making it a useful reference for students building a Digital Marketing & SEO mini project or final-year project.

1. Introduction

The agentic social media scheduling platform with built-in AI agent support. Schedule posts across platforms from one place self-hostable, no vendor lock-in.

2. Objective

Agentic social media scheduler to post on multi platforms with built-in MCP

This project demonstrates how TypeScript, Next.js can be applied to a real-world Digital Marketing & SEO problem.

3. Key Features / Modules

  • Multi-platform posting - write once, publish to 14+ platforms simultaneously
  • AI agent support - connect Claude, ChatGPT, Cursor, VS Code via MCP; OAuth 2.0 + PKCE, no API key to paste
  • Calendar view - FullCalendar month/week/day with drag-to-reschedule
  • Bulk CSV scheduling - upload a spreadsheet to schedule hundreds of posts at once
  • Post templates - save and reuse post drafts
  • First comment scheduling - auto-reply immediately after the post goes live
  • Per-platform overrides - custom text and first comment per account
  • Instagram Reels & Stories - full media type support including carousels
  • YouTube Shorts & videos - dedicated title/description fields, custom thumbnail upload
  • Dry run mode - test the full pipeline without real API calls

4. Technology Stack

TypeScriptNext.js

5. System Requirements

General requirements for this technology stack — check the README for exact versions.

  • Node.js (LTS) and npm / yarn / pnpm
  • VS Code or any code editor
  • Git (to clone the repository)

6. Installation & Setup

git clone https://github.com/AstaBlackClove/posthive.git
cd posthive
git clone https://github.com/AstaBlackClove/posthive.git
cd posthive
cp apps/api/.env.example .env
# Fill in ENCRYPTION_KEY, JWT secrets, DATABASE_URL, REDIS_URL
docker compose up -d --build
pnpm install
cp apps/api/.env.example apps/api/.env
pnpm dev        # starts API + Web + Postgres (Docker)

Full setup instructions are in the project README.

7. Future Enhancements

Suggested extensions you can add to make this your own project.

  • Export reports to Google Sheets or PDF
  • Schedule weekly automated reports
  • Add competitor comparison

8. Viva / Review Questions

Common questions examiners ask for projects in this domain.

  1. Which marketing or SEO problem does this tool solve?
  2. Which data sources or APIs does it use (Search Console, Analytics, social platforms)?
  3. Which metrics or KPIs does it report and how are they calculated?
  4. How could the output help a business make decisions?
  5. How would you schedule it to run automatically?

9. Source Code & License

This project is developed by AstaBlackClove and published on GitHub under the GNU Affero General Public License v3.0. Please follow the license terms and credit the original author when you use or modify this code.

View Source on GitHubDownload ZIP

Want to build this as your internship project?

Work on a Digital Marketing & SEO project like this with mentor guidance, weekly reviews and an internship certificate from Training Trains, Erode — online or offline.

Apply for Digital Marketing & SEO Internship