# Kitful

> Kitful (https://kitful.ai) is an AI-powered SEO content platform. It generates humanized, publication-ready long-form articles from a keyword or topic — with images, links, structured headings, and multi-language support — then publishes them directly to WordPress, Ghost, or any platform via webhook.

Kitful is built for bloggers, content marketers, SEO agencies, and developers who need to produce high-quality, search-engine-optimized content at scale. It is not a generic AI chatbot or text spinner — it runs a multi-step research and writing pipeline designed specifically for ranking in Google and surfacing in AI-powered discovery.

---

## Core Product

### Article Generation Pipeline

Every article goes through a fixed 6-step pipeline:

1. **Evidence** — SERP research, Google search, URL context gathering for the keyword
2. **Structure** — Blueprint and outline generation using reasoning to determine format, depth, and section plan
3. **Construct** — Full markdown draft with natural section link insertion
4. **Humanize** — Rewrite pass to improve readability and reduce AI-detection signals
5. **Image Gen** — Optional AI image generation and `[[IMAGE_SLOT]]` replacement
6. **Finalize** — Persist article + Lexical JSON to database, trigger publish schedule if applicable

Generation takes 3–8 minutes. Articles are stored as Lexical JSON and can be exported as Markdown or HTML.

### Autoblog (Campaign Mode)

Autoblog automates content pipelines at scale:
- Create a campaign with a seed topic, description, and keyword limit
- Kitful discovers relevant topics (1 credit per 5 topics)
- Topics are queued and generated on a schedule (daily/weekly at a configured time + timezone)
- Completed articles can auto-publish to a connected integration

### Free Writing Tools (no account required)

Available at https://kitful.ai/write-tools:
- **Blog SEO Checker** — Score any article against what ranks on Google
- **Content Refresh Tool** — Turn a published post into a section-by-section refresh plan
- **SERP Content Analyzer** — Analyze top Google results for a keyword; get search intent and content gaps
- **Blog Outline Generator** — Create structured blog outlines
- **Blog Title Generator** — Generate SEO-friendly titles
- **Meta Description Generator** — Craft meta descriptions for ranking
- **AI Text Humanizer** — Rewrite AI content to bypass detectors
- **Topical Map Generator** — Build topical authority maps around a seed keyword
- **AI Content Brief Generator** — Generate structured content briefs from a keyword
- **Blog Intro Generator** — Draft compelling article intros
- **AI FAQ Generator** — Generate FAQ blocks for articles
- **People Also Ask Finder** — Pull related questions for a keyword
- **llms.txt Generator** — Produce an llms.txt file for any site

---

## Use Cases

- **Autoblogging** (https://kitful.ai/use-cases/autoblogging) — Fully automated publishing pipelines for affiliate sites, SaaS blogs, and content portfolios.
- **YouTube to Blog** (https://kitful.ai/use-cases/youtube-to-blog) — Convert YouTube videos into SEO articles using the source video as primary evidence plus web research.
- **Comparisons** (https://kitful.ai/use-cases/comparisons) — Generate structured comparison articles from product data.

## Directories

- **Tool Directories** (https://kitful.ai/directories) — Curated directories of AI tools, blog platforms, and content resources.
- **Integrations** (https://kitful.ai/integrations) — Overview of all publishing integrations (WordPress, Ghost, Shopify, Framer, Webhooks).

---

## Key Features

- **50+ languages** — Native-quality content generation in any major language (BCP 47 locale codes, e.g. `en`, `fr`, `es-ES`, `pt-BR`, `ja`)
- **Smart links** — Auto-inserts credible external links; internal linking coming soon
- **Rich media** — Finds relevant YouTube videos, selects or generates a featured image, AI image styles: photorealistic, illustration, cartoon, minimalist, painting, artistic, abstract
- **SEO structure** — Proper H1–H4 hierarchy, table of contents, bullet points, FAQ sections, conclusion blocks
- **Promo modes** — `off` (default), `subtle` (weave in brand naturally), `strong` (aggressive product promotion)
- **Publish integrations** — WordPress (REST API + Application Password), Ghost (Admin API), Webhook (any platform), Shopify (coming)
- **Scheduling** — Schedule posts at a specific time + timezone; same-day posts stagger by +1 hour automatically
- **Export** — Download articles as Markdown (`.md`), HTML (`.html`), or ZIP (both) via dashboard or API

---

## Plans & Pricing

| Price    | Credits/month | Workspaces | Concurrent jobs |
|----------|---------------|------------|-----------------|
| $49/mo   | 500           | Unlimited  | 10              |

One plan with everything included. Subscribe to activate your monthly credits and workspace limits immediately.

**Credit costs:**
- Article generation: 10–20 credits (typically 15, varies by settings)
- AI image generation: 2 credits per image
- Content map generation: 10 credits
- Autoblog topic discovery: 1 credit per 5 topics (0.2/topic)

---

## REST API (v1)

Kitful exposes a public REST API for programmatic article generation. Authentication uses opaque API keys with the prefix `kit_`, passed as `Authorization: Bearer kit_xxx`.

Get an API key at: https://kitful.ai/settings → API Keys

### Endpoints

**Generate article**
```
POST https://kitful.ai/api/v1/articles/generate
```
Body:
```json
{
  "focusKeyword": "string (required, max 300 chars)",
  "context": "string (optional, max 1000 chars)",
  "spaceSlug": "string (optional — workspace slug; defaults to primary workspace)",
  "settings": {
    "language": "string (BCP 47, e.g. 'en', 'fr', 'es-ES')",
    "promoMode": "off | subtle | strong",
    "brandUrl": "string (URL to weave into article)",
    "useFeaturedImage": "boolean",
    "useImages": "boolean",
    "useVideo": "boolean",
    "useFaqs": "boolean",
    "useConclusion": "boolean",
    "wordWrap": "balanced | long",
    "viewPoint": "auto | first_plural | first_singular | second | third",
    "imageStyle": "photorealistic | illustration | cartoon | minimalist | painting | infographic | 3d | line-art"
  }
}
```
Returns `202` with `{ jobId, status: "pending" }`.

**Poll status**
```
GET https://kitful.ai/api/v1/articles/status/:jobId
```
Returns `{ jobId, status, currentStep, articleId, articleUrl }`.

`status` values: `pending`, `in-progress`, `completed`, `failed`
`currentStep` values: `evidence`, `structure`, `construct`, `humanize`, `image_gen`, `finalize`

**Export article**
```
GET https://kitful.ai/api/v1/articles/:articleId/export?format=markdown|html|zip
```
Returns the article as a file download. `zip` bundles both Markdown and HTML.

All error responses: `{ "error": "message" }` with appropriate HTTP status codes.
- `401` — Invalid or missing API key
- `402` — Insufficient credits
- `404` — Resource not found
- `429` — Concurrent generation limit reached

---

## OpenClaw Skill

Kitful has an official OpenClaw skill (`kitful`) published on ClawHub:
https://clawhub.com/skills/kitful

Install: `clawhub install kitful`

The skill lets users generate SEO articles via natural language from any OpenClaw-compatible AI agent. It uses the v1 REST API internally.

---

## Account & Workspace Model

- Each account has one or more **workspaces** (called "spaces" internally)
- Free plan: 1 workspace; Starter (paid): unlimited
- Articles, integrations, autoblog campaigns, and schedules all belong to a workspace
- API keys belong to the account and can access any workspace the account owns
- Workspace is identified by a `slug` (URL-friendly name chosen at creation)

---

## Important URLs

- Homepage: https://kitful.ai
- Docs: https://docs.kitful.ai
- Dashboard: https://kitful.ai/app (redirects to primary workspace)
- Settings & API Keys: https://kitful.ai/settings
- Billing: https://kitful.ai/billing
- Writing Tools: https://kitful.ai/write-tools
- Use Cases: https://kitful.ai/use-cases/autoblogging
- Integrations: https://kitful.ai/integrations
- Directories: https://kitful.ai/directories
- Blog: https://kitful.ai/blog
- Privacy Policy: https://kitful.ai/privacy
- Terms of Service: https://kitful.ai/terms
- Contact: hi@hreflabs.com