pepebits/ghost-connector repository overview

AI subagents that finish, optimize (SEO) and illustrate your Ghost⁠ drafts — and hand them back for you to review. A web panel for you or your team, plus a CLI.

📖 Full documentation: github.com/Pepebits/ghost-connector⁠

⁠✨ What it does

• ✍️ Completes or improves drafts, in the draft's own language, live as it writes
• 🔎 SEO: meta, slug, tags, social cards, a quality score and Fix with AI
• 🖼️ Featured images from Unsplash, Pixabay, Pexels, Openverse and Wikimedia Commons, with attribution
• ✅ Block-by-block review, history and undo
• 💡 Ideas from Google Search Console and Bing Webmaster Tools
• 🤖 DeepSeek, Claude or any OpenAI-compatible API, with a daily spending cap
• 👥 Users with roles (owner, admin, editor), 2FA, invites, notes and an activity log

⁠🚀 Quick start

mkdir -p ghost-data && cd ghost-data/..
# Configure step by step (Ghost Admin API key, AI provider key…):
docker run --rm -it -v "$PWD/ghost-data:/data" pepebits/ghost-connector setup
# Start the panel on http://127.0.0.1:4300
docker run -d --name ghost-connector --restart unless-stopped \
  -v "$PWD/ghost-data:/data" -p 127.0.0.1:4300:4300 pepebits/ghost-connector

Open http://127.0.0.1:4300 and create the first user right away: until it exists, whoever opens the panel becomes its owner.

A ready-made docker-compose.yml⁠ (with an optional Cloudflare Tunnel) is in the repository.

⁠📦 Image

Any CLI command runs the same way: docker run --rm -v "$PWD/ghost-data:/data" pepebits/ghost-connector list. Full backup from a running container: docker exec ghost-connector ghost-connector backup.

⁠🔒 Security

Users with scrypt passwords and optional TOTP 2FA, owner-only API keys, draft-only writes with Ghost revisions. Report vulnerabilities as described in SECURITY.md⁠.

MIT⁠ © PEPEBITS⁠