Welcome to Mentionwell — the headless SEO blog you wire into any website in under an hour.

What Mentionwell does

1. Scans your destination site (homepage, sitemap, robots.txt, schema, CTAs) and builds a brand + audience profile.
2. Generates a content taxonomy + headlines tuned to your audience and revenue intent.
3. Drafts articles with a planner / writer / critic pipeline, fact-checks claims, and produces clean HTML, Markdown, FAQs, and JSON-LD.
4. Serves the articles via a public read-only API. Your site fetches /blog and /blog/[slug] from Mentionwell on every request (or every revalidation).
5. Optional webhooks notify your site to revalidate its cache the second a post goes live.

Who this is for

• Vibe coders & founders who want a real blog without running a CMS.
• Agencies managing many client sites from one console.
• AI-first product teams who want every article auto-instrumented for ChatGPT / Claude / Perplexity discovery (RSS, JSON Feed, llms.txt, Article schema).

How to read these docs

Three paths, pick whichever fits:

• Quickstart — paste 3 env vars, get a working blog in 5 minutes.
• Set up your site (full guide) — step-by-step from "I just signed up" to "live on prod".
• AI / coding agents — the recommended path for vibe coders. Copy one prompt into Cursor / Claude Code / Lovable / Bolt / v0.

API at a glance

• GET /api/public/{siteSlug}/posts — list published posts
• GET /api/public/{siteSlug}/posts/{slug} — single post with HTML, Markdown, JSON-LD
• GET /api/sites/{siteSlug}/feed.xml — RSS
• GET /api/sites/{siteSlug}/feed.json — JSON Feed
• GET /api/sites/{siteSlug}/sitemap.xml — sitemap

Auth is a single Authorization: Bearer <site-api-key> header on the post endpoints. Feeds are public.

Already deployed? Jump to API reference. Just signed up? Start with Quickstart.