DOCS / INTRODUCTION

Build a blog that AI engines cite.

Mentionwell is the headless, AI-optimized blog you wire into any website in under an hour. Pull articles from a public read-only API, or push them straight into your CMS. Every post ships with FAQ + Article JSON-LD, an .md mirror, RSS, JSON Feed, and a site-wide llms.txt for AI ingestion.

Quickstart API reference

GET STARTED

Get started

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.

Quickstart

Get a working /blog page on your site in under 5 minutes. Three env vars, one fetch call.

Set up your site (full guide)

End-to-end walkthrough from new account to live on production: site profile, taxonomy, first article, deployment, custom domain.

How it works

Mental model: sites, headlines, drafts, posts, runs, taxonomy. The pull-based delivery model. Why Mentionwell is headless, not a CMS.

Authentication

How the per-site read API key works, where to find it, how to rotate it, and why feeds are public but posts are not.

Connect wizard

The one-stop tool that figures out which delivery mechanism fits your stack and walks you through wiring it up. Five architectures, one workflow.

Custom articles

Write a one-off article from a pasted brief, source URLs, or breaking news — the writer treats your context as authoritative ground truth.

QUICKSTARTS BY STACK

Quickstarts by stack

Next.js (App Router)

Add /blog and /blog/[slug] to a Next.js App Router site with ISR and tag-based revalidation.

Next.js (Pages Router)

Same integration but for legacy Pages Router projects.

React + Vite / CRA

Add a blog to a client-rendered React app via a thin server proxy that hides the API key.

Astro

Static-first integration with Astro using getStaticPaths and on-demand fetching.

SvelteKit

+page.server.ts loaders for index and detail.

Nuxt 3

Server route + composable for SSR + ISG.

Remix / React Router 7

Loader-based SSR for both Remix and React Router 7 framework mode.

Plain HTML / JS

Drop-in script for static sites with no framework.

WordPress

Render Mentionwell posts inside WordPress without writing a plugin.

PUBLISH TO YOUR CMS

Publish to your CMS

Overview

Push articles directly into your existing CMS (WordPress, Webflow, Ghost, Shopify, Notion, etc.) instead of rendering them from Mentionwell's API.

WordPress (self-hosted)

Push Mentionwell articles into a self-hosted WordPress site via the REST API and Application Passwords.

Webflow

Push Mentionwell articles into Webflow's CMS via the Data API v2 so they render natively in your Webflow site.

Ghost

Push Mentionwell articles into a Ghost CMS site via the Admin API. Articles appear natively in Ghost admin and on your published Ghost site.

Shopify

Push Mentionwell articles into Shopify's built-in blog so they appear at /blogs/{handle}/{article-handle}.

Notion

Push Mentionwell articles into a Notion database. Pair with Super.so, Potion, or Feather.so to render a public blog.

NO-CODE & AI BUILDERS

No-code & AI builders

AI / coding agents

Copy-paste setup prompts for Cursor, Claude Code, Lovable, Bolt, v0, ChatGPT, Replit, Windsurf.

No-code (Webflow, Framer, etc.)

How to render Mentionwell posts inside Webflow, Framer, Squarespace, Shopify, etc.

API REFERENCE

API reference

All public endpoints: list posts, get post, RSS, JSON Feed, sitemap, errors. With request/response shapes and per-language snippets.

Webhooks

Signed publish and revalidation calls to your destination site. HMAC signing, payload schema, delivery status.

SDK REFERENCE

SDK reference

mentionwell

Tiny TypeScript SDK around the public API: getBlogPostsViaApi, getBlogPostViaApi, getAllBlogSlugsViaApi, prepareArticleHtml.

Styling & theming

How to style the wb-* classes Mentionwell emits, override the defaults, or write your own theme from scratch.

INTRODUCTION

The long form intro

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

What Mentionwell does

Scans your destination site (homepage, sitemap, robots.txt, schema, CTAs) and builds a brand + audience profile.
Generates a content taxonomy + headlines tuned to your audience and revenue intent.
Drafts articles with a planner / writer / critic pipeline, fact-checks claims, and produces clean HTML, Markdown, FAQs, and JSON-LD.
Serves the articles via a public read-only API. Your site fetches /blog and /blog/[slug] from Mentionwell on every request (or every revalidation).
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

Four paths, pick whichever fits:

Connect wizard — the in-product 3-step flow. Pick your architecture (Static / Next.js ISR / Dynamic / GitHub / CMS), get the right env vars + receiver, test the connection live. Recommended starting point for almost everyone.
Quickstart — paste 3 env vars, get a working blog in 5 minutes (what the wizard does, manually).
Set up your site (full guide) — step-by-step from "I just signed up" to "live on prod".
AI / coding agents — paste one prompt into Cursor / Claude Code / Lovable / Bolt / v0 and let the agent wire it up for you.

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.

Read this page as Markdown