Bullhorn

Abstract

1. Introduction

Social media post scheduler for Twitter, LinkedIn, and Reddit.

Plan, draft, and schedule your social media content. Organize posts into campaigns and projects, set publish dates, and manage your content pipeline from idea to published.

See the Self-Hosting Guide for detailed setup instructions.

2. Objective

Agent-first social media scheduler that works from your IDE via MCP. Not an auto-poster or AI slop machine — a workspace for thoughtful devs and product leaders who use Claude Code, Codex, and other agentic tools to craft, iterate on, and schedule real content alongside their code. iOS app included.

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

3. Key Features / Modules

• Multi-platform drafting — Write posts for Twitter, LinkedIn, and Reddit with platform-specific formatting and character limits
• Campaigns & projects — Organize posts into campaigns, group campaigns into projects
• Scheduling — Set publish dates and track your content pipeline
• Blog drafts — Long-form content with Markdown support
• Launch posts — Dedicated workspace for product launch announcements
• Media uploads — Attach images with drag-and-drop, stored in Supabase Storage
• API & MCP server — Programmatic access via API keys, plus an MCP server for AI-native workflows
• iOS app — Native iOS app via Capacitor (TestFlight)
• Push notifications — Web push and iOS push for scheduled post reminders
• Community events — Calendar of social media events with nudge reminders

4. Technology Stack

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/mean-weasel/bullhorn.git
cd bullhorn

npm install
cp .env.example .env.local
# Fill in your Supabase credentials (see docs/environment-variables.md)
make dev

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 mean-weasel 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.