Balzac

AI content platform CLI — create workspaces, manage SEO keywords, generate article suggestions, write articles, and publish to WordPress, Webflow, Wix, GoHig...

Security Scan

The skill's requirements and instructions are consistent with a CLI for the Balzac content platform — it asks for the Balzac CLI binary and an API key and its SKILL.md only instructs use of that CLI.

Purpose & Capability

Name/description, required binary ('balzac'), and required env var (BALZAC_API_KEY) align with a CLI that talks to the Balzac service and publishes content. The supported integrations (WordPress, Webflow, etc.) are consistent with the skill's stated purpose.

Instruction Scope

SKILL.md limits actions to installing/using the balzac CLI and using BALZAC_API_KEY; commands shown call the CLI and pipe JSON to jq. There are no instructions to read unrelated system files or export unrelated credentials. Publishing/integration steps will contact external services, which is expected for this tool.

Install Mechanism

There is no registry-level install spec, but SKILL.md recommends installing the official-looking npm package (npm install -g balzac-cli). Installing an npm CLI is a reasonable install method for this purpose; users should still verify the npm package and publisher before global install.

Credentials

Only one env var (BALZAC_API_KEY) is required and is directly related to the service. The skill does not request unrelated credentials or system config paths.

Persistence & Privilege

always:false (no forced presence). The skill is user-invocable and allows normal autonomous invocation, which is the platform default and appropriate here.

Scan Findings in Context

[NO_SCAN_FINDINGS] expected: The package is instruction-only and contained no code files for the regex scanner to analyze; the lack of findings is expected in this context.

Assessment

This skill appears coherent for controlling the Balzac CLI. Before installing: 1) Verify the npm package 'balzac-cli' and its publisher on npm (review downloads, repository link, and recent releases) before running a global install. 2) Only supply a BALZAC_API_KEY you trust; review Balzac's privacy/terms because article content and site data will be sent to their service. 3) Integrations (WordPress/Webflow/Wix/etc.) will require additional credentials or tokens stored by the CLI—provide those only to trusted services and consider using least-privilege accounts. 4) If you allow autonomous agent invocation, remember the agent could run balzac CLI commands using the provided API key; keep keys scoped and rotate/revoke if needed. 5) Note the registry metadata omission of a formal install spec is minor but you may want to inspect the upstream project and homepage (https://developer.hirebalzac.ai) before proceeding.

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.

npm install -g balzac-cli

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

Setup

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

# 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

Command	What it does
balzac workspaces list/create/get/delete	Manage workspaces
balzac keywords list/create/enable/disable	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.