Introduction

Automate social media posting from the command line with the Sipstory CLI

tip

Create AI-powered UGC videos for your social media with Agent Media — generate engaging video content and schedule it directly with Sipstory. Perfect for OpenClaw 🦞

tip

For your AI agent to work best with Sipstory, load the SKILL md file from github.com/pipdaniels/sipstory-agent.

The Sipstory CLI is a command-line tool for automating social media posting across 28+ platforms. It wraps the Public API so you can schedule posts, manage integrations, and upload media directly from your terminal or shell scripts.

Installation

npm

npm install -g sipstory

pnpm

pnpm install -g sipstory

Verify the installation:

sipstory --help

Setup

API Key

Set your Sipstory API key as an environment variable. You can get your API key from the Sipstory Settings page.

export SIPSTORY_API_KEY=your_api_key_here

info

Add this to your shell profile (~/.bashrc, ~/.zshrc, etc.) so it persists across sessions.

Custom API URL (self-hosted)

If you're running a self-hosted Sipstory instance, point the CLI to your server:

export SIPSTORY_API_URL=https://api.sipstory.tech

Quick Start

# 1. List your connected social media accounts
sipstory integrations:list

# 2. Create a scheduled post
sipstory posts:create \
  -c "Hello from the Sipstory CLI!" \
  -s "2025-01-15T10:00:00Z" \
  -i "your-integration-id"

# 3. List your scheduled posts
sipstory posts:list

Commands Overview

Command	Description
integrations:list	List all connected social media accounts
integrations:settings	Get the settings schema for an integration
integrations:trigger	Trigger a dynamic tool on an integration
posts:create	Create a new post
posts:list	List posts with optional date filtering
posts:delete	Delete a post by ID
analytics:platform	Get analytics for an integration/channel
analytics:post	Get analytics for a specific post
upload	Upload a media file

note

All commands output JSON, making the CLI easy to use in scripts and automation pipelines.