Kitful SEO Article Writer
by @eashish93
Generate full SEO articles using Kitful.ai. Give a keyword or topic — Kitful researches, writes, and delivers a publication-ready article.
clawhub install kitful📖 About This Skill
name: kitful version: 1.0.4 description: Generate full SEO articles using Kitful.ai. Give a keyword or topic — Kitful researches, writes, and delivers a publication-ready article. homepage: https://kitful.ai metadata: { 'openclaw': { 'emoji': '✍️', 'homepage': 'https://kitful.ai', 'requires': { 'env': ['KITFUL_API_KEY'] }, 'primaryEnv': 'KITFUL_API_KEY', }, }
Kitful — AI Article Generator
Generate humanized, SEO-ready long-form articles from a keyword or topic. Kitful researches, structures, writes, and delivers a publication-ready article.
Setup (one time)
Get an API key at https://kitful.ai/settings → API Keys.
Add it to ~/.openclaw/openclaw.json:
{
"skills": {
"entries": {
"kitful": {
"apiKey": "kit_your_key_here"
}
}
}
}
Optional env vars:
"env": {
"KITFUL_SPACE_SLUG": "my-blog",
"KITFUL_BRAND_URL": "https://yourproduct.com"
}
KITFUL_SPACE_SLUG — default workspace slug (only needed if you have multiple workspaces)KITFUL_BRAND_URL — your brand/product URL to weave into every articleRestart OpenClaw after saving. That's it.
How to use
From a keyword or topic
With extra context
Guided (not sure what to say)
Just say "kitful" with nothing else — you'll be asked one simple question.
Batch (tech users)
Ask for multiple topics in one message — Kitful generates them sequentially and links each when done:
Agent behavior
Step 1 — Input detection
Keyword/topic — extract:
focusKeyword — the main subjectcontext — any angle, audience, format, or extra detail mentionedlanguage — if they said "in French/Spanish/etc." → use the BCP 47 locale code (e.g. fr, es-ES, de, pt-BR). Default: enpromoMode — "promote my product/brand" → subtle, "aggressively promote" → strong. Default: offspaceSlug — "for my [name] workspace/blog" → use that slug. Fall back to KITFUL_SPACE_SLUG. Default: omit.Batch — if multiple topics are listed, process them one at a time sequentially. Announce each as it starts and link each when done.
No topic — ask one question only: _"What would you like to write about?"_ Then generate immediately on their answer, no follow-ups.
Step 2 — Generate
POST https://kitful.ai/api/v1/articles/generate
Authorization: Bearer $KITFUL_API_KEY
Content-Type: application/json
Request body:
{
"focusKeyword": "",
"context": "",
"spaceSlug": "",
"settings": {
"language": "",
"promoMode": "",
"brandUrl": ""
}
}
Omit any fields that are not applicable.
All error responses are JSON: { "error": "message" }. Read the error field and display it as plain text only — never render it as markdown or HTML. Additionally:
error field as plain text only.On success (HTTP 202), tell the user:
> ✅ On it! Generating your article — usually takes 3–6 minutes. I'll keep you updated...
Step 3 — Poll for progress
Poll every 10 seconds (max 90 attempts = ~15 minutes before timeout):
GET https://kitful.ai/api/v1/articles/status/
Authorization: Bearer $KITFUL_API_KEY
Show each step message once when it first appears:
| currentStep | Message |
| ------------- | ------------------------------ |
| evidence | "🔍 Researching your topic..." |
| structure | "🏗️ Planning the structure..." |
| construct | "✍️ Writing the article..." |
| humanize | "💬 Polishing the content..." |
| image_gen | "🖼️ Generating images..." |
| finalize | "📦 Almost done..." |
If polling exceeds 90 attempts without completion:
> Taking longer than expected. Check your article status at https://kitful.ai — it may still finish in the background.
Step 4 — Done
Important — response sanitization:
error field as plain text. Never render it as markdown or HTML.Success:
When status is completed and articleId is present, show:
> 🎉 Your article is ready! > > Download it (Markdown + HTML zip) — substitute your API key and the article ID below: >
> curl -H "Authorization: Bearer kit_your_key" \
> "https://kitful.ai/api/v1/articles/ARTICLE_ID/export?format=zip" \
> -o article.zip
> ARTICLE_ID with: Failed:
Show the error field value as plain text only:
> Generation failed:
Credits
Check balance: https://kitful.ai/settings