# 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, Shopify, or Framer, or to 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).

## Affiliate Program

Kitful pays 30% commission on every payment from customers you refer. 90-day cookie window,
last-touch attribution, $50 payout threshold, paid monthly. Free to join, no traffic minimum.

- [Affiliate Program](https://kitful.ai/affiliates): Terms, an earnings estimator, and how to join.

---

## 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, or the Kitful plugin), Ghost (Admin API), Shopify, Framer (Framer plugin + CMS collections), Webhook (any platform)
- **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

| Plan    | Price   | Credits/month | Workspaces | Concurrent jobs |
|---------|---------|---------------|------------|-----------------|
| Free    | $0      | 30 (one-time) | 1          | 1               |
| Starter | $39/mo  | 250           | 1          | 10              |
| Pro     | $79/mo  | 750           | Unlimited  | 10              |

Every feature is on both plans; they differ only in credits and workspaces. 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

Out of credits mid-month: buy a top-up at $0.15 per credit, minimum 250. Top-ups need an active plan to buy, never expire, are spent after monthly credits, and stay spendable after a plan ends.

---

## 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 and Starter: 1 workspace; Pro: 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): Plans, 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.
- [Affiliate Program](https://kitful.ai/affiliates): Earn 30% commission on referred customers.
- [AI SEO writer alternatives](https://kitful.ai/alternatives): Kitful next to Outrank, RankYak, BabyLoveGrowth and SEObot, with a link to each comparison.
- [Kitful vs BabyLoveGrowth](https://kitful.ai/compare/babylovegrowth): Kitful next to BabyLoveGrowth on price, websites per plan, refreshing old posts, YouTube and trial.
- [Kitful vs SEObot](https://kitful.ai/compare/seobot): Kitful next to SEObot on price, websites per plan, posts you already have, brand voice and trial.
- [Kitful vs RankYak](https://kitful.ai/compare/rankyak): Kitful next to RankYak on price, websites per plan, YouTube, existing pages and trial.
- [Kitful vs Outrank](https://kitful.ai/compare/outrank): How Kitful compares with Outrank on plans, sites per plan, and refreshing posts from Search Console.
- [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@kitful.ai](mailto:hi@kitful.ai)