io.github.ndesv21/socialclaw

Tools

• account_capabilities

  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.

  shallow
• apply_schedule

  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.

  shallow
• cancel_post

  Cancel a scheduled post before it publishes.

  shallow
• connect_account

  Start connecting a new social account. For OAuth providers this returns an authorizeUrl the user must open in a browser. Telegram requires botToken and chatId; Discord requires webhookUrl.

  shallow
• delete_instagram_comment

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

  shallow
• get_analytics

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

  shallow
• get_instagram_account_insights

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

  shallow
• get_instagram_comments

  Read the comments (and replies) on an Instagram post. Use list_instagram_media first to get a mediaId.

  shallow
• get_instagram_media_insights

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

  shallow
• get_instagram_messages

  Read the messages in an Instagram direct-message conversation.

  shallow
• get_instagram_profile

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

  shallow
• get_post

  Get one post including its delivery state and provider identifiers.

  shallow
• hide_instagram_comment

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

  shallow
• list_accounts

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

  shallow
• list_assets

  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.

  shallow
• list_instagram_conversations

  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.

  shallow
• list_instagram_media

  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.

  shallow
• list_instagram_mentions

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

  shallow
• list_posts

  List posts in the workspace with optional filters.

  shallow
• post_attempts

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

  shallow
• preview_campaign

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

  shallow
• publish_draft

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

  shallow
• react_instagram_message

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

  shallow
• refresh_analytics

  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.

  shallow
• reply_instagram_comment

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

  shallow
• retry_post

  Retry a failed post.

  shallow
• run_status

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

  shallow
• send_instagram_message

  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.

  shallow
• upload_asset

  Upload media (image or video) to SocialClaw hosted storage. Provide either sourceUrl (a public URL the server downloads) or contentBase64. Returns an asset id and a public URL usable as media_link in schedules.

  shallow
• validate_schedule

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

  shallow
• workspace_health

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

  shallow
• workspace_usage

  Get workspace usage counters and plan entitlement consumption.

  shallow

Embed this server’s score

Tool count and median score across every tool in this server’s corpus — honest in a way a single cherry-picked tool’s badge wouldn’t be.

[![Vouch score](https://vouch.tools/api/servers/e4233972-b1e6-46f9-be98-b013c9d921d9/badge.svg)](https://vouch.tools/servers/e4233972-b1e6-46f9-be98-b013c9d921d9)