0.1.0 • Published 2d agoCLI

@postaz/cli

Licence

MIT

Version

0.1.0

Deps

Size

31 kB

Vulns

Weekly

Summary Dependency Versions

Postaz CLI

The cheapest way to grow your app on TikTok — from your terminal or an AI agent.

postaz is a thin, JSON-in/JSON-out command-line wrapper over the Postaz public API. It lets you (or an AI agent) schedule and publish TikTok posts, upload media, and generate captions without touching the web app.

Install

npm install -g @postaz/cli
# or
pnpm install -g @postaz/cli

Requires Node.js ≥ 20.

Authenticate

Create an API key in your Postaz workspace settings (API Keys → Create key), then:

postaz auth:login --api-key postaz_sk_xxx
# or
export POSTAZ_API_KEY=postaz_sk_xxx

postaz auth:status

Credentials are stored at ~/.postaz/credentials.json (mode 600). The POSTAZ_API_KEY environment variable takes priority. Point at a self-hosted backend with POSTAZ_API_URL.

Quick start

# Find your TikTok platform id
postaz platforms:list

# Upload media (required before posting — returns a READY object with an id)
MEDIA_ID=$(postaz upload launch.mp4 | jq -r '.id')

# Publish now
postaz posts:create -c "We just shipped 🚀 #buildinpublic" \
  -m "$MEDIA_ID" -i "<platform-id>" --mode now

# Or schedule
postaz posts:create -c "Coming soon" -m "$MEDIA_ID" -i "<platform-id>" \
  -s "2026-07-01T12:00:00Z"

Commands

Command	Description
`auth:login --api-key <key>`	Validate and store an API key
`auth:status`	Check the current key
`auth:logout`	Remove stored credentials
`platforms:list`	List connected accounts and their IDs
`platforms:schema <id>`	Posting limits + settings for a platform
`upload <file>`	Upload an image/video, returns a READY media object
`media:list`	List uploaded media
`media:folders:list` / `media:folders:create <name>`	Manage folders
`posts:create`	Create a post (`-c` content, `-i` platform ids, `-m` media ids, `--mode`, `-s`)
`posts:list`	List posts in a date range
`posts:get <id>`	Fetch one post group
`posts:reschedule <id> -s <iso>`	Change scheduled time
`posts:delete <id>`	Delete a post
`slides:content`	Generate AI captions for a slideshow (uses credits)
`slides:render`	Bake captions onto images (uses credits)

Both posts:create and posts create syntaxes work. Run postaz <command> --help for details.

Use as an AI agent skill

This repo ships a SKILL.md and a .claude-plugin manifest so agents can install and drive the CLI directly. See SKILL.md for the full agent playbook.

License

MIT