# Kitful

> Kitful ([kitful.ai](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

Kitful doesn't answer from a single prompt. Every article is built through deep, grounded research and several dedicated quality passes:

- **Grounded research** — Kitful studies the live search results, competing pages, and real sources for your keyword, so each article stands on current evidence instead of a model's memory.
- **Intent-first structure** — It plans the format, depth, and section-by-section angle to match what searchers and AI assistants are looking for before writing a word.
- **Human-quality writing** — Articles are written and humanized for a natural, on-brand voice and readability, with every fact and claim tied back to the research.
- **Publish-ready by default** — Structured headings, internal and external links, optional on-brand images, FAQs, and multi-language support are built in.

Most articles are ready in 3–8 minutes, and export as Markdown or HTML or publish straight to your platform.

### Autoblog (Campaign Mode)

Autoblog automates content pipelines at scale:
- Create a campaign with a seed topic, description, and keyword limit
- Seed the first topic map for 20 credits; bounded automatic refills are included
- Topics are queued and generated on a schedule (daily/weekly at a configured time + timezone)
- Completed articles cost 20 credits plus 2 credits per successful generated image and can auto-publish to a connected integration

### Free Writing Tools (no account required)

All 12 tools are listed at [Free AI Writing Tools](https://kitful.ai/write-tools):

- [Blog SEO Checker](https://kitful.ai/write-tools/blog-seo-checker): Score any article against what ranks on Google
- [Content Refresh Tool](https://kitful.ai/write-tools/content-refresh-tool): Turn a published post into a section-by-section refresh plan
- [SERP Content Analyzer](https://kitful.ai/write-tools/serp-content-analyzer): Analyze top Google results for a keyword; get search intent and content gaps
- [Blog Outline Generator](https://kitful.ai/write-tools/blog-outline-generator): Create structured blog outlines
- [Blog Title Generator](https://kitful.ai/write-tools/blog-title-generator): Generate SEO-friendly titles
- [Meta Description Generator](https://kitful.ai/write-tools/meta-description-generator): Craft meta descriptions for ranking
- [Topical Authority Map Generator](https://kitful.ai/write-tools/topical-map-generator): Build topical authority maps around a seed keyword
- [AI Content Brief Generator](https://kitful.ai/write-tools/ai-content-brief-generator): Generate structured content briefs from a keyword
- [Blog Introduction Generator](https://kitful.ai/write-tools/blog-intro-generator): Draft compelling article intros
- [AI FAQ Generator (JSON-LD)](https://kitful.ai/write-tools/ai-faq-generator): Generate FAQ blocks for articles
- [People Also Ask (PAA) Finder](https://kitful.ai/write-tools/people-also-ask-finder): Pull related questions for a keyword
- [llms.txt Generator](https://kitful.ai/write-tools/llms-txt-generator): Produce an llms.txt file for any site

---

## Use Cases

- [Features overview](https://kitful.ai/features): Every part of the writing loop, from research to publishing.
- [YouTube to Blog](https://kitful.ai/features/youtube-to-blog): Convert YouTube videos into SEO articles using the source video as primary evidence plus web research.
- [Comparisons](https://kitful.ai/features/comparisons): Generate structured comparison articles from product data.
- [Research](https://kitful.ai/features/research): Decide what to write next, with a rationale behind every title.
- [Optimize](https://kitful.ai/features/optimize): Act on Google Search Console data to refresh and improve published pages.
- [Campaigns](https://kitful.ai/features/campaigns): Run a publishing cadence, manually or on autopilot.

## 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 |
|----------|---------------|------------|-----------------|
| $79/mo   | 500           | Unlimited  | 10              |

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

**Credit costs:**
- Article generation or rewrite: 20 credits
- AI image generation: 2 credits per image
- Explore research: 10 credits
- Content map generation or campaign seeding: 20 credits
- Manual campaign refill: 5 credits; bounded automatic refill is included

---

## 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 [Settings](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: `research`, `construct`, `image_gen`, `finalize` (older jobs may report legacy values such as `humanize`)

**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: [clawhub.com/skills/kitful](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): What Kitful does and who it is for.
- [Docs](https://kitful.ai/docs): Product documentation and API reference.
- [Pricing](https://kitful.ai/pricing): Plan, credits, and what each action costs.
- [Dashboard](https://kitful.ai/app): Redirects to the primary workspace.
- [Settings & API Keys](https://kitful.ai/settings): Account settings and `kit_` API key management.
- [Billing](https://kitful.ai/billing): Subscription, credits, and invoices.
- [Writing Tools](https://kitful.ai/write-tools): Free tools, no account required.
- [Features](https://kitful.ai/features): Research, writing, optimize, campaigns, and formats.
- [Integrations](https://kitful.ai/integrations): WordPress, Ghost, Shopify, Framer, and webhooks.
- [Directories](https://kitful.ai/directories): Curated tool and platform directories.
- [Blog](https://kitful.ai/blog): Articles on SEO and AI content.
- [Privacy Policy](https://kitful.ai/privacy): How Kitful handles data.
- [Terms of Service](https://kitful.ai/terms): Terms of use.
- Contact: [hi@hreflabs.com](mailto:hi@hreflabs.com)