BlogFactory

Start · Product guide

Getting started

Understand the operating model, start locally, and create one safe self-hosted operator account.

6 min readSource on GitHub ↗

What BlogFactory does

BlogFactory is a draft-only control plane for multi-site content operations. Agents work through MCP; people retain review, approval, and the final handoff to a CMS.

The loop is deliberately narrow: source evidence → agent work or caller-authored draft → revision and SEO metadata → human review and preflight → a selected CMS destination as a draft. Live publishing, deletion, credential access, and arbitrary provider administration are outside the agent boundary.

Start a local development instance

The repository is an npm workspace with a React/Vite web app, a Hono API, PostgreSQL, and S3-compatible storage. Add only the integration credentials you need for the flow you are testing.

Terminal
git clone https://github.com/BlogFactoryHQ/blogfactory.git
cd blogfactory
npm install
cp .env.example .env
npm run db:migrate
npm run dev

Verify the first run

  1. Open the web control plane at http://localhost:8080 and the API at http://localhost:3000.
  2. Create an administrator account only through the environment-gated self-hosted bootstrap path.
  3. Add one site, then use Overview and Review Queue to see the operational context MCP will read.