Docs

Everything you need to use Seoable.

What the product is, how the pieces fit together, and how to drive it from an AI assistant or your own code. Read top to bottom, or jump to a section.

01

What is Seoable

Seoable is an SEO product for founders and small teams. It does three things:

  1. Audits your site. What is broken, what is working, and what AI engines like ChatGPT and Claude already say about you.
  2. Writes blog posts. Tens or hundreds at a time, ready to publish on your site.
  3. Plugs into your AI assistant. So you can run audits and queue posts from Claude, Cursor, or ChatGPT, without ever opening a dashboard.

You buy credits. You spend them on audits and posts. There are no monthly seats, no agency layer, no long-form contracts.

If you want to skip ahead and just try it, run npx -y @seoable/install, sign up at /pricing, and ask your assistant.
02

How it works

Three pieces, same model wherever you drive Seoable from.

Projects

One project per website you care about. A project has a domain, a brand description, and a list of competitors. Everything else (audits, posts, the backlog) lives inside a project.

Reports

A report is a piece of work you ordered. There are three kinds:

  • Full audit + posts. The big one. Site health, keyword finds, AI-engine visibility, and a batch of new posts.
  • Audit-only. Same audit, no posts.
  • Posts-only. Skip the audit, just generate posts from your backlog.

You spend credits up front when you order. The result lands on your dashboard when it is ready (usually minutes, not days).

Brand ideas (the backlog)

Each project has a backlog of post ideas. You add them, your assistant adds them, or an audit suggests them. Ideas you approve get written when you order a posts-only or full report.

Three ways to drive it

Same projects, same backlog, same credits, three entry points:

UI
The dashboard
Click around at /dashboard. Best when you want to read a finished report or tweak settings.
MCP
An AI assistant
Talk to Claude, Cursor, or ChatGPT. Best for the day-to-day. See the MCP section below.
API
Your own code
Plain HTTP. Best for automation and product integrations. See the REST API section below.
03

MCP server

MCP stands for Model Context Protocol. It is the standard way AI assistants talk to outside tools. Seoable speaks MCP, so anything you can do in the dashboard, you can do from a chat.

Eighteen tools are wired up: list and read your projects, manage your backlog, order audits and post batches, and pull finished work back. Each call costs the same credits as the dashboard.

Quickstart

Run this once. The installer auto-configures every supported app you have:

npx -y @seoable/install

Then open Claude (or Cursor, ChatGPT, Copilot, Gemini) and ask for what you want. The first call opens a browser tab to sign in with your Seoable account.

04

REST API

Plain HTTP. Pass a Bearer token. Get JSON back. The shape is the same every assistant uses; the API is just the lower-level door.

Quickstart

Grab a key from /dashboard/developers, then:

curl https://api.seoable.dev/v1/me \
  -H "Authorization: Bearer sk_live_..."

The full OpenAPI 3.1 spec lives at api.seoable.dev/openapi.json. An interactive reference you can call from a browser lives at api.seoable.dev/docs.

05

Credits & billing

1 credit = 1 cent. There is no monthly seat or per-user billing. You buy credits and spend them on audits and posts.

New accounts start with a small free balance so you can kick the tires. Top up any time at /dashboard/billing. The dashboard, the assistant, and the API all spend from the same balance.

Pricing for full audits and post batches is on the pricing page.

06

Help

Email [email protected] or use the contact form. We reply same-day, usually within a couple of hours during business hours.

Found a typo or something confusing in these docs? Email us. We will fix it.