Blog Publishing

# Blog Publishing

Write and publish blog articles to your connected platform with a single command.

## When to Use
- User wants to write and publish a blog post or article
- User needs to manage draft articles before publishing
- User wants to create thought leadership or SEO-driven content
- User wants to check the status of published articles

## How It Connects
- **Design** → Generate hero images or inline visuals for articles using the design skill.
- **Branding** → Use `--apply-voice` on `clawpow blog articles create` to automatically apply brand voice to title and body. Or manually check voice with `clawpow branding voice get`.
- **SEO** → Track keyword rankings for published content. Use SEO opportunities to inform article topics.
- **Documents** → Draft long-form content in documents before publishing as a blog article.
- **Social Media** → Promote published articles by creating social posts with the article link.
- **Newsletter** → Repurpose article content into newsletter editions for subscribers.

## Quick Start

Check which blog accounts are connected:
```bash
clawpow accounts list --json
```

## Commands

### Create an Article
```bash
clawpow blog articles create --title "Article Title" --body "Markdown content..." --json
```

Options:
- `--title <text>` — Article title (required)
- `--body <text>` — Article body in markdown (required)
- `--slug <text>` — URL slug (auto-generated from title if omitted)
- `--excerpt <text>` — Short excerpt/summary
- `--tags <list>` — Comma-separated tags
- `--meta-title <text>` — SEO title override
- `--meta-description <text>` — SEO meta description
- `--cover-image <assetId>` — Cover image asset ID
- `--apply-voice` — Apply brand voice to title and body before creating
- `--json` — Output as JSON

### List Articles
```bash
clawpow blog articles list --json
clawpow blog articles list --status draft --json
```

Options:
- `--status <status>` — Filter: draft, published, failed
- `--json` — Output as JSON

### Get Article
```bash
clawpow blog articles get <articleId> --json
```

### Update Article (drafts only)
```bash
clawpow blog articles update <articleId> --title "New Title" --json
```

### Delete Article
```bash
clawpow blog articles delete <articleId> --json
```

### Publish Article
```bash
clawpow blog articles publish <articleId> --json
```

**Note:** Publishing requires agent publish to be enabled in dashboard settings. If disabled, save as draft and a human will publish from the web UI.

### List Blog Accounts
```bash
clawpow accounts list --json
```

## Output Format

All commands support `--json` for structured output. Without `--json`, output is human-readable.

## Important Notes

- Articles are written in Markdown. The system converts to HTML at publish time.
- Only one blog platform can be connected at a time. The system publishes to your connected platform automatically.
- Publishing is one-way — edit in your CMS after publishing.
- Images in markdown (`![alt](assetId)`) are automatically resolved to URLs.
- Check `agentPublishEnabled` setting before attempting to publish.