# kuaifa (快发)

> AI Agent 内容分发平台。好内容别留着，快发。
> AI Agent content distribution platform. Great content? Ship it fast.

## What is kuaifa?

kuaifa is an AI Agent-native content distribution platform. Users install Skills (open-source plugins compatible with OpenClaw, Claude Code, Cursor, Gemini CLI, Codex and other agents), and AI Agents handle the full publishing workflow: Markdown writing → beautiful HTML rendering → image upload to CDN → publish to WeChat Official Accounts.

## Core Skills

- `publish` — Publish Markdown articles to WeChat Official Account drafts. Handles image upload, theme rendering, and draft creation in one command.
- `render` — Render Markdown to beautifully styled HTML with themes. Preview in browser before publishing.
- `upload` — Upload local images to cloud CDN (Alibaba Cloud OSS). Solves WeChat's external image link restrictions.
- `config` — Manage local configuration: API key, WeChat appid/appsecret, default theme, default author.

## Install

```bash
# Recommended (works with all AI agents):
npx skills add shirenchuang/kuaifa --skill kuaifa

# Or in Claude Code:
claude plugin add kuaifa

# Or give this URL to your AI agent:
# "Install this skill: https://github.com/shirenchuang/kuaifa/tree/main/skills/kuaifa"
```

## Quick Start

```
# 1. Configure
kuaifa config set api-key YOUR_API_KEY
kuaifa config set appid YOUR_WECHAT_APPID
kuaifa config set appsecret YOUR_WECHAT_APPSECRET

# 2. Publish
kuaifa publish article.md --draft --theme shizhen
```

## API Endpoints

- `POST /api/upload` — Upload images to OSS, returns URL mapping
- `POST /api/publish` — Render + publish to WeChat (supports article and visual types)
- `GET /api/themes` — List available themes

## Themes

- `default` — Clean, minimal (free, open-source)
- `shizhen` — 石臻说AI branded theme with citation cards and recommendation section (premium)
- More themes coming soon. Custom theme development supported.

## Platform Support

Currently supported:
- WeChat Official Accounts (微信公众号) — Full workflow: render, upload, publish

Coming soon (multi-platform distribution):
- 小红书 (Xiaohongshu/RED)
- 知乎 (Zhihu)
- 今日头条 (Toutiao)
- 掘金 (Juejin)
- CSDN
- 视频号 (WeChat Channels)
- 抖音 (Douyin/TikTok CN)
- 简书 (Jianshu)
- X / Twitter
- Medium
- LinkedIn
- And more...

One creation, distribute everywhere.

## Pricing

- CLI tool and default theme: Free & open-source
- Premium themes + cloud rendering + image CDN hosting: Requires API key
- **Currently in beta (内测中)**: Add WeChat to get a free API key and try all features

## Links

- Website: https://www.kuaifa.art
- GitHub: https://github.com/kuaifa
- API Docs: https://www.kuaifa.art/docs/api
- Full documentation for LLMs: https://www.kuaifa.art/llms-full.txt