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.

bash

npm install -g balzac-cli

Get an API key: https://app.hirebalzac.ai/api_keys

Setup#

bash

export BALZAC_API_KEY=bz_your_key_here
# Or: balzac auth login bz_your_key_here

balzac config set workspace <workspace-id>   # set default workspace

Core Workflow#

bash

# 1. Create workspace from a domain
balzac workspaces create --domain https://myblog.com --wait
balzac config set workspace "$(balzac --json workspaces list | jq -r '.workspaces[0].id')"

# 2. Generate suggestions and accept one (5 credits)
balzac suggestions generate                          # costs 1 credit
sleep 30
balzac suggestions list --status proposed
balzac suggestions accept <suggestion-id>            # costs 5 credits

# 3. Or write directly from a topic (5 credits)
balzac write "How to use AI for content marketing" --wait

# 4. Export or publish
balzac articles export <id> --format markdown
balzac articles publish <id> --integration <integration-id>

Commands#

CommandWhat it doesbalzac workspaces list/create/get/deleteManage workspacesbalzac keywords list/create/enable/disableManage SEO keywordsbalzac suggestions list/generate/accept/rejectAI article suggestionsbalzac briefings create --topic "..."Direct write instruction (5 cr)balzac write "topic" [--wait]Shortcut: briefing + optional waitbalzac articles list/get/export/rewrite/publishManage articlesbalzac articles regenerate-picture <id>New cover image (1 cr)balzac competitors list/add/removeTrack competitor domainsbalzac links list/add/removeReference links for articlesbalzac integrations list/create/get/reconnectPublishing integrationsbalzac settings get/updateWorkspace settingsbalzac tones listAvailable tones of voicebalzac config set/get/resetCLI configuration

Credit Costs#

ActionCreditsGenerate 10 suggestions1Write article (accept suggestion or create briefing)5Rewrite article3Regenerate picture1

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.