@broadr/cli

Schedule social media posts from the terminal.

Installation

npm install -g @broadr/cli

Quick Start

# Authenticate
broadr login

# List connected channels
broadr channels

# Create a draft post
broadr post "Hello world!" -c x,linkedin --draft

# Schedule a post
broadr schedule "My scheduled post" -c mastodon --time "tomorrow 9am"

# Publish immediately
broadr post "Publishing now!" -c x

Commands

Authentication

# Login with API key (interactive)
broadr login

# Login with API key (non-interactive)
broadr login --key sk_live_xxxxx

# Logout
broadr logout

Channels

# List all connected channels
broadr channels

# JSON output
broadr channels --json

Posts

# Create a draft
broadr post "My draft" -c x --draft

# Publish immediately
broadr post "Publishing now" -c linkedin

# Schedule for specific time
broadr schedule "Future post" -c x --time "tomorrow 2pm"
broadr schedule "Future post" -c x --time "2024-02-15T14:30:00Z"

# Use next available slot
broadr schedule "Future post" -c mastodon --next-slot

# Attach media
broadr post "With image" -c x -m media_id_123

# List posts
broadr posts
broadr posts --status draft
broadr posts --status scheduled

# Cancel/delete a post
broadr cancel <post_id>

Media

# Upload local file
broadr upload ./image.png

# Upload from URL
broadr upload https://example.com/image.jpg

Scheduling

# Get next available slot for a channel
broadr slot -c x
broadr slot -c linkedin

Options

All commands support:

• --json - Output as JSON for scripting
• -h, --help - Show command help

Channel Names

You can use platform names or IDs:

• x or twitter
• linkedin or li
• facebook or fb
• instagram or ig
• mastodon or mast
• pinterest or pin
• youtube or yt
• tiktok

Configuration

Config is stored at ~/.config/broadr/config.json (or ~/.broadr/config.json depending on OS).

API Key

Get your API key from https://broadr.app/settings/developer