# Introduction

> Mentionwell is an AI-powered SEO blog you point at any website. It scans the site, builds a brand profile, generates articles, and serves them through a public read-only API your site pulls from.

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](/docs/quickstart)** — paste 3 env vars, get a working blog in 5 minutes.
- **[Set up your site (full guide)](/docs/setup)** — step-by-step from "I just signed up" to "live on prod".
- **[AI / coding agents](/docs/ai-prompts)** — 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](/docs/api). **Just signed up?** Start with [Quickstart](/docs/quickstart).


---

Canonical URL: https://mentionwell.com/docs
Live HTML version: https://mentionwell.com/docs
Section: Get started
Site index for AI ingestion: https://mentionwell.com/llms.txt
Full reference: https://mentionwell.com/llms-full.txt