Agent Setup

Run social operations from AI agents without building an SDK layer.

SoLoSocialStudio commands map directly to your live API and return structured JSON. Plug them into Codex, CI jobs, shell scripts, and custom agent toolchains.

Quick install
npm install -g solosocialstudio

Setup Timeline

Step 1

Install the CLI

Install globally so any shell or agent runtime can access commands.

npm install -g solosocialstudio
Step 2

Create an API key

Generate a scoped key in dashboard settings for external automation.

Open: /dashboard/api-keys
Step 3

Set environment variables

Set credentials once per environment and reuse across jobs.

export SOLO_API_KEY=sss_live_your_key
export SOLO_API_URL=https://your-domain.com
Step 4

Run your first command

Discover integrations, then schedule a post directly from terminal.

solosocialstudio integrations:list
solosocialstudio posts:create \
  -c "Hello from SoLo Agent!" \
  -s "2026-03-01T12:00:00Z" \
  -i "instagram,linkedin"
Agent Workflow Example
# 1) Discover available targets
solosocialstudio integrations:list

# 2) Upload media
solosocialstudio upload:file ./cover.png --content-type image/png

# 3) Create cross-platform scheduled post
solosocialstudio posts:create \
  -c "New article is live. Key takeaways inside." \
  -s "2026-03-01T10:00:00Z" \
  -i "instagram,linkedin,x"
SKILL.md Snippet
name: solosocialstudio
description: SoLo Social Studio automation CLI
allowed-tools: Bash(solosocialstudio:*)

# Required env
# SOLO_API_KEY
# SOLO_API_URL

# Agent discovery workflow
# 1) solosocialstudio integrations:list
# 2) solosocialstudio platforms:list
# 3) solosocialstudio posts:create ...

Command Reference

solosocialstudio integrations:list

List connected publishing targets.

solosocialstudio platforms:list

Show platform capability metadata.

solosocialstudio posts:create

Create scheduled or draft posts.

solosocialstudio posts:list

Read existing scheduled and published posts.

solosocialstudio posts:publish <post_id>

Queue immediate publish for a post.

solosocialstudio schedule:list

Read queue and job status snapshots.

solosocialstudio analytics:get 30d

Fetch analytics summaries and trends.

solosocialstudio upload:file ./asset.png

Upload media and return reusable path/public URL.

solosocialstudio ai:caption --platform LinkedIn

Generate AI copy with optional tone/objective.

solosocialstudio ai:image --provider imagerouter

Generate image assets with Google/OpenAI/OpenRouter/ImageRouter providers.

solosocialstudio ai:video --provider openai --model sora-2

Start/poll Google Veo, OpenAI Sora, Luma, or ImageRouter video generation.

Start automating SoLoSocialStudio from your agent stack.

Install once, add a scoped key, and orchestrate publishing workflows with terminal-first automation.