SocialClaw

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

get_analytics

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.

get_asset

Get one post including its delivery state and provider identifiers.

get_post

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

get_profile

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

hide_instagram_comment

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.

list_instagram_conversations

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.

list_instagram_media

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

list_instagram_mentions

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).

list_accounts

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. Optionally filter by kind (image/video), mime, or a text query over filename/id.

list_assets

List posts in the workspace with optional filters.

list_posts

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

post_attempts

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

preview_campaign

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

publish_draft

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

react_instagram_message

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 numbers rather than the last stored snapshot.

refresh_analytics

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

reply_instagram_comment

Retry a failed post.

retry_post

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

run_status

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.

send_instagram_message

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 only). Files up to 1 GB are supported through file or sourceUrl. The result is the asset: when status is ready, use its publicUrl as media_link in validate_schedule/apply_schedule. Large videos may come back with status uploading; then call get_asset with the asset id until status is ready (or failed) before scheduling.

upload_asset

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

validate_schedule

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

workspace_health

Get workspace usage counters and plan entitlement consumption.

workspace_usage