Balzac CLI
AI-powered SEO content platform. Authenticate, create a workspace from any domain, and Balzac analyzes your site, generates keyword-driven article suggestions, writes SEO-optimized articles, and publishes them.
CODEBLOCK0
Get an API key: https://app.hirebalzac.ai/api_keys
Setup
CODEBLOCK1
Core Workflow
CODEBLOCK2
Commands
| Command | What it does |
|---|
| INLINECODE0 | Manage workspaces |
| INLINECODE1 |
Manage SEO keywords |
|
balzac suggestions list/generate/accept/reject | AI article suggestions |
|
balzac briefings create --topic "..." | Direct write instruction (5 cr) |
|
balzac write "topic" [--wait] | Shortcut: briefing + optional wait |
|
balzac articles list/get/export/rewrite/publish | Manage articles |
|
balzac articles regenerate-picture <id> | New cover image (1 cr) |
|
balzac competitors list/add/remove | Track competitor domains |
|
balzac links list/add/remove | Reference links for articles |
|
balzac integrations list/create/get/reconnect | Publishing integrations |
|
balzac settings get/update | Workspace settings |
|
balzac tones list | Available tones of voice |
|
balzac config set/get/reset | CLI configuration |
Credit Costs
| Action | Credits |
|---|
| Generate 10 suggestions | 1 |
| Write article (accept suggestion or create briefing) |
5 |
| Rewrite article | 3 |
| Regenerate picture | 1 |
Key Notes
- - Use
--json flag for scriptable JSON output; pipe to jq. - Use
-w <id> or balzac config set workspace <id> for workspace-scoped commands. - Article writing is async — use
write --wait or poll articles get <id>. - Workspace creation is async — use
--wait flag. - Supported integrations: WordPress, Webflow, Wix, GoHighLevel, Webhook.
- Run
balzac <command> --help for full option details.
Balzac CLI
AI驱动的SEO内容平台。进行身份验证后，从任意域名创建工作区，Balzac会分析您的网站，生成关键词驱动的文章建议，撰写SEO优化的文章，并将其发布。
bash
npm install -g balzac-cli
获取API密钥：https://app.hirebalzac.ai/api_keys
设置
bash
export BALZACAPIKEY=bzyourkey_here
或者：balzac auth login bzyourkey_here
balzac config set workspace # 设置默认工作区
核心工作流程
bash
1. 从域名创建工作区
balzac workspaces create --domain https://myblog.com --wait
balzac config set workspace $(balzac --json workspaces list | jq -r .workspaces[0].id)
2. 生成建议并接受一条（5积分）
balzac suggestions generate # 消耗1积分
sleep 30
balzac suggestions list --status proposed
balzac suggestions accept
# 消耗5积分
3. 或直接从主题撰写（5积分）
balzac write 如何将AI用于内容营销 --wait
4. 导出或发布
balzac articles export --format markdown
balzac articles publish --integration
命令
| 命令 | 功能说明 |
|---|
| balzac workspaces list/create/get/delete | 管理工作区 |
| balzac keywords list/create/enable/disable |
管理SEO关键词 |
| balzac suggestions list/generate/accept/reject | AI文章建议 |
| balzac briefings create --topic ... | 直接撰写指令（5积分） |
| balzac write 主题 [--wait] | 快捷方式：简报+可选等待 |
| balzac articles list/get/export/rewrite/publish | 管理文章 |
| balzac articles regenerate-picture | 新封面图片（1积分） |
| balzac competitors list/add/remove | 跟踪竞争对手域名 |
| balzac links list/add/remove | 文章参考链接 |
| balzac integrations list/create/get/reconnect | 发布集成 |
| balzac settings get/update | 工作区设置 |
| balzac tones list | 可用的语气风格 |
| balzac config set/get/reset | CLI配置 |
积分消耗
| 操作 | 积分 |
|---|
| 生成10条建议 | 1 |
| 撰写文章（接受建议或创建简报） |
5 |
| 重写文章 | 3 |
| 重新生成图片 | 1 |
关键说明
- - 使用 --json 标志获取可脚本化的JSON输出；通过管道传递给 jq。
- 使用 -w 或 balzac config set workspace 进行工作区范围的命令操作。
- 文章撰写是异步的——使用 write --wait 或轮询 articles get 。
- 工作区创建是异步的——使用 --wait 标志。
- 支持的集成：WordPress、Webflow、Wix、GoHighLevel、Webhook。
- 运行 balzac --help 查看完整选项详情。
