Socialclaw

List connected social accounts in the SocialClaw workspace. Optionally filter by provider (x, facebook, instagram_business, instagram, threads, linkedin, linkedin_page, pinterest, tiktok, telegram, discord, youtube, reddit, wordpress).

Get publish capabilities and provider rules for connected accounts: what media is allowed, text limits, and whether publishing is currently possible. Pass accountId for one account, or provider to filter, or neither for all.

Start connecting one of the user's own social accounts to their SocialClaw workspace. For most providers this returns an authorizeUrl; give it to the user so they sign in with the provider themselves (SocialClaw never sees their password). Telegram and Discord have no sign-in...

Add an image or video to the user's SocialClaw media library so it can be attached to a post. Pass exactly one of: file (a file the user attached in this chat), sourceUrl (a direct public http(s) link to the image or video file, not a web page), or contentBase64 (small files o...

Get one media asset from the user's SocialClaw library by id, including its status (uploading, ready, or failed), import progress, and publicUrl. Use it after upload_asset returns status uploading, until the asset is ready.

Validate a schedule document against provider rules, media limits, account state, and publish times WITHOUT creating any posts. Always run this before apply_schedule.

Preview how a campaign schedule document expands into concrete posts and steps without creating anything.

Create a publishing run from a schedule document. Posts are scheduled or published through connected accounts. Send an idempotencyKey so retries do not create duplicate runs.

Publish a previously created draft run, optionally at a given ISO-8601 start time.

List posts in the workspace with optional filters.

List media (images/videos) the user has uploaded to their SocialClaw library, newest first. Each asset includes a publicUrl usable directly as media_link in validate_schedule/apply_schedule. Use this to find a previously uploaded file (e.g. from the dashboard) to post. Optiona...

Get one post including its delivery state and provider identifiers.

List publish attempts for a post, including provider errors. Use this to debug failed posts.

Retry a failed post.

Cancel a scheduled post before it publishes.

Get the status summary of a publishing run and its posts.

Get analytics snapshots for a post, an account, or a run. scope must be post, account, or run; id is the matching identifier.

Fetch fresh analytics for a published post from the provider and store a new snapshot, then return it. Supported providers: Instagram, TikTok, YouTube, Reddit, X, Pinterest, Snapchat (others return an unsupported snapshot). Call this before get_analytics when you need current...

List an Instagram account's recent posts (caption, permalink, timestamp, comment count) so you can find one to read or moderate comments on. account is the connected-account id or handle.

Read the comments and replies people left on one of the user's own Instagram posts, so the user can review and answer them. Use list_instagram_media first to get a mediaId.

Reply to an Instagram comment on the user's media.

Hide or unhide an Instagram comment on the user's media. Set hidden=false to unhide.

Permanently delete an Instagram comment on the user's media. Prefer hide_instagram_comment when unsure.

Get analytics for one Instagram post (reach, likes, comments, saved, shares, views). Use list_instagram_media for the mediaId.

Get an Instagram account's profile stats: followers, follows, media count, bio.

Get an Instagram account's insight trend (a daily time series, e.g. reach) over the last N days.

React to a received Instagram direct message (e.g. love).

List recent @mentions of the workspace's Instagram accounts (captured from Instagram mention webhooks).

List the Instagram direct-message conversations for an account, most recent first. Each conversation includes `counterpart` (the other person's {id, username}) — use its id as the recipientId when replying; `participants` also lists the account itself.

Read the messages in an Instagram direct-message conversation.

Send an Instagram direct message — a text reply, or an image/video attachment via attachment_url. Only allowed within 24 hours of the recipient's last message unless a message tag (e.g. HUMAN_AGENT) is supplied.

Get workspace usage counters and plan entitlement consumption.

No parameters. Call it with no arguments.

Get workspace health, including connection state across providers. Pass provider to check one provider's connections.

Identify the connected SocialClaw workspace: its stable id, name, and plan. Use it to confirm which workspace you are acting on.

No parameters. Call it with no arguments.