Use the CLI and HTTP API as one hosted publishing surface for developer workflows.
SocialClaw fits developer tools that want a clean CLI, a hosted API, workspace API keys, provider-aware validation, and inspectable runs, posts, analytics, jobs, and health.
Why this workflow fits SocialClaw
One workspace, one connection hub, and one publishing layer.
How the workflow runs
Connect accounts, upload media, validate posts, then publish.
Install the CLI or use raw HTTP
Developer tools can use the socialclaw CLI for short commands or call the hosted API directly with the same workspace key.
Authenticate with the workspace key
Log into the CLI with the workspace API key, or pass the key in the Authorization header for hosted HTTP requests.
Inspect connected accounts before generating payloads
Read capabilities, settings, and account actions before the tool emits a provider-specific schedule.
Upload media when the provider expects public URLs
Use SocialClaw-hosted media URLs instead of temporary third-party links so the workflow keeps a stable delivery handoff.
Validate or preview the payload
Validation and campaign preview should happen before apply, especially when the route includes media rules or provider-specific settings.
Inspect results and recover cleanly
Use post attempts, run inspection, analytics, jobs, and health to drive debugging and recovery flows after publish.
CLI and HTTP examples
Example commands and requests for this setup.
npm install -g socialclaw
socialclaw login --api-key <workspace-key>
socialclaw accounts capabilities --account-id <account-id> --json
socialclaw campaigns preview -f schedule.json --json
socialclaw apply -f schedule.json --idempotency-key dev_tool_1 --json
socialclaw workspace health --json
curl -sS \
-H "Authorization: Bearer $SC_API_KEY" \
"https://getsocialclaw.com/v1/accounts"
curl -sS \
-X POST \
-H "Authorization: Bearer $SC_API_KEY" \
-H "Content-Type: application/json" \
-d @schedule.json \
"https://getsocialclaw.com/v1/campaigns/preview"
curl -sS \
-X POST \
-H "Authorization: Bearer $SC_API_KEY" \
-H "Content-Type: application/json" \
-d @schedule.json \
"https://getsocialclaw.com/v1/posts/apply"
curl -sS \
-H "Authorization: Bearer $SC_API_KEY" \
"https://getsocialclaw.com/v1/analytics/runs/<run-id>"
Relevant provider coverage
Integrations that usually fit this setup best.
Use SocialClaw to connect YouTube channels, upload video assets natively, validate settings, and inspect publish runs from the same workspace used by the dashboard, API, CLI, and agents.
Open integrationSocialClaw keeps WordPress site connection, remote media upload, publish settings, validation, and post inspection in one hosted workspace shared by the dashboard, API, CLI, and agent workflows.
Open integrationUse SocialClaw to keep LinkedIn profile connection, native media upload, schedule validation, and post inspection in one workspace shared by the dashboard, API, CLI, and agent workflows.
Open integrationUse SocialClaw to connect X once, then validate, schedule, publish, and inspect text posts, media posts, and reply-based campaign steps from the same hosted workspace.
Open integrationRelated workflows
More routes that fit the same setup.
Operator notes and limits
A few practical limits to keep in mind.
- The CLI is a client for the hosted SocialClaw service, not a standalone scheduler.
- Provider-native analytics coverage is still partial, so analytics snapshots and unsupported states must be handled explicitly.
- Provider-specific media and interaction limits still apply to every route.
Frequently asked questions
Does the CLI replace the SocialClaw backend?
No. The CLI is a shorter client for the hosted service. It does not replace the backend or remove the need for a workspace API key.
How should a developer workflow inspect failures?
Use posts get, posts attempts, runs inspect, jobs list, and workspace or connection health to inspect the canonical lifecycle record and next action.
Can developer tools use only HTTP instead of the CLI?
Yes. The hosted HTTP API exposes the same core operations for account connection, media upload, validation, apply, and inspection.
Create the workspace, connect accounts once, and keep validation plus delivery state inside the same hosted product.